ccgx-workflow 2.4.1 → 2.5.0

package/templates/commands/spec-plan.md

@@ -27,105 +27,64 @@ description: '多模型分析 → 消除歧义 → 零决策可执行计划'
 
    **调用通道路由（CCG codeagent 退役，v2.2.0+）**
 
-   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 plugin spawn：
+   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 Bash 直调 plugin 快路径：
 
-   1. **优先 plugin spawn**（默认）：装了 `codex@openai-codex` + gemini plugin（推荐 `gemini@gemini-ccgx` fork；或上游 `gemini@google-gemini` 配 repatch 脚本）→ 用 `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）。
 
-   ⚠️ spec-plan 命令在主线 context 内，**允许** `Agent(...)`——与 subagent "禁止嵌套 spawn" 约束不冲突。
+   ⚠️ spec-plan 命令在主线 context 内执行，通道 A 走 Bash 直调（不再 spawn `Agent(...)`），无嵌套 spawn 顾虑。
 
    - **CRITICAL**: You MUST launch BOTH {{BACKEND_PRIMARY}} AND {{FRONTEND_PRIMARY}} in a SINGLE message with TWO parallel tool calls.
    - **DO NOT** call one model first and wait. Launch BOTH simultaneously.
    - **工作目录**：`{{WORKDIR}}` **必须通过 Bash 执行 `pwd`（Unix）或 `cd`（Windows CMD）获取当前工作目录的绝对路径**，禁止从 `$HOME` 或环境变量推断。如果用户通过 `/add-dir` 添加了多个工作区，先确定任务相关的工作区。
 
-   **Step 2.1**: In ONE message, spawn TWO models in parallel.
+   **Step 2.1**: In ONE message, spawn TWO Bash-direct helper calls in parallel.
 
-   **⚠ 预备动作（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}}/analyzer.md")` → `${backendRole}`
-   - frontend role: `Read("~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/analyzer.md")` → `${frontendRole}`
+   > 占位符 `{{CODEX_BASH_TASK}}` / `{{GEMINI_BASH_TASK}}` 由 install 渲染为 `node <ccgx-call-plugin.mjs 绝对路径> <vendor> --json`。
+   > LLM 只需 Write tmpfile + 追加 `--prompt-file <tmpfile>` 运行，**不写 `Agent(...)`、不内联 role 全文**。
 
-   Prompt 结构按 `gpt-5-4-prompting` skill 推荐：`<role>` + `<task>` + `<grounding_rules>` + `<structured_output_contract>`。
+   **Step 2.1a — Write 两个 tmpfile**（≤2KB；让模型自己 Read 角色文件）：
+   ```
+   Write({ file_path: ".context/tmp/ccg-specplan-codex-$JOB.txt", content: <backend 任务模板> })
+   Write({ file_path: ".context/tmp/ccg-specplan-gemini-$JOB.txt", content: <frontend 任务模板> })
+   ```
 
-   **通道 A — plugin spawn（默认）**：
+   backend 任务模板：
+   ```
+   # 任务：spec-plan 后端实现分析
+
+   工作目录：{{WORKDIR}}（你已在此）
+   角色定义见 ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/analyzer.md，**先用 Read 工具读取再开始**。
+   **必须前台执行，禁止 --background / --wait**（外层已 run_in_background，插件内再 background = 双重后台，stop-gate/status/cancel 全盲）。对文件系统零写入。
+
+   Analyze change <change_id> from backend perspective: implementation approach / technical risks / alternative architectures / edge cases & failure modes.
+   Cite file:line for claims; mark hypotheses; distinguish observed vs potential risks.
+   Return JSON ONLY:
+   { "approach": "...", "alternatives_rejected": [{"alt":"...","reason":"..."}],
+     "technical_risks": [{"risk":"...","severity":"high|medium|low","mitigation":"..."}],
+     "edge_cases": ["..."], "failure_modes": ["..."] }
+   ```
 
-   **FIRST Agent call ({{BACKEND_PRIMARY}})**:
+   frontend 任务模板（角色换 {{FRONTEND_PRIMARY}}/analyzer.md，同样硬约束）：
    ```
-   Agent({
-     subagent_type: "codex:codex-rescue",
-     description: "spec-plan: backend analysis",
-     prompt: `<role>
-${backendRole}
-</role>
-
-<workdir>{{WORKDIR}}</workdir>
-
-<task>
-Analyze change <change_id> from backend perspective:
-- Implementation approach
-- Technical risks
-- Alternative architectures
-- Edge cases and failure modes
-</task>
-
-<grounding_rules>
-- Cite file:line for claims about existing code
-- Mark hypotheses; don't state guesses as facts
-- For risks, distinguish "observed" (specific code path) vs "potential" (theoretical)
-</grounding_rules>
-
-<structured_output_contract>
-Return JSON ONLY (no preamble):
-{
-  "approach": "selected implementation strategy with rationale",
-  "alternatives_rejected": [{"alt": "...", "reason": "..."}],
-  "technical_risks": [{"risk": "...", "severity": "high|medium|low", "mitigation": "..."}],
-  "edge_cases": ["..."],
-  "failure_modes": ["..."]
-}
-Return ≤200 token structured summary.
-</structured_output_contract>`
-   })
+   Analyze change <change_id> from frontend/integration perspective: maintainability / scalability / integration conflicts.
+   Return JSON ONLY:
+   { "maintainability": {"score":"good|moderate|concerning","factors":["..."]},
+     "scalability": [{"dimension":"...","consideration":"..."}],
+     "integration_conflicts": [{"target":"...","conflict":"...","resolution":"..."}] }
    ```
 
-   **SECOND Agent call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
+   **Step 2.1b — 并行 Bash 直调**（同一 message，`run_in_background: true`；纯分析只读，加 `--no-write`）：
    ```
-   Agent({
-     subagent_type: "gemini:gemini-rescue",
-     description: "spec-plan: frontend analysis",
-     prompt: `<role>
-${frontendRole}
-</role>
-
-<workdir>{{WORKDIR}}</workdir>
-
-<task>
-Analyze change <change_id> from frontend/integration perspective:
-- Maintainability assessment
-- Scalability considerations
-- Integration conflicts
-</task>
-
-<grounding_rules>
-- Cite file:line for claims about existing code
-- Mark hypotheses; don't state guesses as facts
-</grounding_rules>
-
-<structured_output_contract>
-Return JSON ONLY (no preamble):
-{
-  "maintainability": {"score": "good|moderate|concerning", "factors": ["..."]},
-  "scalability": [{"dimension": "...", "consideration": "..."}],
-  "integration_conflicts": [{"target": "...", "conflict": "...", "resolution": "..."}]
-}
-Return ≤200 token structured summary.
-</structured_output_contract>`
-   })
+   Bash({ command: `{{CODEX_BASH_TASK}} --no-write --prompt-file .context/tmp/ccg-specplan-codex-$JOB.txt`, description: "spec-plan: backend (codex direct)", run_in_background: true })
+   Bash({ command: `{{GEMINI_BASH_TASK}} --no-write --prompt-file .context/tmp/ccg-specplan-gemini-$JOB.txt`, description: "spec-plan: frontend (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({
@@ -145,8 +104,8 @@ Return ≤200 token structured summary.
    > ⚠️ 通道 B `codeagent-wrapper` 已标 **deprecated**，仅为不能升级 plugin 的环境保留。
 
    **Step 2.2 (事件驱动)**：
-   - **通道 A（plugin）**：两个 Agent 同 message 内 spawn，主线接 ≤200 token 摘要。Agent 完成后自动返回结果。
-   - **通道 B（BC wrapper）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在通知触发的新 turn 处理结果。**不调 TaskOutput**。两个 task 都收到通知后才进 step 2.3。
+   - **通道 A（Bash 直调快路径）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在新 turn Read stdout 后 `JSON.parse(stdout).text` 取真实输出。两个 task 都收到通知后才进 step 2.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 次全失败才降级单模型。
@@ -169,6 +128,8 @@ Return ≤200 token structured summary.
 
    Iterate with user until ALL ambiguities resolved.
 
+   **REQ 编号固化（歧义全消后必做）**：把确认的需求清单编号为 `REQ-01`..`REQ-NN`，以 checkbox 格式 `- [ ] **REQ-NN** <描述>` 写回 `proposal.md` 的 Requirements 段（已有编号则沿用，不重排）。该格式是 Step 5.6 Requirements Coverage Gate 确定性提取的输入约定（提取规则权威：`src/utils/plan-checker.ts:extractRequirementIds`，checkbox 与表格首列双格式都认）。
+
 4. **PBT Property Extraction**
    - **{{BACKEND_PRIMARY}}**: "Extract PBT properties. For each requirement: [INVARIANT] → [FALSIFICATION STRATEGY]"
    - **{{FRONTEND_PRIMARY}}**: "Define system properties: [PROPERTY] | [DEFINITION] | [BOUNDARY CONDITIONS] | [COUNTEREXAMPLE GENERATION]"
@@ -249,6 +210,7 @@ Return ≤200 token structured summary.
      /opsx:continue
      ```
    - The OPSX skill will use the above summary to create specs.md, design.md, and tasks.md.
+   - **tasks.md REQ 标注规则**：每条 task 行尾标注覆盖的 REQ（如 `- [ ] 1.1 实现密码重置接口 (REQ-01)`），供 Step 5.6 做 word-boundary 覆盖匹配。
    - **Note**: This is an internal call. If this step fails, guide the user to re-run `/ccg:spec-plan`.
    - **STOP**: After artifacts are generated, verify they exist and inform user:
      "Plan phase complete. Artifacts generated: specs.md, design.md, tasks.md. Run `/ccg:spec-impl` to start implementation."
@@ -284,7 +246,24 @@ Return ≤200 token structured summary.
            options: ["force: 忽略 BLOCKER 强制进入实施", "guide: 提供具体指导让 planner 再试", "abort: 放弃当前 plan"]
    ```
 
-   只有 plan-checker ✅ 放行 后才进入下一步（Context Checkpoint）。
+   只有 plan-checker ✅ 放行 后才进入下一步（Requirements Coverage Gate）。
+
+5.6. **Requirements Coverage Gate（确定性，[Gate: escalation]）**
+
+   plan-checker 放行后跑确定性 REQ-ID 覆盖检查（**算法权威：`src/utils/plan-checker.ts:extractRequirementIds` + `checkRequirementsCoverage` 等价规则**）：
+
+   ```
+   a) 从 proposal.md 提取 REQ-IDs（checkbox `- [ ] **REQ-NN**` 或表格首列 `| REQ-NN |`；
+      跳过表格分隔行与表头行；去重保序）
+   b) proposal.md 无任何 REQ-ID → SKIP（输出一行 skip 原因，进入 Step 6）
+   c) 对 specs.md + tasks.md 拼接全文做 word-boundary 匹配（REQ-1 不误配 REQ-10）
+   d) uncovered > 0 → 输出 GSD 风格 gap 表（| REQ-ID | Status | Covered By |）
+      + **阻断**，AskUserQuestion 三选：
+      1. re-plan 补覆盖（推荐）——回 Step 5 修订 specs/tasks
+      2. 移到下一 change——把未覆盖 REQ 显式写入新的 OPSX change（不能口头承诺）
+      3. force 接受 gap——在 design.md 追加 "## Coverage Override" 段记录
+   e) 全覆盖 → 输出 `✓ Requirements coverage: N/N`，进入 Step 6
+   ```
 
 6. **Context Checkpoint**
    - Report current context usage.

package/templates/commands/spec-research.md

@@ -52,14 +52,14 @@ description: '需求 → 约束集（并行探索 + OPSX 提案）'
 
    **调用通道路由（CCG codeagent 退役，v2.2.0+）**
 
-   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 plugin spawn：
+   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 Bash 直调 plugin 快路径：
 
-   1. **优先 plugin spawn**（默认）：装了 `codex@openai-codex` + gemini plugin（推荐 `gemini@gemini-ccgx` fork，含 P-1..P-21 + W1/W2/I1 patch；或上游 `gemini@google-gemini` 配 repatch 脚本）→ 用 `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，含 P-1..P-21 + W1/W2/I1 patch；或上游 `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) 慢路径**，主线 `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）。
 
-   ⚠️ spec-research 命令在主线 context 内，**允许** `Agent(...)`——与 subagent "禁止嵌套 spawn" 约束不冲突。
+   ⚠️ spec-research 命令在主线 context 内执行，通道 A 走 Bash 直调（不再 spawn `Agent(...)`），无嵌套 spawn 顾虑。
 
    - **CRITICAL**: You MUST launch BOTH {{BACKEND_PRIMARY}} AND {{FRONTEND_PRIMARY}} in a SINGLE message with TWO parallel tool calls.
    - **DO NOT** call one model first and wait. Launch BOTH simultaneously.
@@ -79,102 +79,45 @@ description: '需求 → 约束集（并行探索 + OPSX 提案）'
    }
    ```
 
-   **Step 4.1**: In ONE message, spawn TWO models in parallel.
+   **Step 4.1**: In ONE message, spawn TWO Bash-direct helper calls in parallel.
 
-   **⚠ 预备动作（spawn 前必须执行）**：`codex:codex-rescue` / `gemini:gemini-rescue` 是 thin forwarder（一行 `Bash node companion.mjs task <prompt>` 转发），**不会**主动 Read 路径文件。主线必须在 spawn 前先 Read 两个角色提示词文件，把**内容**直接拼入下方 Agent prompt 的 `<role>` 块——不是写路径。
+   **通道 A — Bash 直调 plugin 快路径（默认）**：
 
-   - backend role: `Read("~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/analyzer.md")` → `${backendRole}`
-   - frontend role: `Read("~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/analyzer.md")` → `${frontendRole}`
+   > 占位符 `{{CODEX_BASH_TASK}}` / `{{GEMINI_BASH_TASK}}` 由 install 渲染为 `node <ccgx-call-plugin.mjs 绝对路径> <vendor> --json`。
+   > LLM 只需 Write tmpfile + 追加 `--prompt-file <tmpfile>` 运行，**不写 `Agent(...)`、不内联 role 全文**。
 
-   Prompt 结构按 `gpt-5-4-prompting` skill 推荐（XML 块、紧凑、操作性）：`<role>` + `<task>` + `<grounding_rules>` + `<structured_output_contract>`。
-
-   **通道 A — plugin spawn（默认）**：
+   **Step 4.1a — Write 两个 tmpfile**（≤2KB；让模型自己 Read 角色文件，避免内联 role 全文撞 argv 上限）：
+   ```
+   Write({ file_path: ".context/tmp/ccg-specresearch-codex-$JOB.txt", content: <下方任务模板（backend）> })
+   Write({ file_path: ".context/tmp/ccg-specresearch-gemini-$JOB.txt", content: <下方任务模板（frontend）> })
+   ```
 
-   **FIRST Agent call ({{BACKEND_PRIMARY}} — backend boundaries)**:
+   任务模板（backend 版；frontend 版把 backend→frontend、analyzer 路径换前端）：
    ```
-   Agent({
-     subagent_type: "codex:codex-rescue",
-     description: "spec-research: backend boundary exploration",
-     prompt: `<role>
-${backendRole}
-</role>
-
-<workdir>{{WORKDIR}}</workdir>
-
-<task>
-Explore backend context boundaries for <change description>:
-- Existing structures and patterns
-- Conventions in use
-- Hard constraints limiting solution space
-- Dependencies and risks
-</task>
-
-<grounding_rules>
-- Cite file:line for every claim about existing code
-- Mark hypotheses explicitly; don't state guesses as facts
-- If a question can't be answered from the repo, list it in open_questions
-</grounding_rules>
-
-<structured_output_contract>
-Return JSON ONLY (no preamble, no commentary):
-{
-  "module_name": "context boundary explored",
-  "existing_structures": ["key patterns found"],
-  "existing_conventions": ["standards in use"],
-  "constraints_discovered": ["hard constraints limiting solution space"],
-  "open_questions": ["ambiguities requiring user input"],
-  "dependencies": ["cross-module dependencies"],
-  "risks": ["potential blockers"],
-  "success_criteria_hints": ["observable success behaviors"]
-}
-Return ≤200 token structured summary.
-</structured_output_contract>`
-   })
+   # 任务：spec-research 边界探索
+
+   工作目录：{{WORKDIR}}（你已在此，可直接用 Bash/Read）
+   角色定义见 ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/analyzer.md，**先用 Read 工具读取该文件再开始**。
+   **必须前台执行，禁止 --background / --wait**（外层已 run_in_background，插件内再 background = 双重后台，stop-gate/status/cancel 全盲）。对文件系统零写入。
+
+   Explore backend context boundaries for <change description>:
+   - Existing structures and patterns / Conventions in use
+   - Hard constraints limiting solution space / Dependencies and risks
+   Cite file:line for every claim; mark hypotheses explicitly; list unanswerable questions in open_questions.
+
+   Return JSON ONLY:
+   { "module_name": "...", "existing_structures": [...], "existing_conventions": [...],
+     "constraints_discovered": [...], "open_questions": [...], "dependencies": [...],
+     "risks": [...], "success_criteria_hints": [...] }
    ```
 
-   **SECOND Agent call ({{FRONTEND_PRIMARY}} — frontend boundaries) - IN THE SAME MESSAGE**:
+   **Step 4.1b — 并行 Bash 直调**（同一 message，`run_in_background: true`；纯探索只读，加 `--no-write`）：
    ```
-   Agent({
-     subagent_type: "gemini:gemini-rescue",
-     description: "spec-research: frontend boundary exploration",
-     prompt: `<role>
-${frontendRole}
-</role>
-
-<workdir>{{WORKDIR}}</workdir>
-
-<task>
-Explore frontend context boundaries for <change description>:
-- Existing structures and patterns
-- Conventions in use
-- Hard constraints limiting solution space
-- Dependencies and risks
-</task>
-
-<grounding_rules>
-- Cite file:line for every claim about existing code
-- Mark hypotheses explicitly; don't state guesses as facts
-- If a question can't be answered from the repo, list it in open_questions
-</grounding_rules>
-
-<structured_output_contract>
-Return JSON ONLY (no preamble, no commentary):
-{
-  "module_name": "context boundary explored",
-  "existing_structures": ["key patterns found"],
-  "existing_conventions": ["standards in use"],
-  "constraints_discovered": ["hard constraints limiting solution space"],
-  "open_questions": ["ambiguities requiring user input"],
-  "dependencies": ["cross-module dependencies"],
-  "risks": ["potential blockers"],
-  "success_criteria_hints": ["observable success behaviors"]
-}
-Return ≤200 token structured summary.
-</structured_output_contract>`
-   })
+   Bash({ command: `{{CODEX_BASH_TASK}} --no-write --prompt-file .context/tmp/ccg-specresearch-codex-$JOB.txt`, description: "spec-research: backend (codex direct)", run_in_background: true })
+   Bash({ command: `{{GEMINI_BASH_TASK}} --no-write --prompt-file .context/tmp/ccg-specresearch-gemini-$JOB.txt`, description: "spec-research: frontend (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({
@@ -194,8 +137,8 @@ Return ≤200 token structured summary.
    > ⚠️ 通道 B `codeagent-wrapper` 已标 **deprecated**，仅为不能升级 plugin 的环境保留。
 
    **Step 4.2 (事件驱动)**：
-   - **通道 A（plugin）**：两个 Agent 同 message 内 spawn，主线接 ≤200 token 摘要。Agent 完成后自动返回结果到调用上下文，主线直接处理。
-   - **通道 B（BC wrapper）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在通知触发的新 turn 处理结果。**不调 TaskOutput**。两个 task 都收到通知后才进 step 4.3。
+   - **通道 A（Bash 直调快路径）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在新 turn Read stdout 后 `JSON.parse(stdout).text` 取真实输出。两个 task 都收到通知后才进 step 4.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/spec-review.md

@@ -28,142 +28,57 @@ description: '双模型交叉审查（独立工具，随时可用）'
 
    **调用通道路由（CCG codeagent 退役，v2.2.0+）**
 
-   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 plugin spawn：
+   双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 Bash 直调 plugin 快路径：
 
-   1. **优先 plugin spawn**（默认）：装了 `codex@openai-codex` + gemini plugin（推荐 `gemini@gemini-ccgx` fork；或上游 `gemini@google-gemini` 配 repatch 脚本）→ 用 `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）。
 
-   ⚠️ spec-review 命令在主线 context 内，**允许** `Agent(...)`——与 subagent "禁止嵌套 spawn" 约束不冲突。
+   ⚠️ spec-review 命令在主线 context 内执行，通道 A 走 Bash 直调（不再 spawn `Agent(...)`），无嵌套 spawn 顾虑；本路径输出直接落地（advance/revise verdict），Bash 直调消除 sonnet wrapper silent-fallback 风险。
 
    - **CRITICAL**: You MUST launch BOTH {{BACKEND_PRIMARY}} AND {{FRONTEND_PRIMARY}} in a SINGLE message with TWO parallel tool calls.
    - **DO NOT** call one model first and wait. Launch BOTH simultaneously.
    - **工作目录**：`{{WORKDIR}}` **必须通过 Bash 执行 `pwd`（Unix）或 `cd`（Windows CMD）获取当前工作目录的绝对路径**，禁止从 `$HOME` 或环境变量推断。如果用户通过 `/add-dir` 添加了多个工作区，先确定任务相关的工作区。
 
-   **Step 3.1**: In ONE message, spawn TWO models in parallel.
+   **Step 3.1**: In ONE message, spawn TWO Bash-direct helper calls in parallel.
 
-   **⚠ 预备动作（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}}/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` 读 proposal 变更。
 
-   Prompt 结构按 `gpt-5-4-prompting` skill 推荐（review 类任务额外加 `<grounding_rules>` + `<dig_deeper_nudge>`）。
-
-   **通道 A — plugin spawn（默认）**：
+   **Step 3.1a — Write 两个 tmpfile**（≤2KB）：
+   ```
+   Write({ file_path: ".context/tmp/ccg-specreview-codex-$JOB.txt", content: <backend review 模板> })
+   Write({ file_path: ".context/tmp/ccg-specreview-gemini-$JOB.txt", content: <frontend review 模板> })
+   ```
 
-   **FIRST Agent call ({{BACKEND_PRIMARY}})**:
+   backend review 模板：
    ```
-   Agent({
-     subagent_type: "codex:codex-rescue",
-     description: "spec-review: backend/logic review",
-     prompt: `<role>
-${backendRole}
-</role>
-
-<workdir>{{WORKDIR}}</workdir>
-
-<task>
-Review proposal <proposal_id> implementation along backend dimensions:
-1. Spec Compliance — Verify ALL constraints from spec are satisfied
-2. PBT Properties — Check invariants, idempotency, bounds correctly implemented
-3. Logic Correctness — Edge cases, error handling, algorithm correctness
-4. Backend Security — Injection vulnerabilities, auth checks, input validation
-5. Regression Risk — Interface compatibility, type safety, breaking changes
-
-Read-only review. Do NOT modify any file.
-</task>
-
-<grounding_rules>
-- Every finding must cite file:line
-- If a constraint was satisfied, list it in passed_checks (don't omit positives)
-- "I couldn't verify X" is acceptable; fabricating X is not
-- Distinguish bug (observable failure path) from concern (style/maintainability preference)
-</grounding_rules>
-
-<dig_deeper_nudge>
-- For each Critical finding, check whether the same root cause appears elsewhere in the diff
-- Prefer one well-cited Critical over five vague Warnings
-</dig_deeper_nudge>
-
-<structured_output_contract>
-Return JSON ONLY (no preamble):
-{
-  "findings": [
-    {
-      "severity": "Critical|Warning|Info",
-      "dimension": "spec_compliance|pbt|logic|security|regression",
-      "file": "path/to/file.ts",
-      "line": 42,
-      "description": "What is wrong",
-      "constraint_violated": "Constraint ID from spec (if applicable)",
-      "fix_suggestion": "How to fix"
-    }
-  ],
-  "passed_checks": ["List of verified constraints/properties"],
-  "summary": "Overall assessment"
-}
-Return ≤200 token structured summary.
-</structured_output_contract>`
-   })
+   # 任务：spec-review 后端/逻辑审查
+
+   工作目录：{{WORKDIR}}（你已在此）
+   角色定义见 ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md，**先用 Read 工具读取再开始**。
+   **必须前台执行，禁止 --background / --wait**（外层已 run_in_background，插件内再 background = 双重后台，stop-gate/status/cancel 全盲）。只读审查，不修改任何文件。
+
+   自己跑 `git diff` 读 proposal <proposal_id> 实现。沿后端维度审：
+   1. Spec Compliance  2. PBT 不变量/幂等/边界  3. 逻辑正确性/边界/错误处理  4. 后端安全（注入/鉴权/输入校验）  5. 回归风险（接口兼容/类型安全/breaking）
+   每个 finding 必引 file:line；满足的约束列 passed_checks；无法验证如实说，禁止编造；区分 bug 与 concern。
+   Return JSON ONLY:
+   { "findings": [{ "severity":"Critical|Warning|Info","dimension":"spec_compliance|pbt|logic|security|regression","file":"...","line":42,"description":"...","constraint_violated":"...","fix_suggestion":"..." }],
+     "passed_checks": ["..."], "summary": "..." }
    ```
 
-   **SECOND Agent call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
+   frontend review 模板（角色换 {{FRONTEND_PRIMARY}}/reviewer.md，同硬约束；维度=Pattern 一致性/可维护性/集成风险/前端安全(XSS/CSRF/敏感数据)/Spec 意图对齐；dimension 枚举 patterns|maintainability|integration|security|alignment，字段含 spec_reference）。
+
+   **Step 3.1b — 并行 Bash 直调**（同一 message，`run_in_background: true`；只读审查，加 `--no-write`）：
    ```
-   Agent({
-     subagent_type: "gemini:gemini-rescue",
-     description: "spec-review: patterns/integration review",
-     prompt: `<role>
-${frontendRole}
-</role>
-
-<workdir>{{WORKDIR}}</workdir>
-
-<task>
-Review proposal <proposal_id> implementation along frontend/integration dimensions:
-1. Pattern Consistency — Naming conventions, code style, project patterns
-2. Maintainability — Readability, complexity, documentation adequacy
-3. Integration Risk — Dependency changes, cross-module impacts
-4. Frontend Security — XSS, CSRF, sensitive data exposure
-5. Spec Alignment — Implementation matches spec intent (not just letter)
-
-Read-only review. Do NOT modify any file.
-</task>
-
-<grounding_rules>
-- Every finding must cite file:line
-- If an aspect was clean, list it in passed_checks
-- "I couldn't verify X" is acceptable; fabricating X is not
-</grounding_rules>
-
-<dig_deeper_nudge>
-- For each Critical finding, check whether the same pattern issue appears in adjacent files
-- Prefer one well-cited Critical over five vague Warnings
-</dig_deeper_nudge>
-
-<structured_output_contract>
-Return JSON ONLY (no preamble):
-{
-  "findings": [
-    {
-      "severity": "Critical|Warning|Info",
-      "dimension": "patterns|maintainability|integration|security|alignment",
-      "file": "path/to/file.ts",
-      "line": 42,
-      "description": "What is wrong",
-      "spec_reference": "Spec section (if applicable)",
-      "fix_suggestion": "How to fix"
-    }
-  ],
-  "passed_checks": ["List of verified aspects"],
-  "summary": "Overall assessment"
-}
-Return ≤200 token structured summary.
-</structured_output_contract>`
-   })
+   Bash({ command: `{{CODEX_BASH_TASK}} --no-write --prompt-file .context/tmp/ccg-specreview-codex-$JOB.txt`, description: "spec-review: backend (codex direct)", run_in_background: true })
+   Bash({ command: `{{GEMINI_BASH_TASK}} --no-write --prompt-file .context/tmp/ccg-specreview-gemini-$JOB.txt`, description: "spec-review: frontend (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({
@@ -183,8 +98,8 @@ Return ≤200 token structured summary.
    > ⚠️ 通道 B `codeagent-wrapper` 已标 **deprecated**，仅为不能升级 plugin 的环境保留。
 
    **Step 3.2 (事件驱动)**：
-   - **通道 A（plugin）**：两个 Agent 同 message 内 spawn，主线接 ≤200 token 摘要。Agent 完成后自动返回结果。
-   - **通道 B（BC wrapper）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在通知触发的新 turn 处理结果。**不调 TaskOutput**。两个 task 都收到通知后才进 step 3.3。
+   - **通道 A（Bash 直调快路径）**：spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在新 turn Read stdout 后 `JSON.parse(stdout).text` 取真实输出。两个 task 都收到通知后才进 step 3.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/status.md

@@ -23,6 +23,7 @@ phase-runner 走 Bash subprocess（`claude -p --output-format stream-json ...`
 | 文件 | 写者 | 内容 |
 |------|------|------|
 | `state.json` | 主线 / phase-runner | `{ task_id, kind, status, phase_id, started_at, last_update, summary, cancel_requested }` |
+| `state.json`（workflow 模式增量） | autonomous 主线 | 追加 `workflow_run_id` / `run_mode: 'workflow'` 字段；此模式 progress.jsonl 由 phase-runner 逐 phase append `{"type":"phase-result","phase_id":...,"status":...}` 行，dashboard / tail 模式兼容 |
 | `progress.jsonl` | phase-runner Bash subprocess | stream-json ndjson（D6） |
 | `result.md` | phase-runner | ≤ 200 token 摘要 |
 | `cancel.flag` | `/ccg:cancel` 或 `/ccg:status --cancel` | 协作退出哨兵 |