ccgx-workflow 2.4.1 → 2.5.0

package/templates/commands/team-exec.md

@@ -1,5 +1,6 @@
 ---
 description: 'Agent Teams 并行实施 - 读取计划文件，spawn Builder teammates 并行写代码'
+argument-hint: "[--no-regression-gate]"
 context_budget: orchestrator-15
 subagent_freshness: required
 ---
@@ -37,15 +38,17 @@ subagent_freshness: required
 ### Step 2: 解析依赖图
 1. **读取计划文件**：优先解析末尾的 `tasks:` yaml 块（machine-readable），fallback 到 Markdown 子任务列表。
 2. **抽取每个任务**：`id` / `type` / `files` / `wave` / `depends_on` / `prompt-bearing 内容（实施步骤 + 验收标准 + 文件范围）`。
-3. **降级兼容（旧版 plan 文件）**：
-   - 若任何任务缺失 `wave` 字段 → 整份计划全部归入 `wave: 1`，`depends_on: []`，全并行执行。
+3. **权威分波（ccg-team-schedule.cjs 拓扑导出）**：
    - 若任何任务缺失 `id` 字段 → 按出现顺序自动编号 `T1, T2, ...`。
-   - 输出降级提示：`⚠️ 检测到旧版 plan（无 wave 字段），已降级为单 wave 全并行模式`。
-4. **拓扑校验**：
-   - `depends_on` 引用的 id 必须都存在
-   - 任务自身 wave 必须严格大于其所有 `depends_on` 任务的 wave
-   - 同 wave 内任务文件 `files` 必须零交叉
-   - 任一校验失败 → 终止，列出问题并要求用户修正 plan 文件
+   - 用 Write 工具把抽取的任务写成临时 JSON 文件（数组，每项 `{"id","files","depends_on","wave","status"}`；`wave` 缺省可省略，`status` 来自断点续跑检测，缺省 `pending`）。
+   - 运行：`node ~/.claude/.ccg/scripts/ccg-team-schedule.cjs --tasks <临时JSON路径>`。
+   - **以脚本 stdout 的 `waves` 为权威分波**；plan 中声明的 `wave` 字段仅作交叉核对提示。`warnings`（declared/derived 不一致、文件交叉拆分）原样展示给用户。
+   - 脚本不存在（旧安装）→ 降级为按本文规则由 LLM 手工 Kahn 拓扑排序（无依赖 → wave 1；所有依赖均已分波 → 最大依赖 wave + 1；同 wave 文件交叉则把后声明的任务顺延到下一 wave）。
+4. **降级与校验**：
+   - (a) 任务全部无 `depends_on` 且无 `wave` → 单 wave 全并行（保留现行为）。
+   - (b) 有 `depends_on` 但缺 `wave` → **由 `depends_on` 拓扑导出分波**（⛔ 禁止丢弃依赖全并行），输出提示：`ℹ️ plan 缺 wave 字段，已按 depends_on 拓扑导出 M 个 wave`。
+   - (c) 同 wave 文件交叉 → **不终止**：自动拆分为串行子波（安全网），输出提示 `⚠️ wave N 存在文件交叉，已自动拆分串行化`。
+   - (d) 仅以下情况终止并要求用户修正 plan：依赖循环 / `depends_on` 引用未知 id / 重复 id（脚本 exit 1，stderr 列出问题）。
 5. **断点续跑检测**：
    - 若 `<WORKDIR>/.ccg/state.md` 已存在，读取其中各任务状态：
      * `completed` → 跳过
@@ -62,6 +65,7 @@ subagent_freshness: required
   - Wave 1: X 个并行 Builder
   - Wave 2: Y 个并行 Builder（依赖 Wave 1）
   - ...
+  - Wave 划分来源：ccg-team-schedule.cjs 拓扑导出（N 条 warnings）
   - 失败处理：单任务失败不阻塞同 wave，依赖该任务的下游任务自动 skipped
   - 状态文件：.ccg/state.md（每个 wave 结束自动更新）
   确认开始？
@@ -124,6 +128,16 @@ subagent_freshness: required
    ## 验收标准
    <从计划中提取>
 
+   ## SUMMARY 写入协议（⛔ 禁止直接 Write SUMMARY.md）
+   多个 Builder 并发写同一个 `.context/<phase>/SUMMARY.md` 会互相覆盖（lost-update）。完成任务后：
+   1. 用 Write 工具把 patch JSON 写到临时文件（如 `<WORKDIR>/.context/<phase>/.patch-<task.id>.json`）：
+      `{"taskId":"<task.id>","plan":"<plan 文件路径>","keyFiles":[...],"tests":[...],"completed":false,"notes":"<一句话结果>"}`
+      - 必填：`taskId` / `keyFiles`（你实际创建或修改的文件）/ `completed: false` / `notes`
+      - **必填 `tests`**：本任务创建或修改的测试文件清单（喂给每波回归门；没有则填 `[]`）
+   2. 运行：`node ~/.claude/.ccg/scripts/ccg-state-lock.cjs merge-summary --workdir <WORKDIR> --phase <phase> --patch-file <临时文件>`
+      （单进程内完成 锁→读→合并→原子写→释放；⛔ 禁止自行分步 acquire/release 锁）
+   3. 脚本不存在（旧安装）→ 降级为直接 Write SUMMARY.md（注意：并发下有 lost-update 竞态风险）。
+
    完成所有步骤后，标记任务为 completed。
    失败时，明确说出失败原因，标记为 failed，不要假装完成。
    ```
@@ -138,11 +152,24 @@ subagent_freshness: required
    - 必须等到本 wave **全部 Builder** 都退出（completed 或 failed），才能进入下一 wave。
 
 5. **Wave 结束清理**：
-   - 通过 SendMessage 给本 wave 所有 Builder 发 shutdown_request。
-   - 更新 `.ccg/state.md`（见 Step 6 格式）。
-   - 输出 wave 摘要：
+
+   a. 通过 SendMessage 给本 wave 所有 Builder 发 shutdown_request。
+
+   b. **每波 cross-phase 回归门（regression gate）**：
+      1. **Skip 条件**（任一满足则跳过本 wave 的门，记录原因）：`.context/` 下除当前 phase（plan 主名）外无 `completed: true` 的 SUMMARY.md；收集到的测试清单为空；用户传了 `--no-regression-gate`。
+      2. **收集清单**：只读各前序 phase `SUMMARY.md` 的 frontmatter（维持 frontmatter-only 预算契约）——`tests` 字段非空优先用之；缺省回退到 `key_files` 中匹配测试文件名（`*.test.*` / `*.spec.*` / `__tests__/` / `*_test.go` / `test_*.py` / `tests?/` 目录）的条目。跳过 `.context/` 保留目录（jobs/debug/uat/codebase/tasks）。等价于 `collectRegressionTests()`（src/utils/phase-context.ts）。
+      3. **执行**：测试命令解析优先级——package.json `scripts.test` 存在 → `npx vitest run <files>` 或 `pnpm test -- <files>`（runner 支持文件参数时按清单限定范围）> Makefile `make test` > `cargo test` > `go test ./...` > `pytest <files>`；无法限定范围则跑全量。
+      4. **全过** → 输出单行 `✅ 回归门(Wave N): K 个前序 phase 测试文件通过`，并在 state.md 对应 wave 节追加 `Regression: pass (K files)`。
+      5. **失败** → 输出表格（测试文件 | 来源 phase | 失败摘要首行）+ `AskUserQuestion` 三选项：
+         - **立即修复（推荐）**：指导本 wave 失败相关 Builder 或 spawn 单个修复 Builder，修完重跑回归门
+         - **继续下一 wave**：在 state.md Notes 段记录 `Regression: FAIL (accepted)`，风险自担（回归会复利）
+         - **中止执行**：保留 state.md 断点，终止
+
+   c. 更新 `.ccg/state.md`（见 Step 6 格式）。**写入方式**：用 Write 工具把新内容写到临时文件，然后 `node ~/.claude/.ccg/scripts/ccg-state-lock.cjs locked-write --target <WORKDIR>/.ccg/state.md --content-file <临时文件>`（锁 + 原子写）。脚本不存在（旧安装）→ 降级为直接 Write。
+
+   d. 输出 wave 摘要：
      ```
-     ✅ Wave <N> 完成: completed=X, failed=Y, skipped=Z
+     ✅ Wave <N> 完成: completed=X, failed=Y, skipped=Z | 回归门: pass/FAIL/skipped
      → 进入 Wave <N+1>
      ```
 
@@ -172,7 +199,8 @@ subagent_freshness: required
 **核心契约**：Lead 不接 Builder 的全部 stdout。每个 Builder 完成任务后，**必须由 Lead 读取该任务对应的 `.context/<phase>/SUMMARY.md` 的 YAML frontmatter**——不读 body，不读 builder transcript。
 
 - `<phase>` 取计划文件主名（如 `.claude/team-plan/user-auth.md` → `user-auth`）。
-- frontmatter 字段（与 `/ccg:execute` 5.3 写入约定一致）：`phase`, `plan`, `provides`, `affects`, `key_files`, `completed`, `completed_at`, `notes`。
+- frontmatter 字段（与 `/ccg:execute` 5.3 写入约定一致）：`phase`, `plan`, `provides`, `affects`, `key_files`, `tests`, `completed`, `completed_at`, `notes`（`tests` 为 P1-6 新增可选字段，喂给每波回归门；旧 SUMMARY 缺省视为 `[]`）。
+- **写入侧**：Builder 通过 `ccg-state-lock.cjs merge-summary` 合并写入（见 Step 4.3 的 SUMMARY 写入协议），多 Builder 并发安全。
 - **预算硬约束**：单个 SUMMARY.md frontmatter < 200 tokens，5 个 phase 累计 < 1000 tokens 进入 orchestrator context。如某 SUMMARY 超出 200 tokens，截断 `notes` 字段并记录到 state.md 的 Notes 段。
 - **缺失处理**：若 Builder 没写 SUMMARY.md（异常退出 / 老版本 plan 文件），Lead 把对应任务标 `failed` 而非凭 builder 消息推断状态。
 
@@ -215,6 +243,8 @@ subagent_freshness: required
 - [ ] 所有可执行 wave 已按顺序跑完
 - [ ] 同 wave Builder 在单条消息内并行 spawn（已校验：消息内多 tool calls）
 - [ ] 失败任务不阻塞同 wave，下游依赖任务自动 skipped
+- [ ] 每个 wave 结束已跑回归门（或显式 skip 原因已记录）
+- [ ] Builder SUMMARY 写入走 merge-summary 锁协议
 - [ ] `.ccg/state.md` 反映最终状态
 - [ ] 变更摘要 + Wave 表已输出
 - [ ] Team 已清理
@@ -237,6 +267,7 @@ subagent_freshness: required
 ## Wave 1 (completed)
 - [x] T1: 用户 API (src/api/users.ts) — completed @ 10:15
 - [x] T2: 数据模型 (prisma/schema.prisma) — completed @ 10:18
+Regression: pass (2 files)
 
 ## Wave 2 (in_progress)
 - [x] T3: 用户卡片组件 (src/components/UserCard.tsx) — completed @ 10:30
@@ -255,6 +286,7 @@ subagent_freshness: required
 
 **字段约定**：
 - 每个 task 一行，`[x]` = completed，`[ ]` = pending/in_progress/failed/skipped
+- 每个 wave 节末尾可含一行回归门结果：`Regression: pass (K files)` / `Regression: FAIL (accepted)` / `Regression: skipped (<原因>)`
 - 行尾 `— <status> @ <时间>` 标注最新状态
 - `(builder-<id>)` 表示当前承担该任务的 Builder name
 - `(depends_on: ...)` 解释 pending 原因

package/templates/commands/team.md

@@ -159,103 +159,53 @@ Phase 8: INTEGRATION   → Lead 全量验证 + 报告 + 清理
 
    **调用通道路由（CCG codeagent 退役，v2.2.0+）**
 
-   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 plugin spawn：
+   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 Bash 直调 plugin 快路径：
 
-   1. **优先 plugin spawn**（默认）：装了 `codex@openai-codex` + gemini plugin → 用 `Agent(subagent_type="codex:codex-rescue")` + `Agent(subagent_type="gemini:gemini-rescue")` 并行，主线接 ≤200 token 摘要。
+   1. **优先 Bash 直调 plugin 快路径**（默认）：装了 `codex@openai-codex` + gemini plugin → 用 `{{CODEX_BASH_TASK}}` / `{{GEMINI_BASH_TASK}}` 占位符 + `--prompt-file` 并行 Bash 直调（review.md 同款），绕开 sonnet wrapper silent-fallback；**仅 `gemini-ccgx` fork 走 gemini-batch 29s 快路径，上游 + repatch 仍走 companion(ACP) 慢路径**（Windows 实测 5+min 卡死风险仍在），主线 `JSON.parse(stdout).text`。
    2. **降级 codeagent-wrapper**（BC fallback）：plugin 未装 → fallback Bash 调用，行为与 plugin 路径等价。
 
-   **判定**：preflight `Bash` 跑 `node ~/.claude/.ccg/scripts/check-plugins.cjs`（解析 Claude Code 权威 `installed_plugins.json`）。exit `0` + stdout `{"codex":"<ver>","gemini":"<ver>"}` → 通道 A（plugin 默认）；非 `0` → 通道 B（wrapper BC fallback）。
+   **判定**：preflight `Bash` 跑 `node ~/.claude/.ccg/scripts/check-plugins.cjs`（解析 Claude Code 权威 `installed_plugins.json`）。exit `0` + stdout `{"codex":"<ver>","gemini":"<ver>"}` → 通道 A（Bash 直调快路径，默认）；非 `0` → 通道 B（wrapper BC fallback）。
 
    - **CRITICAL**: 必须在一条消息中同时发起两个并行调用。
 
-   **⚠ 预备动作（spawn 前必须执行）**：`codex:codex-rescue` / `gemini:gemini-rescue` 是 thin forwarder，不会主动 Read 路径文件。主线必须在 spawn 前先 Read 两个角色提示词文件，把**内容**直接拼入下方 Agent prompt 的 `<role>` 块。
+   **通道 A — Bash 直调 plugin 快路径（默认）**：
 
-   - backend role: `Read("~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/architect.md")` → `${backendRole}`
-   - frontend role: `Read("~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/architect.md")` → `${frontendRole}`
+   > 占位符 `{{CODEX_BASH_TASK}}` / `{{GEMINI_BASH_TASK}}` 由 install 渲染为 `node <ccgx-call-plugin.mjs 绝对路径> <vendor> --json`。LLM 只需 Write tmpfile + 追加 `--prompt-file <tmpfile>` 运行，**不写 `Agent(...)`、不内联 role 全文**。
 
-   **通道 A — plugin spawn（默认）**：
+   **Step — Write 两个 tmpfile**（≤2KB，让模型自己 Read 角色文件）：
+   ```
+   Write({ file_path: ".context/tmp/ccg-team-arch-codex-$JOB.txt", content: <backend 架构模板> })
+   Write({ file_path: ".context/tmp/ccg-team-arch-gemini-$JOB.txt", content: <frontend 架构模板> })
+   ```
 
-   **FIRST Agent call ({{BACKEND_PRIMARY}})**:
+   backend 架构模板：
    ```
-   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>`
-   })
+   # 任务：team Phase 2 后端架构分析
+
+   工作目录：{{WORKDIR}}（你已在此）
+   角色定义见 ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/architect.md，**先用 Read 工具读取再开始**。
+   **必须前台执行，禁止 --background / --wait**（外层已 run_in_background，插件内再 background = 双重后台，stop-gate/status/cancel 全盲）。对文件系统零写入。
+
+   PRD：<PRD 内容>
+   分析后端架构：模块边界 / API 设计 / 数据模型 / 依赖关系 / 关键算法 / 实施风险。
+   引用 file:line 标注现有模式；区分「现有已支持」vs「需新建」；不捏造未观察到的依赖。
+   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":"..."}] }
    ```
 
-   **SECOND Agent call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
+   frontend 架构模板（角色换 {{FRONTEND_PRIMARY}}/architect.md，同硬约束；分析组件拆分/状态管理/路由/UX 流程/无障碍/实施风险；JSON 字段 component_decomposition / state_management / routing / ux_flows / implementation_risks）。
+
+   **Step — 并行 Bash 直调**（同一 message，`run_in_background: true`）：
    ```
-   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>`
-   })
+   Bash({ command: `{{CODEX_BASH_TASK}} --prompt-file .context/tmp/ccg-team-arch-codex-$JOB.txt`, description: "team Phase 2: backend arch (codex direct)", run_in_background: true })
+   Bash({ command: `{{GEMINI_BASH_TASK}} --prompt-file .context/tmp/ccg-team-arch-gemini-$JOB.txt`, description: "team Phase 2: frontend arch (gemini direct)", run_in_background: true })
    ```
 
-   **通道 B — codeagent-wrapper fallback**（plugin 未装时降级，并行用 `run_in_background: true`）：
+   **通道 B — codeagent-wrapper fallback**（plugin 未装时降级，并行用 `run_in_background: true`；wrapper 的 `ROLE_FILE:` 由 `invoke-model.mjs` 解析故保留）：
 
    ```
    Bash({
@@ -275,8 +225,8 @@ Return ≤200 token structured summary.
    > ⚠️ 通道 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 都收到通知后才进下一步。
+   - **通道 A（Bash 直调快路径）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在新 turn Read stdout 后 `JSON.parse(stdout).text` 取真实输出。两个 task 都收到通知后才进下一步。
+   - **通道 B（BC wrapper）**：同上 bg + 事件驱动，但 parse `--progress` 行而非 `.text`。**不调 TaskOutput**。
 
    ⛔ **禁止**：调 `TaskOutput({block: true, timeout: 600000})` (旧 freeze poll 模式) / Kill task。
    ⚠️ **失败处理**：notification status=failed / exit ≠ 0 / parse 失败 → v1.7.87 标准 2-retry / 5s / 3-attempts；3 次全失败才降级单模型。
@@ -320,6 +270,7 @@ Return ≤200 token structured summary.
    - 为每个子任务分配唯一 `id`、`wave` 整数、`depends_on` 列表。
    - `wave: 1` = 无依赖、可立即开跑；`wave: N` = 所有 depends_on 必须在 wave < N。
    - 拓扑排序最大化每 wave 并行度，**同 wave 内文件零交叉**强制约束。
+   - exec 阶段以 `ccg-team-schedule.cjs` 拓扑导出为权威分波，plan 中的 `wave` 字段仅作交叉核对提示（详见 `/ccg:team-exec` Step 2）。
 
 4. **写入计划文件**
    - 路径：`.claude/team-plan/<任务名>-plan.md`
@@ -364,8 +315,9 @@ Return ≤200 token structured summary.
    c. **等待本 wave 全部 Dev 退出（completed 或 failed）**
       - 单 Dev 失败 → 记录到 `.ccg/state.md`，**不打断**同 wave 其他 Dev。
       - 必须等全员退出才能进入下一 wave。
+      - Dev 完成后 SUMMARY.md 写入必须走 merge-summary 锁协议（`ccg-state-lock.cjs`），协议细节同 `/ccg:team-exec` Step 4 第 3 点。
 
-   d. **Wave 结束**：通过 SendMessage 给本 wave 所有 Dev 发 shutdown_request，更新 `.ccg/state.md`。
+   d. **Wave 结束**：通过 SendMessage 给本 wave 所有 Dev 发 shutdown_request；每波末先跑 cross-phase 回归门，再用 locked-write 更新 `.ccg/state.md`（细节同 `/ccg:team-exec` Step 4 第 5 点）。
 
 3. **失败汇报**：所有 wave 结束后，若存在 failed 任务，向用户报告并询问"重试一次 / 传给 Reviewer / 接受失败"（参考 `/ccg:team-exec` 的失败处理）。
 
@@ -408,95 +360,40 @@ Return ≤200 token structured summary.
 2. **{{BACKEND_PRIMARY}} + {{FRONTEND_PRIMARY}} 并行审查（PARALLEL）**
    - 模式与 Phase 2 相同（plugin 优先 + wrapper BC fallback），使用 reviewer prompt。
 
-   **⚠ 预备动作（spawn 前必须执行）**：主线先 Read 角色提示词，把内容拼入 `<role>` 块。
+   **通道 A — Bash 直调 plugin 快路径（默认）**：
 
-   - backend role: `Read("~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md")` → `${backendRole}`
-   - frontend role: `Read("~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md")` → `${frontendRole}`
+   > 占位符 `{{CODEX_BASH_TASK}}` / `{{GEMINI_BASH_TASK}}` 由 install 渲染为 `node <ccgx-call-plugin.mjs 绝对路径> <vendor> --json`。LLM 只需 Write tmpfile + 追加 `--prompt-file <tmpfile>` 运行，**不写 `Agent(...)`、不内联 role 全文**，让模型自己 Read 角色 + `git diff` 读变更。
 
-   **通道 A — plugin spawn（默认）**：
+   **Step — Write 两个 tmpfile**（≤2KB）：
+   ```
+   Write({ file_path: ".context/tmp/ccg-team-review-codex-$JOB.txt", content: <backend review 模板> })
+   Write({ file_path: ".context/tmp/ccg-team-review-gemini-$JOB.txt", content: <frontend review 模板> })
+   ```
 
-   **FIRST Agent call ({{BACKEND_PRIMARY}})**:
+   backend review 模板：
    ```
-   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>`
-   })
+   # 任务：team Phase 6 后端审查
+
+   工作目录：{{WORKDIR}}（你已在此）
+   角色定义见 ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md，**先用 Read 工具读取再开始**。
+   **必须前台执行，禁止 --background / --wait**（外层已 run_in_background，插件内再 background = 双重后台，stop-gate/status/cancel 全盲）。只读审查，不改任何文件。
+
+   自己跑 `git diff` 看变更。沿后端维度审：逻辑 / 安全 / 性能 / 错误处理。
+   每条 finding 含 file:line；区分 bug 与 concern；检查过没问题的项放 passed_checks。
+   Return JSON ONLY:
+   { "findings": [{"severity":"Critical|Warning|Info","dimension":"logic|security|performance|error_handling","file":"path","line":N,"description":"描述","fix_suggestion":"修复建议"}],
+     "passed_checks": ["检查项"], "summary": "总体评估" }
    ```
 
-   **SECOND Agent call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
+   frontend review 模板（角色换 {{FRONTEND_PRIMARY}}/reviewer.md，同硬约束；维度=模式一致性/可维护性/无障碍/UX/前端安全，dimension 枚举 patterns|maintainability|accessibility|ux|frontend_security）。
+
+   **Step — 并行 Bash 直调**（同一 message，`run_in_background: true`；只读审查，加 `--no-write`）：
    ```
-   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>`
-   })
+   Bash({ command: `{{CODEX_BASH_TASK}} --no-write --prompt-file .context/tmp/ccg-team-review-codex-$JOB.txt`, description: "team Phase 6: backend review (codex direct)", run_in_background: true })
+   Bash({ command: `{{GEMINI_BASH_TASK}} --no-write --prompt-file .context/tmp/ccg-team-review-gemini-$JOB.txt`, description: "team Phase 6: frontend review (gemini direct)", run_in_background: true })
    ```
 
-   **通道 B — codeagent-wrapper fallback**（plugin 未装时降级）：
+   **通道 B — codeagent-wrapper fallback**（plugin 未装时降级；wrapper 的 `ROLE_FILE:` 由 `invoke-model.mjs` 解析故保留）：
 
    ```
    Bash({
@@ -516,8 +413,8 @@ Return ≤200 token structured summary.
    > ⚠️ 通道 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。
+   - **通道 A（Bash 直调快路径）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在新 turn Read stdout 后 `JSON.parse(stdout).text` 取真实输出。两个 task 都收到通知才进 step 3。
+   - **通道 B（BC wrapper）**：同上 bg + 事件驱动，但 parse `--progress` 行而非 `.text`。**不调 TaskOutput**。
 
    ⛔ **禁止**：调 `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/test.md

@@ -42,14 +42,14 @@ argument-hint: "<测试目标> [--role=architect|critic|implementer|tester|write
 
 ## 调用通道路由（CCG codeagent 退役）
 
-CCG 把双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 plugin spawn：
+CCG 把双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 Bash 直调 plugin 快路径：
 
-1. **优先 plugin spawn**（默认）：装了 `codex@openai-codex` + `gemini@google-gemini` plugin → 用 `Agent(subagent_type="codex:codex-rescue")` + `Agent(subagent_type="gemini:gemini-rescue")` 并行，主线接 ≤200 token 摘要。
+1. **优先 Bash 直调 plugin 快路径**（默认）：装了 `codex@openai-codex` + gemini plugin（推荐 `gemini@gemini-ccgx` fork；或上游 `gemini@google-gemini` 配 repatch）→ 用 `{{CODEX_BASH_TASK}}` / `{{GEMINI_BASH_TASK}}` 占位符 + `--prompt-file` 并行 Bash 直调（review.md 同款），绕开 sonnet wrapper silent-fallback；**仅 `gemini-ccgx` fork 走 gemini-batch 29s 快路径，上游 + repatch 仍走 companion(ACP) 慢路径**（Windows 实测 5+min 卡死风险仍在），主线 `JSON.parse(stdout)` 取 `.text`。
 2. **降级 codeagent-wrapper**（BC fallback）：plugin 未装 → fallback 到 Bash 调用，行为与 plugin 路径等价。
 
-**判定**：preflight `Bash` 跑 `node ~/.claude/.ccg/scripts/check-plugins.cjs`（解析 Claude Code 权威 `installed_plugins.json`）。exit `0` + stdout `{"codex":"<ver>","gemini":"<ver>"}` → 通道 A（plugin 默认）；非 `0` → 通道 B（wrapper BC fallback）。
+**判定**：preflight `Bash` 跑 `node ~/.claude/.ccg/scripts/check-plugins.cjs`（解析 Claude Code 权威 `installed_plugins.json`）。exit `0` + stdout `{"codex":"<ver>","gemini":"<ver>"}` → 通道 A（Bash 直调快路径，默认）；非 `0` → 通道 B（wrapper BC fallback）。
 
-⚠️ Test 命令在主线 context 内，**允许** `Agent(...)`——与 subagent "禁止嵌套 spawn" 约束不冲突。
+⚠️ Test 命令在主线 context 内执行，通道 A 走 Bash 直调（不再 spawn `Agent(...)`），无嵌套 spawn 顾虑。
 
 ---
 
@@ -62,32 +62,55 @@ CCG 把双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 pl
 
 **调用语法**（双通道）：
 
-**通道 A — plugin spawn（默认）**：
+**通道 A — Bash 直调 plugin 快路径（默认，绕开 sonnet wrapper + ACP 慢路径）**：
+
+> 占位符 `{{CODEX_BASH_TASK}}` / `{{GEMINI_BASH_TASK}}` 由 install 时渲染为
+> `node <ccgx-call-plugin.mjs 绝对路径> <vendor> --json`。LLM **只需把 prompt
+> 写入 tmpfile、追加 `--prompt-file <tmpfile>`、运行**，不写 `Agent(...)`。
+> 这条 Bash 直调通道自动吃到 gemini-batch 29s 快路径，消除 `Agent→gemini-companion→ACP`
+> 的 5+min 卡死与 sonnet wrapper silent-fallback。
 
 ```
-Agent({
-  subagent_type: "<codex:codex-rescue|gemini:gemini-rescue>",
-  description: "Test: <backend|frontend>",
-  prompt: `ROLE_FILE: <角色提示词路径>
+Step 1. 用 Write 把任务描述写到 tmpfile（≤2KB，被测代码用文件路径引用，不内联大段源码）：
+   Write({ file_path: ".context/tmp/ccg-test-codex-$JOB.txt", content: <下方"任务描述模板"> })
+   Write({ 同上，gemini 版本，file_path: ".context/tmp/ccg-test-gemini-$JOB.txt" })
 
-<TASK>
-需求：为以下代码生成测试
-<代码内容>
+Step 2. 用 Bash 调 helper（占位符已渲染；全栈并行两个在同一 message 内 run_in_background: true，单端则 false）：
+   Bash({ command: `{{CODEX_BASH_TASK}} --prompt-file .context/tmp/ccg-test-codex-$JOB.txt`, description: "Test: backend (codex direct)", run_in_background: true })
+   Bash({ command: `{{GEMINI_BASH_TASK}} --prompt-file .context/tmp/ccg-test-gemini-$JOB.txt`, description: "Test: frontend (gemini direct)", run_in_background: true })
+
+Step 3. 等 task-notification 后 Read 各自 stdout，`JSON.parse(stdout)` 取 helper 扁平化后的 `.text` 字段。
+```
+
+**任务描述模板**（写到 tmpfile 的内容；保持 ≤2KB）：
+
+```
+# 任务：生成测试
+
+工作目录：<工作目录绝对路径>（你已在此，可直接用 Bash/Read）
+角色定义见 <角色提示词路径>（codex 用 ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/tester.md，gemini 用 {{FRONTEND_PRIMARY}}/tester.md），**先用 Read 工具读取该文件再开始**。
+
+## 你要做的事
+
+被测代码：<目标文件路径 + 符号名，自己 Read，不内联大段源码>
 需求描述：<增强后的需求（如未增强则用 $ARGUMENTS）>
 要求：
-1. 使用项目现有测试框架
+1. 使用项目现有测试框架（自己 Glob/Read 配置确认）
 2. 覆盖正常路径、边界条件、异常处理
-</TASK>
 
-OUTPUT: 完整测试代码
-Return ≤200 token structured summary (plugin-native protocol).
-`
-})
+## 硬约束
+
+- **必须前台执行，禁止 `--background` / `--wait`**（ccgx 编排层已用 Agent run_in_background 包裹，插件内再 background = 双重后台，stop-gate / status / cancel 全盲）。
+- 对文件系统零写入，仅产出测试代码文本（落盘由主线 Claude 执行）。
+
+## 输出
+
+完整测试代码。只输出代码块，无其他文本。
 ```
 
-并行**两个 Agent 在同一 message 内同时 spawn**。
+⛔ **严禁**：内联大段被测源码（撞 argv ~32KB 上限）；写 `Agent(subagent_type="gemini:gemini-rescue")`（走 ACP 慢路径）；heredoc / `-p "..."` 内联；硬编码 plugin 路径。**唯一允许**：copy 占位符 + 追加 `--prompt-file <tmpfile>`。
 
-**通道 B — codeagent-wrapper fallback**（plugin 未装时降级，并行用 `run_in_background: true`）：
+**通道 B — codeagent-wrapper fallback**（plugin 未装时降级，并行用 `run_in_background: true`；wrapper 的 `ROLE_FILE:` 由 `invoke-model.mjs` 解析故保留）：
 
 ```
 Bash({
@@ -109,7 +132,7 @@ EOF",
 })
 ```
 
-> ⚠️ 通道 B `codeagent-wrapper` 已标 **deprecated**。
+> ⚠️ 通道 B `codeagent-wrapper` 已标 **deprecated**，仅 plugin 未装时使用。
 
 **角色提示词**：
 
@@ -131,7 +154,7 @@ EOF",
 1. 同 message 内 spawn 多个 `Bash(run_in_background: true)` 并行任务
 2. spawn 完后主线说明已启动 task-id，**直接 turn end**，**不调 TaskOutput**
 3. Claude Code 引擎在每个 task 完成时自动发 `<task-notification>` system-reminder 触发主线新 turn
-4. 主线在新 turn 处理：从 `<output-file>` 路径 read stdout，按通道 schema parse 结果
+4. 主线在新 turn 处理：从 `<output-file>` 路径 read stdout，`JSON.parse(stdout)` 取 helper 扁平化后的 `.text`（通道 A）/ `--progress` 行（通道 B）
 5. **必须等所有相关 task 都收到通知**才进入下一阶段（按 task-id 计数已收齐）
 
 ⛔ **禁止**：
@@ -164,18 +187,17 @@ EOF",
 
 `[模式：生成]`
 
-**⚠️ 根据代码类型必须调用对应模型**（参照上方调用规范）：
-
-- **后端代码** → `Bash({ command: "...--backend {{BACKEND_PRIMARY}}...", run_in_background: false })`
-  - ROLE_FILE: `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/tester.md`
-- **前端代码** → `Bash({ command: "...--backend {{FRONTEND_PRIMARY}}...", run_in_background: false })`
-  - ROLE_FILE: `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/tester.md`
-- **全栈代码** → 并行调用两者：
-  1. `Bash({ command: "...--backend {{BACKEND_PRIMARY}}...", run_in_background: true })`
-     - ROLE_FILE: `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/tester.md`
-  2. `Bash({ command: "...--backend {{FRONTEND_PRIMARY}}...", run_in_background: true })`
-     - ROLE_FILE: `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/tester.md`
-  用 `TaskOutput` 等待结果
+**⚠️ 根据代码类型必须调用对应模型**（参照上方调用规范，先 Write tmpfile 再 `{{CODEX_BASH_TASK}}` / `{{GEMINI_BASH_TASK}}` + `--prompt-file`）：
+
+- **后端代码** → `{{CODEX_BASH_TASK}} --prompt-file <tmpfile>`（单端 `run_in_background: false`）
+  - 角色：tmpfile 内写"角色定义见 `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/tester.md`，先用 Read 工具读取再开始"
+- **前端代码** → `{{GEMINI_BASH_TASK}} --prompt-file <tmpfile>`（单端 `run_in_background: false`）
+  - 角色：tmpfile 内写"角色定义见 `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/tester.md`，先用 Read 工具读取再开始"
+- **全栈代码** → 并行调用两者（同 message 内 `run_in_background: true`，事件驱动等待 task-notification，**不调 TaskOutput**）：
+  1. `{{CODEX_BASH_TASK}} --prompt-file <tmpfile-codex>`
+     - 角色：tmpfile 内写"角色定义见 `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/tester.md`，先用 Read 工具读取再开始"
+  2. `{{GEMINI_BASH_TASK}} --prompt-file <tmpfile-gemini>`
+     - 角色：tmpfile 内写"角色定义见 `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/tester.md`，先用 Read 工具读取再开始"
 
 OUTPUT：完整测试代码（使用项目现有测试框架，覆盖正常路径、边界条件、异常处理）