diff --git a/CLAUDE.md b/CLAUDE.md
index 7983e61..8190e2e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,12 +2,18 @@
> [根目录](../CLAUDE.md) > **skills-v2**
-**Last Updated**: 2026-01-08 (v1.7.0)
+**Last Updated**: 2026-01-08 (v1.7.1)
---
## 变更记录 (Changelog)
+### 2026-01-08 (v1.7.1)
+- 🐛 **修复 Windows 兼容性问题**:修改所有命令模板中的后台进程调用语法
+- 📝 **语法改进**:使用 Claude Code 的 `run_in_background: true` 参数替代 shell 的 `&` 符号
+- ✅ **跨平台支持**:修复 Windows Git Bash 的 heredoc + 后台进程语法错误
+- 📋 **涉及文件**:workflow.md, analyze.md, debug.md, optimize.md, review.md, test.md
+
### 2026-01-08 (v1.7.0)
- 🎯 **大幅简化安装流程**:只需配置 MCP(可选),无需选择语言/模型/命令
- 🔧 **固定模型路由**:Gemini (前端) + Codex (后端),不再支持自定义
diff --git a/package.json b/package.json
index 7f63aec..c80300a 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "ccg-workflow",
- "version": "1.7.0",
+ "version": "1.7.1",
"description": "Claude-Codex-Gemini 多模型协作系统 - 智能路由多模型开发工作流",
"type": "module",
"packageManager": "pnpm@10.17.1",
diff --git a/templates/commands/analyze.md b/templates/commands/analyze.md
index 78e86c5..6dacc06 100644
--- a/templates/commands/analyze.md
+++ b/templates/commands/analyze.md
@@ -55,26 +55,42 @@ EOF
**并行调用两个模型**:
**执行步骤**:
-1. 在**同一个 Bash 调用**中启动两个后台进程(不加 wait,立即返回):
-```bash
-codeagent-wrapper --backend codex - $PWD <<'EOF' &
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
+
+**Codex 分析进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
ROLE_FILE: ~/.claude/.ccg/prompts/codex/analyzer.md
分析需求: $ARGUMENTS
Context: <阶段1检索到的上下文>
OUTPUT: 技术可行性、架构影响、性能考量
-EOF
+EOF_CODEX",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Codex 技术分析"
+})
+```
-codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+**Gemini 分析进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
ROLE_FILE: ~/.claude/.ccg/prompts/gemini/analyzer.md
分析需求: $ARGUMENTS
Context: <阶段1检索到的上下文>
OUTPUT: UI/UX 影响、用户体验、视觉设计考量
-EOF
+EOF_GEMINI",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Gemini UI 分析"
+})
```
+
2. 使用 `TaskOutput` 监控并获取 2 个模型的分析结果。
**⚠️ 强制规则:必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段,禁止跳过或提前继续!**
@@ -129,6 +145,6 @@ EOF
## 关键规则
1. **仅分析不修改** – 本命令不执行任何代码变更
-2. **使用后台进程 `&` + `TaskOutput` 获取结果**
+2. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
3. **必须等待所有模型返回完整结果后才能进入下一阶段**,禁止跳过或提前继续
4. **信任规则** – 后端以 Codex 为准,前端以 Gemini 为准
diff --git a/templates/commands/debug.md b/templates/commands/debug.md
index d46c723..8160a2c 100644
--- a/templates/commands/debug.md
+++ b/templates/commands/debug.md
@@ -56,10 +56,12 @@ EOF
**并行调用 Codex + Gemini**:
**执行步骤**:
-1. 在**同一个 Bash 调用**中启动两个后台进程(不加 wait,立即返回):
-```bash
-# Codex 后端诊断
-~/.claude/bin/codeagent-wrapper --backend codex - "$PWD" <<'EOF' &
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
+
+**Codex 诊断进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
角色:后端调试专家
问题:$ARGUMENTS
@@ -68,10 +70,17 @@ EOF
1. 分析逻辑错误、数据流、异常处理
2. 检查 API、数据库、服务间通信
3. 输出诊断假设(按可能性排序)
-EOF
+EOF_CODEX",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Codex 后端诊断"
+})
+```
-# Gemini 前端诊断
-~/.claude/bin/codeagent-wrapper --backend gemini - "$PWD" <<'EOF' &
+**Gemini 诊断进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
角色:前端调试专家
问题:$ARGUMENTS
@@ -80,8 +89,13 @@ EOF
1. 分析 UI 渲染、状态管理、事件绑定
2. 检查组件生命周期、样式冲突
3. 输出诊断假设(按可能性排序)
-EOF
+EOF_GEMINI",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Gemini 前端诊断"
+})
```
+
2. 使用 `TaskOutput` 监控并获取 2 个模型的诊断结果。
**⚠️ 强制规则:必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段,禁止跳过或提前继续!**
@@ -131,7 +145,7 @@ EOF
## 关键规则
1. **heredoc 语法** – 外部模型调用必须使用 heredoc
-2. **使用后台进程 `&` + `TaskOutput` 获取结果**
+2. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
3. **必须等待所有模型返回完整结果后才能进入下一阶段**,禁止跳过或提前继续
4. **用户确认** – 修复前必须获得确认
5. **信任规则** – 后端问题以 Codex 为准,前端问题以 Gemini 为准
diff --git a/templates/commands/optimize.md b/templates/commands/optimize.md
index 2becb28..2f14adb 100644
--- a/templates/commands/optimize.md
+++ b/templates/commands/optimize.md
@@ -60,10 +60,12 @@ EOF
**并行调用两个模型**:
**执行步骤**:
-1. 在**同一个 Bash 调用**中启动两个后台进程(不加 wait,立即返回):
-```bash
-# Codex:后端性能分析
-~/.claude/bin/codeagent-wrapper --backend codex - $PWD <<'EOF' &
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
+
+**Codex 性能分析进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
[角色] 你是后端性能优化专家
[任务] 分析以下代码的后端性能问题:
@@ -73,10 +75,17 @@ $ARGUMENTS
1. 性能瓶颈列表(按严重程度排序)
2. 每个问题的优化方案(含代码 Diff)
3. 预期收益评估
-EOF
+EOF_CODEX",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Codex 后端性能分析"
+})
+```
-# Gemini:前端性能分析
-~/.claude/bin/codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+**Gemini 性能分析进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
[角色] 你是前端性能优化专家
[任务] 分析以下代码的前端性能问题:
@@ -86,8 +95,13 @@ $ARGUMENTS
1. Core Web Vitals 问题列表
2. 每个问题的优化方案(含代码 Diff)
3. 预期收益评估
-EOF
+EOF_GEMINI",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Gemini 前端性能分析"
+})
```
+
2. 使用 `TaskOutput` 监控并获取 2 个模型的分析结果。
**⚠️ 强制规则:必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段,禁止跳过或提前继续!**
@@ -138,4 +152,5 @@ EOF
2. **性价比优先** – 高影响 + 低难度优先
3. **不破坏功能** – 优化不能引入 bug
4. **信任规则** – 后端以 Codex 为准,前端以 Gemini 为准
-5. **必须等待所有模型返回** – 禁止提前进入下一步
+5. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
+6. **必须等待所有模型返回** – 禁止提前进入下一步
diff --git a/templates/commands/review.md b/templates/commands/review.md
index d23f17c..c153e03 100644
--- a/templates/commands/review.md
+++ b/templates/commands/review.md
@@ -52,10 +52,12 @@ git status --short
**并行调用两个模型**:
**执行步骤**:
-1. 在**同一个 Bash 调用**中启动两个后台进程(不加 wait,立即返回):
-```bash
-# Codex 后端审查
-~/.claude/bin/codeagent-wrapper --backend codex - "$PWD" <<'EOF' &
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
+
+**Codex 审查进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
[角色] 后端代码审查专家
[任务] 审查以下代码变更
@@ -70,10 +72,17 @@ git status --short
## 输出格式
按 Critical/Major/Minor/Suggestion 分类列出问题
-EOF
+EOF_CODEX",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Codex 后端代码审查"
+})
+```
-# Gemini 前端审查
-~/.claude/bin/codeagent-wrapper --backend gemini - "$PWD" <<'EOF' &
+**Gemini 审查进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
[角色] 前端代码审查专家
[任务] 审查以下代码变更
@@ -88,8 +97,13 @@ EOF
## 输出格式
按 Critical/Major/Minor/Suggestion 分类列出问题
-EOF
+EOF_GEMINI",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Gemini 前端代码审查"
+})
```
+
2. 使用 `TaskOutput` 监控并获取 2 个模型的审查结果。
**⚠️ 强制规则:必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段,禁止跳过或提前继续!**
@@ -131,4 +145,5 @@ EOF
1. **无参数 = 审查 git diff** – 自动获取当前变更
2. **heredoc 语法** – 必须使用 `<<'EOF'` 传递多行任务
3. **双模型交叉验证** – 后端问题以 Codex 为准,前端问题以 Gemini 为准
-4. **必须等待所有模型返回** – 禁止提前进入下一步
+4. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
+5. **必须等待所有模型返回** – 禁止提前进入下一步
diff --git a/templates/commands/test.md b/templates/commands/test.md
index 9d68fcc..261d07c 100644
--- a/templates/commands/test.md
+++ b/templates/commands/test.md
@@ -63,10 +63,12 @@ EOF
**全栈代码并行调用**:
**执行步骤**:
-1. 在**同一个 Bash 调用**中启动两个后台进程(不加 wait,立即返回):
-```bash
-# Codex 后端测试调用
-~/.claude/bin/codeagent-wrapper --backend codex - $PWD <<'EOF' &
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
+
+**Codex 测试生成进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
你是后端测试专家,角色提示词见 ~/.claude/.ccg/prompts/codex/tester.md
任务:为以下代码生成单元测试
@@ -76,10 +78,17 @@ EOF
1. 使用项目现有测试框架
2. 覆盖正常路径、边界条件、异常处理
3. 输出完整测试代码
-EOF
+EOF_CODEX",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Codex 后端测试生成"
+})
+```
-# Gemini 前端测试调用
-~/.claude/bin/codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+**Gemini 测试生成进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
你是前端测试专家,角色提示词见 ~/.claude/.ccg/prompts/gemini/tester.md
任务:为以下组件生成测试
@@ -89,8 +98,13 @@ EOF
1. 使用项目现有测试框架
2. 测试渲染、交互、状态变化
3. 输出完整测试代码
-EOF
+EOF_GEMINI",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Gemini 前端测试生成"
+})
```
+
2. 使用 `TaskOutput` 监控并获取 2 个模型的测试代码。
**⚠️ 强制规则:必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段,禁止跳过或提前继续!**
@@ -145,4 +159,5 @@ EOF
1. **测试行为,不测试实现** – 关注输入输出
2. **智能路由** – 后端测试用 Codex,前端测试用 Gemini
3. **复用现有模式** – 遵循项目已有的测试风格
-4. **必须等待所有模型返回** – 禁止提前进入下一步
+4. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
+5. **必须等待所有模型返回** – 禁止提前进入下一步
diff --git a/templates/commands/workflow.md b/templates/commands/workflow.md
index 2678230..88606ce 100644
--- a/templates/commands/workflow.md
+++ b/templates/commands/workflow.md
@@ -66,26 +66,42 @@ description: '多模型协作开发工作流(研究→构思→计划→执行
2. **Gemini 分析**:`~/.claude/.ccg/prompts/gemini/analyzer.md`
**执行步骤**:
-1. 在**同一个 Bash 调用**中启动两个后台进程(不加 wait,立即返回):
-```bash
-codeagent-wrapper --backend codex - $PWD <<'EOF' &
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
+
+**Codex 分析进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
ROLE_FILE: ~/.claude/.ccg/prompts/codex/analyzer.md
分析需求: <任务描述>
Context: <项目上下文>
OUTPUT: 技术可行性、推荐方案、风险点
-EOF
+EOF_CODEX",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Codex 技术分析"
+})
+```
-codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+**Gemini 分析进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
ROLE_FILE: ~/.claude/.ccg/prompts/gemini/analyzer.md
分析需求: <任务描述>
Context: <项目上下文>
OUTPUT: UI可行性、推荐方案、用户体验
-EOF
+EOF_GEMINI",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Gemini UI 分析"
+})
```
+
2. 使用 `TaskOutput` 监控并获取 2 个后台进程的输出结果
**⚠️ 强制规则:必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段,禁止跳过或提前继续!**
@@ -98,30 +114,45 @@ EOF
`[模式:计划]` - 多模型协作规划:
-**并行调用 Codex 和 Gemini 进行架构规划**(使用后台进程 `&`):
+**并行调用 Codex 和 Gemini 进行架构规划**:
1. **Codex 规划**:`~/.claude/.ccg/prompts/codex/architect.md`
2. **Gemini 规划**:`~/.claude/.ccg/prompts/gemini/architect.md`
-调用示例:
-```bash
-codeagent-wrapper --backend codex - $PWD <<'EOF' &
+调用示例(使用 `run_in_background: true`):
+
+**Codex 规划进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
ROLE_FILE: ~/.claude/.ccg/prompts/codex/architect.md
规划需求: <任务描述>
Context: <项目上下文>
OUTPUT: 后端架构规划
-EOF
+EOF_CODEX",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Codex 后端架构规划"
+})
+```
-codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+**Gemini 规划进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
ROLE_FILE: ~/.claude/.ccg/prompts/gemini/architect.md
规划需求: <任务描述>
Context: <项目上下文>
OUTPUT: 前端架构规划
-EOF
+EOF_GEMINI",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Gemini 前端架构规划"
+})
```
使用 `TaskOutput` 获取 2 个模型的规划结果。
@@ -146,30 +177,45 @@ EOF
`[模式:优化]` - 多模型并行审查:
-**并行调用 Codex 和 Gemini 进行代码审查**(使用后台进程 `&`):
+**并行调用 Codex 和 Gemini 进行代码审查**:
1. **Codex 审查**:`~/.claude/.ccg/prompts/codex/reviewer.md`
2. **Gemini 审查**:`~/.claude/.ccg/prompts/gemini/reviewer.md`
-调用示例:
-```bash
-codeagent-wrapper --backend codex - $PWD <<'EOF' &
+调用示例(使用 `run_in_background: true`):
+
+**Codex 审查进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
ROLE_FILE: ~/.claude/.ccg/prompts/codex/reviewer.md
审查代码: <实施的代码变更>
关注点: 安全性、性能、错误处理
OUTPUT: 审查意见
-EOF
+EOF_CODEX",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Codex 代码审查"
+})
+```
-codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+**Gemini 审查进程**:
+```
+Bash({
+ command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
ROLE_FILE: ~/.claude/.ccg/prompts/gemini/reviewer.md
审查代码: <实施的代码变更>
关注点: 可访问性、设计一致性、用户体验
OUTPUT: 审查意见
-EOF
+EOF_GEMINI",
+ run_in_background: true,
+ timeout: 600000,
+ description: "Gemini 代码审查"
+})
```
使用 `TaskOutput` 获取 2 个模型的审查结果。
@@ -192,7 +238,7 @@ EOF
## 关键规则
1. 阶段顺序不可跳过(除非用户明确指令)
-2. **多模型调用必须使用后台进程 `&` + `TaskOutput` 获取结果**
+2. **多模型调用必须使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
3. **必须等待所有模型返回完整结果后才能进入下一阶段**,禁止跳过或提前继续
4. 外部模型对文件系统**零写入权限**,所有修改由 Claude 执行
5. 评分 <7 分或用户未批准时**强制停止**