ccgx-workflow 2.1.2 → 2.3.0

package/templates/commands/team.md

@@ -70,8 +70,8 @@ TaskUpdate({ taskId: "1", owner: "architect" })
 | 📜 Dev × N | Agent Teams teammates | `Agent(team_name=T, name="dev-1")` | Sonnet | 并行编码，文件隔离 |
 | 🧪 QA | Agent Teams teammate | `Agent(team_name=T, name="qa")` | Sonnet | 写测试、跑测试、lint、typecheck |
 | 🔬 Reviewer | Agent Teams teammate | `Agent(team_name=T, name="reviewer")` | Sonnet | 综合审查，分级判决 |
-| 🔥 {{BACKEND_PRIMARY}} | 外部模型（非 teammate） | Bash + codeagent-wrapper | {{BACKEND_PRIMARY}} | 后端分析/审查（Phase 2, 6） |
-| 🔮 {{FRONTEND_PRIMARY}} | 外部模型（非 teammate） | Bash + codeagent-wrapper | {{FRONTEND_PRIMARY}} | 前端分析/审查（Phase 2, 6） |
+| 🔥 {{BACKEND_PRIMARY}} | 外部模型（非 teammate） | 默认 `Agent(codex:codex-rescue)` / BC fallback Bash codeagent-wrapper | {{BACKEND_PRIMARY}} | 后端分析/审查（Phase 2, 6） |
+| 🔮 {{FRONTEND_PRIMARY}} | 外部模型（非 teammate） | 默认 `Agent(gemini:gemini-rescue)` / BC fallback Bash codeagent-wrapper | {{FRONTEND_PRIMARY}} | 前端分析/审查（Phase 2, 6） |
 
 **8 阶段流水线**
 
@@ -156,29 +156,127 @@ Phase 8: INTEGRATION   → Lead 全量验证 + 报告 + 清理
 1. **Team 已在 Phase 0 创建**，直接使用已有的 team_name。
 
 2. **{{BACKEND_PRIMARY}} + {{FRONTEND_PRIMARY}} 并行分析（PARALLEL）**
-   - **CRITICAL**: 必须在一条消息中同时发起两个 Bash 调用，`run_in_background: true`。
 
-   **FIRST Bash call ({{BACKEND_PRIMARY}})**:
+   **调用通道路由（CCG codeagent 退役，v2.2.0+）**
+
+   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 plugin spawn：
+
+   1. **优先 plugin spawn**（默认）：装了 `codex@openai-codex` + gemini plugin → 用 `Agent(subagent_type="codex:codex-rescue")` + `Agent(subagent_type="gemini:gemini-rescue")` 并行，主线接 ≤200 token 摘要。
+   2. **降级 codeagent-wrapper**（BC fallback）：plugin 未装 → fallback Bash 调用，行为与 plugin 路径等价。
+
+   **判定**：preflight `Bash` 跑 `ls ~/.claude/plugins/` 看有无 `codex@*` / `gemini@*` 子目录。
+
+   - **CRITICAL**: 必须在一条消息中同时发起两个并行调用。
+
+   **⚠ 预备动作（spawn 前必须执行）**：`codex:codex-rescue` / `gemini:gemini-rescue` 是 thin forwarder，不会主动 Read 路径文件。主线必须在 spawn 前先 Read 两个角色提示词文件，把**内容**直接拼入下方 Agent prompt 的 `<role>` 块。
+
+   - backend role: `Read("~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/architect.md")` → `${backendRole}`
+   - frontend role: `Read("~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/architect.md")` → `${frontendRole}`
+
+   **通道 A — plugin spawn（默认）**：
+
+   **FIRST Agent call ({{BACKEND_PRIMARY}})**:
+   ```
+   Agent({
+     subagent_type: "codex:codex-rescue",
+     description: "team Phase 2: 后端架构分析",
+     prompt: `<role>
+${backendRole}
+</role>
+
+<workdir>{{WORKDIR}}</workdir>
+
+<task>
+PRD：<PRD 内容>
+
+请分析后端架构：
+- 模块边界、API 设计、数据模型
+- 依赖关系、关键算法选择
+- 实施风险与建议
+</task>
+
+<grounding_rules>
+- 引用 file:line 标注现有代码模式
+- 区分「现有模式已支持」vs「需要新建」
+- 不要捏造未观察到的依赖
+</grounding_rules>
+
+<structured_output_contract>
+Return JSON ONLY:
+{
+  "module_boundaries": [{"name": "...", "responsibility": "...", "files_involved": []}],
+  "api_design": [{"endpoint": "...", "verb": "...", "purpose": "..."}],
+  "data_model": [{"entity": "...", "fields": [], "relations": []}],
+  "dependencies": [{"from": "...", "to": "...", "reason": "..."}],
+  "implementation_risks": [{"risk": "...", "mitigation": "..."}]
+}
+Return ≤200 token structured summary.
+</structured_output_contract>`
+   })
+   ```
+
+   **SECOND Agent call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
+   ```
+   Agent({
+     subagent_type: "gemini:gemini-rescue",
+     description: "team Phase 2: 前端架构分析",
+     prompt: `<role>
+${frontendRole}
+</role>
+
+<workdir>{{WORKDIR}}</workdir>
+
+<task>
+PRD：<PRD 内容>
+
+请分析前端架构：
+- 组件拆分、状态管理、路由设计
+- UI/UX 关键流程、无障碍考量
+- 实施风险与建议
+</task>
+
+<grounding_rules>
+- 引用 file:line 标注现有组件 / 设计 token
+- 区分「现有组件复用」vs「需新建」
+- 不要捏造未观察到的设计系统约定
+</grounding_rules>
+
+<structured_output_contract>
+Return JSON ONLY:
+{
+  "component_decomposition": [{"component": "...", "purpose": "...", "reuses": []}],
+  "state_management": {"approach": "...", "stores": []},
+  "routing": [{"path": "...", "screen": "..."}],
+  "ux_flows": [{"flow": "...", "steps": []}],
+  "implementation_risks": [{"risk": "...", "mitigation": "..."}]
+}
+Return ≤200 token structured summary.
+</structured_output_contract>`
+   })
+   ```
+
+   **通道 B — codeagent-wrapper fallback**（plugin 未装时降级，并行用 `run_in_background: true`）：
+
    ```
    Bash({
      command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/architect.md\n<TASK>\n需求：<PRD 内容>\n请分析后端架构：模块边界、API 设计、数据模型、依赖关系、实施建议。\n</TASK>\nEOF",
      run_in_background: true,
      timeout: 3600000,
-     description: "{{BACKEND_PRIMARY}} 后端架构分析"
+     description: "{{BACKEND_PRIMARY}} 后端架构分析 (BC)"
    })
-   ```
-
-   **SECOND Bash call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
-   ```
    Bash({
      command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{FRONTEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/architect.md\n<TASK>\n需求：<PRD 内容>\n请分析前端架构：组件拆分、状态管理、路由设计、UI/UX 要点、实施建议。\n</TASK>\nEOF",
      run_in_background: true,
      timeout: 3600000,
-     description: "{{FRONTEND_PRIMARY}} 前端架构分析"
+     description: "{{FRONTEND_PRIMARY}} 前端架构分析 (BC)"
    })
    ```
 
-   **事件驱动等待**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在通知触发的新 turn 处理结果。**不调 TaskOutput**。两个 task 都收到通知后才进下一步。
+   > ⚠️ 通道 B `codeagent-wrapper` 已标 **deprecated**，仅为不能升级 plugin 的环境保留。
+
+   **事件驱动等待**：
+   - **通道 A（plugin）**：两个 Agent 同 message 内 spawn，主线接 ≤200 token 摘要。Agent 完成后自动返回结果。
+   - **通道 B（BC wrapper）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在通知触发的新 turn 处理结果。**不调 TaskOutput**。两个 task 都收到通知后才进下一步。
 
    ⛔ **禁止**：调 `TaskOutput({block: true, timeout: 600000})` (旧 freeze poll 模式) / Kill task。
    ⚠️ **失败处理**：notification status=failed / exit ≠ 0 / parse 失败 → v1.7.87 标准 2-retry / 5s / 3-attempts；3 次全失败才降级单模型。
@@ -308,29 +406,118 @@ Phase 8: INTEGRATION   → Lead 全量验证 + 报告 + 清理
    - `Bash: git diff` 获取完整变更内容。
 
 2. **{{BACKEND_PRIMARY}} + {{FRONTEND_PRIMARY}} 并行审查（PARALLEL）**
-   - 模式与 Phase 2 相同，使用 reviewer prompt：
+   - 模式与 Phase 2 相同（plugin 优先 + wrapper BC fallback），使用 reviewer prompt。
+
+   **⚠ 预备动作（spawn 前必须执行）**：主线先 Read 角色提示词，把内容拼入 `<role>` 块。
+
+   - backend role: `Read("~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md")` → `${backendRole}`
+   - frontend role: `Read("~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md")` → `${frontendRole}`
+
+   **通道 A — plugin spawn（默认）**：
 
-   **FIRST Bash call ({{BACKEND_PRIMARY}})**:
+   **FIRST Agent call ({{BACKEND_PRIMARY}})**:
    ```
-   Bash({
-     command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md\n<TASK>\n审查以下变更：\n<git diff 输出或变更文件列表>\n</TASK>\nOUTPUT (JSON):\n{\n  \"findings\": [{\"severity\": \"Critical|Warning|Info\", \"dimension\": \"logic|security|performance|error_handling\", \"file\": \"path\", \"line\": N, \"description\": \"描述\", \"fix_suggestion\": \"修复建议\"}],\n  \"passed_checks\": [\"检查项\"],\n  \"summary\": \"总体评估\"\n}\nEOF",
-     run_in_background: true,
-     timeout: 3600000,
-     description: "{{BACKEND_PRIMARY}} 后端审查"
+   Agent({
+     subagent_type: "codex:codex-rescue",
+     description: "team Phase 6: 后端审查",
+     prompt: `<role>
+${backendRole}
+</role>
+
+<workdir>{{WORKDIR}}</workdir>
+
+<task>
+审查以下变更（后端维度：逻辑 / 安全 / 性能 / 错误处理）：
+<git diff 输出或变更文件列表>
+
+Read-only review. Do NOT modify any file.
+</task>
+
+<grounding_rules>
+- 每条 finding 必须含 file:line
+- 区分 bug（可触发失败路径）与 concern（风格/可维护性偏好）
+- 检查过但没问题的项放进 passed_checks
+</grounding_rules>
+
+<dig_deeper_nudge>
+- 同根因可能扩散到其他文件——抽样验证
+- 一条精准 Critical > 五条模糊 Warning
+</dig_deeper_nudge>
+
+<structured_output_contract>
+Return JSON ONLY:
+{
+  "findings": [{"severity": "Critical|Warning|Info", "dimension": "logic|security|performance|error_handling", "file": "path", "line": N, "description": "描述", "fix_suggestion": "修复建议"}],
+  "passed_checks": ["检查项"],
+  "summary": "总体评估"
+}
+Return ≤200 token structured summary.
+</structured_output_contract>`
+   })
+   ```
+
+   **SECOND Agent call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
+   ```
+   Agent({
+     subagent_type: "gemini:gemini-rescue",
+     description: "team Phase 6: 前端审查",
+     prompt: `<role>
+${frontendRole}
+</role>
+
+<workdir>{{WORKDIR}}</workdir>
+
+<task>
+审查以下变更（前端维度：模式一致性 / 可维护性 / 无障碍 / UX / 前端安全）：
+<git diff 输出或变更文件列表>
+
+Read-only review. Do NOT modify any file.
+</task>
+
+<grounding_rules>
+- 每条 finding 必须含 file:line
+- 检查过但没问题的项放进 passed_checks
+</grounding_rules>
+
+<dig_deeper_nudge>
+- 同模式问题可能扩散到相邻文件——抽样验证
+- 一条精准 Critical > 五条模糊 Warning
+</dig_deeper_nudge>
+
+<structured_output_contract>
+Return JSON ONLY:
+{
+  "findings": [{"severity": "Critical|Warning|Info", "dimension": "patterns|maintainability|accessibility|ux|frontend_security", "file": "path", "line": N, "description": "描述", "fix_suggestion": "修复建议"}],
+  "passed_checks": ["检查项"],
+  "summary": "总体评估"
+}
+Return ≤200 token structured summary.
+</structured_output_contract>`
    })
    ```
 
-   **SECOND Bash call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
+   **通道 B — codeagent-wrapper fallback**（plugin 未装时降级）：
+
    ```
    Bash({
-     command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{FRONTEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md\n<TASK>\n审查以下变更：\n<git diff 输出或变更文件列表>\n</TASK>\nOUTPUT (JSON):\n{\n  \"findings\": [{\"severity\": \"Critical|Warning|Info\", \"dimension\": \"patterns|maintainability|accessibility|ux|frontend_security\", \"file\": \"path\", \"line\": N, \"description\": \"描述\", \"fix_suggestion\": \"修复建议\"}],\n  \"passed_checks\": [\"检查项\"],\n  \"summary\": \"总体评估\"\n}\nEOF",
+     command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md\n<TASK>\n审查以下变更：\n<git diff 输出或变更文件列表>\n</TASK>\nOUTPUT (JSON): [same schema as 通道 A]\nEOF",
      run_in_background: true,
      timeout: 3600000,
-     description: "{{FRONTEND_PRIMARY}} 前端审查"
+     description: "{{BACKEND_PRIMARY}} 后端审查 (BC)"
+   })
+   Bash({
+     command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{FRONTEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md\n<TASK>\n审查以下变更：\n<git diff 输出或变更文件列表>\n</TASK>\nOUTPUT (JSON): [same schema as 通道 A]\nEOF",
+     run_in_background: true,
+     timeout: 3600000,
+     description: "{{FRONTEND_PRIMARY}} 前端审查 (BC)"
    })
    ```
 
-   **事件驱动等待**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在通知触发的新 turn 处理。**不调 TaskOutput**。两个 task 都收到通知才进 step 3。
+   > ⚠️ 通道 B `codeagent-wrapper` 已标 **deprecated**，仅为不能升级 plugin 的环境保留。
+
+   **事件驱动等待**：
+   - **通道 A（plugin）**：两个 Agent 同 message 内 spawn，主线接 ≤200 token 摘要。
+   - **通道 B（BC wrapper）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在通知触发的新 turn 处理。**不调 TaskOutput**。两个 task 都收到通知才进 step 3。
 
    ⛔ **禁止**：调 `TaskOutput({block: true, timeout: 600000})` (旧 freeze poll 模式) / Kill task。
    ⚠️ **失败处理**：notification status=failed / exit ≠ 0 / parse 失败 → v1.7.87 标准 2-retry / 5s / 3-attempts；3 次全失败才降级单模型。

package/templates/commands/workflow.md

@@ -39,41 +39,74 @@ subagent_freshness: required
 - 如果用户通过 `/add-dir` 添加了多个工作区，先用 Glob/Grep 确定任务相关的工作区
 - 如果无法确定，用 `AskUserQuestion` 询问用户选择目标工作区
 
-**调用语法**（并行用 `run_in_background: true`，串行用 `false`）：
+**调用通道路由（CCG codeagent 退役，v2.2.0+）**
+
+1. **优先 plugin spawn**（默认）：plugin 已装 → `Agent(subagent_type="<codex:codex-rescue|gemini:gemini-rescue>")`。session 复用通过 prompt 内 `--resume` flag 表达（subagent 映射为 codex/gemini `--resume-last`，**注意是 last，不是 by-id**）。
+2. **降级 codeagent-wrapper**（BC fallback）：plugin 未装 → Bash 调用，保留 `resume <SESSION_ID>` 显式会话管理。
+
+**判定**：preflight `Bash` 跑 `ls ~/.claude/plugins/` 看有无 `codex@*` / `gemini@*` 子目录。
+
+---
+
+**通道 A — plugin spawn（默认）**：
+
+**预备动作**：spawn 前主线先 Read 对应阶段的角色提示词（见下方表），把内容拼入 `<role>` 块。
 
 ```
 # 新会话调用
-Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend <{{BACKEND_PRIMARY}}|{{FRONTEND_PRIMARY}}> {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'
-ROLE_FILE: <角色提示词路径>
-<TASK>
+Agent({
+  subagent_type: "<codex:codex-rescue|gemini:gemini-rescue>",
+  description: "简短描述",
+  prompt: `<role>
+${roleContent}  // 主线 Read 后的角色提示词内容
+</role>
+
+<workdir>{{WORKDIR}}</workdir>
+
+<task>
 需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
 上下文：<前序阶段收集的项目上下文、分析结果等>
-</TASK>
-OUTPUT: 期望输出格式
-EOF",
+</task>
+
+<structured_output_contract>
+<期望输出格式 / JSON schema>
+Return ≤200 token structured summary.
+</structured_output_contract>`
+})
+
+# 复用会话（同一 Claude session 内的连续阶段）
+Agent({
+  subagent_type: "<codex:codex-rescue|gemini:gemini-rescue>",
+  description: "简短描述",
+  prompt: `--resume
+
+<task>
+<delta 指令（仅本阶段变化，不重述前序上下文，由 codex/gemini thread 自带历史）>
+</task>`
+})
+```
+
+**通道 B — wrapper BC fallback**（plugin 未装时）：
+
+```
+# 新会话
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend <{{BACKEND_PRIMARY}}|{{FRONTEND_PRIMARY}}> {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'\nROLE_FILE: <角色提示词路径>\n<TASK>\n需求：<增强后的需求>\n上下文：<前序阶段上下文>\n</TASK>\nOUTPUT: 期望输出格式\nEOF",
   run_in_background: true,
   timeout: 3600000,
-  description: "简短描述"
+  description: "简短描述 (BC)"
 })
 
-# 复用会话调用
+# 复用会话（显式 SESSION_ID）
 Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend <{{BACKEND_PRIMARY}}|{{FRONTEND_PRIMARY}}> {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - \"{{WORKDIR}}\" <<'EOF'
-ROLE_FILE: <角色提示词路径>
-<TASK>
-需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
-上下文：<前序阶段收集的项目上下文、分析结果等>
-</TASK>
-OUTPUT: 期望输出格式
-EOF",
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend <{{BACKEND_PRIMARY}}|{{FRONTEND_PRIMARY}}> {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - \"{{WORKDIR}}\" <<'EOF'\nROLE_FILE: <角色提示词路径>\n<TASK>\n需求：<增强后的需求>\n上下文：<前序阶段上下文>\n</TASK>\nEOF",
   run_in_background: true,
   timeout: 3600000,
-  description: "简短描述"
+  description: "简短描述 (BC, resume)"
 })
 ```
 
-**角色提示词**：
+**角色提示词路径**（通道 A 主线 Read 后拼入 `<role>` 块；通道 B 仍用 `ROLE_FILE:` 写在 EOF 内）：
 
 | 阶段 | 后端 | 前端 |
 |------|-------|--------|
@@ -81,7 +114,9 @@ EOF",
 | 规划 | `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/architect.md` | `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/architect.md` |
 | 审查 | `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md` | `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md` |
 
-**会话复用**：每次调用返回 `SESSION_ID: xxx`，后续阶段用 `resume xxx` 复用上下文（注意：是 `resume`，不是 `--resume`）。
+**会话复用模型差异**：
+- **通道 A（plugin）**：同 Claude session 内连续阶段用 `--resume`，自动接上一次同 backend 的 thread（codex/gemini 各自独立的 `--resume-last` 行为）。**不支持跨任务跳点 resume by ID**——若中间插了其他 codex 调用会串。
+- **通道 B（wrapper）**：每次 spawn 返回 `SESSION_ID: xxx`，后续 `resume xxx` 任意复用（注意：是 `resume`，不是 `--resume`）。
 
 **并行调用 + 事件驱动等待**：