ccgx-workflow 1.0.0

package/templates/commands/review.md

@@ -0,0 +1,338 @@
+---
+description: '多模型代码审查：无参数时自动审查 git diff，双模型交叉验证；--adversarial 加敌对审查；--fix 闭环修复'
+argument-hint: "[代码或描述] [--adversarial] [--fix [--all] [--auto]] [--role=architect|critic|implementer|tester|writer]"
+---
+
+# Review - 多模型代码审查
+
+## Role-based routing（v4.1 specialist matrix）
+
+可选 `--role=<name>` 叠加 role 维度路由：
+
+| Role × Layer  | architect      | critic              | implementer | tester        | writer          |
+| ------------- | -------------- | ------------------- | ----------- | ------------- | --------------- |
+| **backend**   | codex/architect.md | codex/reviewer.md (adversarial) | codex/architect.md | codex/tester.md | claude（主线）  |
+| **frontend**  | gemini/architect.md | gemini/reviewer.md (adversarial) | gemini/architect.md | gemini/tester.md | gemini/analyzer.md |
+| **fullstack** | codex+gemini/architect.md | both reviewer.md (adversarial) | runner 决 | runner 决 | claude |
+
+**未传 --role 时按 v4.0 双模型路由（{{BACKEND_PRIMARY}}/{{FRONTEND_PRIMARY}} reviewer.md）**——完全兼容现有 `--adversarial` / `--fix` 行为。`--role=critic` 等价于隐式 `--adversarial`（语义同义）。详见 `src/utils/specialist-router.ts`。
+
+---
+
+双模型并行审查，交叉验证综合反馈。无参数时自动审查当前 git 变更。
+
+**v4.1 Phase 20**：双模型并行通道从 `Bash(codeagent-wrapper)` **默认切换**为 plugin spawn —— 装了 `codex@openai-codex` + `gemini@google-gemini` plugin → 用 `Agent(subagent_type="codex:codex-rescue")` + `Agent(subagent_type="gemini:gemini-rescue")` 并行，主线只接 ≤200 token 摘要；plugin 未装 → fallback 到 codeagent-wrapper 路径（v4.0 BC，将在 v5.0 移除）。preflight 用 `Bash` 跑 `ls ~/.claude/plugins/` 检测，helper 见 `src/utils/plugin-detection.ts`。
+
+`--adversarial` 模式下额外触发第三层"敌对视角"审查，由官方 codex plugin 的 `Agent(codex:codex-rescue)` 在 fresh context 中专门挑前两轮意见的漏洞，适合极重要 PR / 安全敏感变更。需用户已装 `codex@openai-codex` plugin，否则降级为双模型审查。
+
+`--fix` 模式下额外触发**闭环修复**：审查产出 REVIEW.md 后 spawn `code-fixer` subagent 在 git worktree 隔离环境内修复 finding，原子 commit 后透明 ff-only merge 回主分支。
+
+## 使用方法
+
+```bash
+/review [代码或描述] [--adversarial] [--fix [--all] [--auto]]
+```
+
+- **无参数**：自动审查 `git diff HEAD`
+- **有参数**：审查指定代码或描述
+- **`--adversarial`**：双模型审查后追加 fresh-context 敌对审查（用 `Agent(subagent_type="codex:codex-rescue")` + `--adversarial-review`），主线 token 不被吃，3-5 分钟额外时间换更深的反向意见
+- **`--fix`**：审查后 spawn `code-fixer` 修复 Critical + Warning 级 finding，worktree 隔离 + 3 层 verification + 原子 commit
+- **`--fix --all`**：同上但纳入 Info 级 finding（默认不修 Info，避免噪音）
+- **`--fix --auto`**：fix → re-review → fix 多轮收敛环，**上限 3 轮**（CCG 硬规约）。3 轮未收敛升级用户介入
+
+---
+
+## 多模型调用规范
+
+**工作目录**：
+- `{{WORKDIR}}`：**必须通过 Bash 执行 `pwd`（Unix）或 `cd`（Windows CMD）获取当前工作目录的绝对路径**，禁止从 `$HOME` 或环境变量推断
+- 如果用户通过 `/add-dir` 添加了多个工作区，先用 Glob/Grep 确定任务相关的工作区
+- 如果无法确定，用 `AskUserQuestion` 询问用户选择目标工作区
+
+**调用语法**（v4.4.2 起 review/verify 路径默认走 Bash 直调）：
+
+**通道 A — Bash 直调 plugin script（v4.4.2 默认，绕开 sonnet wrapper）**：
+
+```
+Bash({
+  command: `node "$(ls ~/.claude/plugins/cache/openai-codex/codex/*/scripts/codex-companion.mjs | head -1)" task -p "<整段 prompt 含 ROLE_FILE + TASK + OUTPUT 要求>" --json`,
+  description: "Review: backend (codex direct)",
+  run_in_background: true,
+  timeout: 3600000
+})
+
+Bash({
+  command: `node "$(ls ~/.claude/plugins/cache/google-gemini/gemini/*/scripts/gemini-companion.mjs | head -1)" task -p "<整段 prompt>" --json`,
+  description: "Review: frontend (gemini direct)",
+  run_in_background: true,
+  timeout: 3600000
+})
+```
+
+⛔ **不要**用 `Agent(subagent_type="codex:codex-rescue"|"gemini:gemini-rescue")` —— plugin spawn 走 sonnet wrapper，broker 故障/CLI 空答时 wrapper 可能 silent fallback 自答冒充 cross-vendor 视角（v4.4.2 hotfix 决策，详见 `src/utils/verify-orchestrator.ts:planVerifyWave` `useDirectBashInvocation` 选项）。
+
+主线接 stdout JSON（5-50KB），按 plugin --json schema 解析 `result.text` 字段，失败信号：
+- exit code ≠ 0 → loud fail，触发 v1.7.87 标准 2-retry / 5s / 3-attempts 规则
+- stdout 空 / 字节 < 100 → 同上视为失败
+
+并行**两个 Bash 在同一 message 内 `run_in_background: true` 同时 spawn**。
+
+**通道 B — codeagent-wrapper fallback**（plugin 未装时降级，并行用 `run_in_background: true`）：
+
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend <{{BACKEND_PRIMARY}}|{{FRONTEND_PRIMARY}}> {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'
+ROLE_FILE: <角色提示词路径>
+<TASK>
+审查以下代码变更：
+<git diff 内容>
+</TASK>
+OUTPUT: 按 Critical/Major/Minor/Suggestion 分类列出问题
+EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "简短描述"
+})
+```
+
+> ⚠️ 通道 B `codeagent-wrapper` 在 v4.1 已标 **deprecated**，将在 v5.0 移除。
+
+**角色提示词**：
+
+| 模型 | 提示词 |
+|------|--------|
+| 后端 | `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md` |
+| 前端 | `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md` |
+
+**并行调用 + 事件驱动等待（v4.5.2 起）**：
+
+1. 在同一 message 内 spawn 两个（或多个）`Bash(run_in_background: true)` 并行任务
+2. spawn 完成后主线说明已启动哪些 task（含 task-id），然后**直接 turn end**，**不调 TaskOutput**
+3. Claude Code 引擎在每个 background task 完成时自动发 `<task-notification>` system-reminder 触发主线新 turn
+4. 主线在收到通知的新 turn 处理：
+   - 从 notification `<task-id>` 定位是哪个任务
+   - 从 `<output-file>` 路径 read stdout（plugin --json 输出 5-50KB）
+   - JSON parse `result.text` 字段（plugin 通道）/ `--progress` 行（codeagent-wrapper 通道）
+5. **必须等所有相关 task 都收到通知**才进入下一阶段（主线按 task-id 计数已收齐）
+
+⛔ **禁止做**：
+- 调 `TaskOutput({block: true, timeout: 600000})` —— 这会 freeze 主线 10 分钟，且超时后还要轮询，体验极差（v4.5.1 之前的旧模式，已废弃）
+- 收到部分通知就跳过等其他模型
+- 主动 Kill task
+
+⚠️ **失败处理**：
+- notification `status: failed` / exit code ≠ 0 / stdout < 100 字节 / JSON parse 失败 → 视为失败
+- v1.7.87 标准 2-retry / 5s / 3-attempts 规则
+- 3 次全失败才考虑降级到单模型继续
+
+---
+
+## 执行工作流
+
+### 🔍 阶段 1：获取待审查代码
+
+`[模式：研究]`
+
+**无参数时**：执行 `git diff HEAD` 和 `git status --short`
+
+**有参数时**：使用指定的代码/描述
+
+调用 `{{MCP_SEARCH_TOOL}}` 获取相关上下文。
+
+### 🔬 阶段 2：并行审查
+
+`[模式：审查]`
+
+**⚠️ 必须发起两个并行 Bash 调用**（参照上方调用规范）：
+
+1. **{{BACKEND_PRIMARY}} 后端审查**：`Bash({ command: "...--backend {{BACKEND_PRIMARY}}...", run_in_background: true })`
+   - ROLE_FILE: `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md`
+   - 需求：审查代码变更（git diff 内容）
+   - OUTPUT：按 Critical/Major/Minor/Suggestion 分类列出安全性、性能、错误处理问题
+
+2. **{{FRONTEND_PRIMARY}} 前端审查**：`Bash({ command: "...--backend {{FRONTEND_PRIMARY}}...", run_in_background: true })`
+   - ROLE_FILE: `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md`
+   - 需求：审查代码变更（git diff 内容）
+   - OUTPUT：按 Critical/Major/Minor/Suggestion 分类列出可访问性、响应式、设计一致性问题
+
+**事件驱动等待**：spawn 完两个 Bash bg 后主线 turn end，等 task-notification 自动唤醒。两个 task 都收到通知后进阶段 3。
+
+**务必遵循上方 `多模型调用规范` 的 `重要` 指示**
+
+### 🛡 阶段 2.5：敌对审查（仅 `--adversarial`）
+
+`[模式：敌对]`
+
+**仅当 `$ARGUMENTS` 含 `--adversarial` 字面量时启动**。否则跳过本阶段。
+
+调用方式（v4.4.2 起 Bash 直调，绕开 sonnet wrapper）：
+
+```
+Bash({
+  command: `node "$(ls ~/.claude/plugins/cache/openai-codex/codex/*/scripts/codex-companion.mjs | head -1)" task -p "--adversarial-review
+
+请对以下代码变更进行敌对视角审查：
+
+<git diff 内容（与阶段 2 同输入）>
+
+已有的前两轮审查意见（仅供你判断哪些被低估，不要重复结论）：
+
+<阶段 2 后端审查结果摘要>
+
+<阶段 2 前端审查结果摘要>
+
+你的任务：
+1. 找出前两轮**未发现或低估**的安全/性能/正确性漏洞
+2. 假设代码作者刻意误导，挑刺
+3. 输出格式：[Critical-Adversarial] / [Major-Adversarial] 列表，每条标'为什么前两轮没发现'" --json`,
+  description: "Adversarial review (codex direct)",
+  run_in_background: true,
+  timeout: 3600000
+})
+```
+
+⛔ 不用 `Agent(subagent_type="codex:codex-rescue")` —— v4.4.2 决策：review/verify 路径绕开 sonnet wrapper，避免 silent fallback 冒充 adversarial 视角。
+
+收到 stdout JSON 后解析 `result.text` 字段保留待阶段 3 综合。stdout 空或 exit≠0 → 走标准 2-retry 规则。
+
+**降级**：若 `codex:codex-rescue` 不可用（用户没装 `codex@openai-codex` plugin），输出"⚠️ 跳过敌对审查，未检测到 codex plugin"并继续阶段 3，不阻塞流程。
+
+### 🔀 阶段 3：综合反馈
+
+`[模式：综合]`
+
+1. 收集**所有**审查结果（双模型 + 可选的敌对审查）
+2. 按严重程度分类：Critical / Major / Minor / Suggestion
+3. 去重合并 + 交叉验证
+4. **敌对审查标识**：来自阶段 2.5 的 finding 在最终报告中带 🛡 标记，并保留"前两轮没发现"的原因说明（这是用户判断敌对审查 ROI 的依据）
+
+### 📊 阶段 4：呈现审查结果
+
+`[模式：总结]`
+
+```markdown
+## 📋 代码审查报告
+
+### 审查范围
+- 变更文件：<数量> | 代码行数：+X / -Y
+- 审查模式：双模型 / 双模型 + 🛡 敌对审查
+
+### 关键问题 (Critical)
+> 必须修复才能合并
+1. <问题描述> - [后端/前端模型]
+2. 🛡 <问题描述> - [敌对审查] · 前两轮未发现：<原因>
+
+### 主要问题 (Major) / 次要问题 (Minor) / 建议 (Suggestions)
+...
+
+### 总体评价
+- 代码质量：[优秀/良好/需改进]
+- 是否可合并：[是/否/需修复后]
+- 敌对审查 ROI：[N 个新发现 / 0 个新发现，下次可省略] (仅 --adversarial 模式)
+```
+
+---
+
+## 关键规则
+
+1. **无参数 = 审查 git diff** – 自动获取当前变更
+2. **双模型交叉验证** – 后端问题以 {{BACKEND_PRIMARY}} 为准，前端问题以 {{FRONTEND_PRIMARY}} 为准
+3. 外部模型对文件系统**零写入权限**
+
+---
+
+## 🔧 阶段 5：闭环修复（仅 `--fix` / `--fix --all` / `--fix --auto`）
+
+`[模式：修复]`
+
+**仅当 `$ARGUMENTS` 含 `--fix` 字面量时启动**。否则跳过本阶段。
+
+### 5.1 启动恢复扫描
+
+在创建新 worktree **前**：
+
+```bash
+# 检查上次 review-fix 是否被中断（OOM / 重启 / Ctrl-C）
+cat .context/review-fix-recovery-pending.json 2>/dev/null
+```
+
+存在 → 上一次跑被中断。`AskUserQuestion`：复用 / 强制清理。
+
+### 5.2 持久化 REVIEW.md
+
+把阶段 4 的综合审查结果写到 `.context/review-{timestamp}/REVIEW.md`（path 由 code-fixer 通过参数接收），格式：
+
+```markdown
+## Findings
+
+| ID | Severity | File | Line | Description | Suggested Fix |
+|----|----------|------|------|-------------|---------------|
+| C-01 | Critical | src/auth.ts | 42 | SQL identifier not escaped | use parameterized query |
+| W-02 | Warning | src/api.ts | 88 | missing error boundary | wrap in try/catch |
+| ...
+```
+
+`--fix --all` 模式下额外含 Info 级 finding。
+
+### 5.3 Spawn code-fixer subagent
+
+```
+Agent({
+  subagent_type: "code-fixer",
+  description: "Closed-loop review fix",
+  prompt: `请按以下契约执行闭环修复：
+
+review_md_path: <REVIEW.md 路径>
+phase_id: <padded phase 号，例 "10"，没有 phase 上下文则用 "00">
+base_sha: <当前 HEAD 的 sha>
+current_branch: <当前分支名>
+workdir: <项目绝对路径>
+fix_scope: critical_warning | all | auto
+auto_round: <仅 --auto 模式，当前轮次 1-indexed>
+
+工程契约见 templates/commands/agents/code-fixer.md：
+- 强制 git worktree 隔离 + recovery sentinel
+- 4 步严格顺序 transactional cleanup tail
+- per-finding rollback 用 git checkout（不用 Write 工具）
+- 3 层 verification Tier
+- 每 finding 原子 commit
+`
+})
+```
+
+**code-fixer 完成后产出**：`REVIEW-FIX.md`（同目录），含 per-finding outcome + cleanup tail 状态。
+
+### 5.4 多轮收敛（仅 `--fix --auto`）
+
+`--auto` 模式下，code-fixer 第 1 轮跑完后：
+
+1. Read REVIEW-FIX.md，提取本轮 finding 数（critical / warning / info）
+2. 调用收敛判定（参考 `src/utils/code-fixer-worktree.ts:decideConverge`）：
+   - `converged`（critical+warning=0）→ 完成，输出收敛报告
+   - `escalate`（达到 3 轮 cap 或 stall）→ `AskUserQuestion`："继续手动修 / 接受现状 / 回滚全部"
+   - `continue` → 重跑阶段 1-4 生成新 REVIEW.md，再 spawn code-fixer，`auto_round` +1
+
+**3 轮上限是 CCG 硬规约**（与 plan-checker / verify-work 一致），**禁止**绕过。
+
+### 5.5 闭环修复总结
+
+```markdown
+## 🔧 闭环修复总结
+
+- 修复模式：`--fix` / `--fix --all` / `--fix --auto`
+- 修复轮次：<N> / 3
+- Findings 处理：<M>（Critical: <a> / Warning: <b> / Info: <c>）
+- Atomic commits: <K>
+- Worktree cleanup: ok / partial（merge 失败保留 worktree 待人工）
+- 需人工核实的逻辑修复：<L> 项（标记 `requires human verification`）
+```
+
+### 关键安全约束
+
+⚠️ **以下违反任意一条 = 工程事故**：
+
+- worktree 创建 **必须** 在写 sentinel 之前
+- cleanup tail 4 步**必须**严格按 `merge_ff_only → worktree_remove → branch_delete → sentinel_remove` 顺序
+- 任何步骤失败**必须**立即停（不继续后续步骤）
+- per-finding rollback **必须**用 `git checkout --`，**禁止**用 Write 工具
+- `--auto` 收敛轮次**必须** ≤ 3

package/templates/commands/rollback.md

@@ -0,0 +1,116 @@
+---
+description: '交互式 Git 回滚：安全回滚分支到历史版本，支持 reset/revert 模式'
+---
+
+# Rollback - 交互式 Git 回滚
+
+安全地将分支回滚到指定历史版本，默认 dry-run 模式。
+
+## 使用方法
+
+```bash
+/rollback [options]
+```
+
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `--branch <branch>` | 要回滚的分支 |
+| `--target <rev>` | 目标版本（commit/tag/reflog） |
+| `--mode reset\|revert` | 回滚模式 |
+| `--depth <n>` | 列出最近 n 个版本（默认 20） |
+| `--dry-run` | 只预览，不执行（**默认**） |
+| `--yes` | 跳过确认直接执行 |
+
+---
+
+## 执行工作流
+
+### 🔍 阶段 1：同步远端
+
+`[模式：准备]`
+
+```bash
+git fetch --all --prune
+```
+
+### 📋 阶段 2：选择分支
+
+`[模式：选择]`
+
+1. 列出本地 + 远端分支
+2. 过滤受保护分支
+3. 用户选择或使用 `--branch` 参数
+
+### 📜 阶段 3：选择版本
+
+`[模式：选择]`
+
+1. 显示最近 N 个版本（`git log --oneline`）
+2. 显示相关 tags（`git tag --merged`）
+3. 用户选择或使用 `--target` 参数
+
+### ⚙️ 阶段 4：选择模式
+
+`[模式：决策]`
+
+| 模式 | 说明 | 推送方式 |
+|------|------|----------|
+| `reset` | 硬回滚，改变历史 | `--force-with-lease` |
+| `revert` | 生成反向提交，保留历史 | 普通 push |
+
+### ⛔ 阶段 5：最终确认
+
+`[模式：确认]`
+
+显示即将执行的命令，等待用户确认（除非 `--yes`）。
+
+### ✅ 阶段 6：执行回滚
+
+`[模式：执行]`
+
+**reset 模式**：
+```bash
+git switch <branch>
+git reset --hard <target>
+```
+
+**revert 模式**：
+```bash
+git switch <branch>
+git revert --no-edit <target>..HEAD
+```
+
+---
+
+## 安全护栏
+
+1. **备份**：执行前自动记录当前 HEAD 到 reflog
+2. **保护分支**：`main`/`master`/`production` 需额外确认
+3. **dry-run 默认**：防止误操作
+4. **禁止 --force**：如需强推，手动执行
+
+---
+
+## 示例
+
+```bash
+# 全交互模式（dry-run）
+/rollback
+
+# 指定分支
+/rollback --branch dev
+
+# 完整指定，一键执行
+/rollback --branch main --target v1.2.0 --mode reset --yes
+
+# 生成反向提交
+/rollback --branch release/v2.1 --target v2.0.5 --mode revert
+```
+
+## 注意事项
+
+- **reset vs revert**：reset 改变历史，需强推；revert 更安全
+- **LFS/子模块**：回滚前确保状态一致
+- **CI 触发**：回滚后可能自动触发流水线

package/templates/commands/spec-impl.md

@@ -0,0 +1,139 @@
+---
+description: '按规范执行 + 多模型协作 + 归档'
+---
+<!-- CCG:SPEC:IMPL:START -->
+**Core Philosophy**
+- Implementation is pure mechanical execution—all decisions were made in Plan phase.
+- External model outputs are prototypes only; must be rewritten to production-grade code.
+- Keep changes tightly scoped; enforce side-effect review before any modification.
+- Minimize documentation—prefer self-explanatory code over comments.
+
+**Guardrails**
+- **NEVER** apply 后端/前端模型 prototypes directly—all outputs are reference only.
+- **MANDATORY**: Request `unified diff patch` format from external models; they have zero write permission.
+- Keep implementation strictly within `tasks.md` scope—no scope creep.
+- Refer to `openspec/config.yaml` for conventions.
+- **USER GUIDANCE RULE**: When suggesting next steps to the user, ALWAYS use CCG commands (`/ccg:spec-research`, `/ccg:spec-plan`, `/ccg:spec-impl`, `/ccg:spec-review`). NEVER suggest `/opsx:*` commands to the user. If OpenSpec CLI returns error messages referencing OPSX skills, translate them to CCG equivalents.
+- **TASKS FORMAT RULE**: When generating or modifying `tasks.md`, ALL tasks MUST use checkbox format (`- [ ] X.Y description`). Heading+bullet format will cause OpenSpec CLI to parse 0 tasks and block the workflow.
+
+**Steps**
+1. **Select Change**
+   - Run `openspec list --json` to inspect Active Changes.
+   - Confirm with user which change ID to implement.
+   - Run `openspec status --change "<change_id>" --json` to review tasks.
+
+2. **Apply OPSX Change (Pre-flight Check)**
+   - Call `/opsx:apply` internally to enter implementation mode:
+     ```
+     /opsx:apply
+     ```
+   - This will load the change context and guide you through the tasks defined in `tasks.md`.
+   - **Note**: This is an internal call. If this step fails, guide the user to re-run `/ccg:spec-impl`.
+   - **HARD GATE**: Check the returned `state` field:
+     - If `state: "blocked"` → STOP immediately. Inform the user which artifacts are missing and suggest: "Run `/ccg:spec-plan` to generate missing artifacts first."
+     - If `progress.total === 0` → STOP immediately. Inform: "tasks.md has no parseable tasks. Run `/ccg:spec-plan` to regenerate."
+     - Only proceed to Step 3 when `state: "ready"` and `progress.total > 0`.
+
+3. **Identify Minimal Verifiable Phase**
+   - Review `tasks.md` and identify the **smallest verifiable phase**.
+   - Do NOT complete all tasks at once—control context window.
+   - Announce: "Implementing Phase X: [task group name]"
+
+4. **Route Tasks to Appropriate Model**
+   - **Route A: {{FRONTEND_PRIMARY}}** — Frontend/UI/styling (CSS, React, Vue, HTML, components)
+   - **Route B: {{BACKEND_PRIMARY}}** — Backend/logic/algorithm (API, data processing, business logic)
+
+   **工作目录**：`{{WORKDIR}}` **必须通过 Bash 执行 `pwd`（Unix）或 `cd`（Windows CMD）获取当前工作目录的绝对路径**，禁止从 `$HOME` 或环境变量推断。如果用户通过 `/add-dir` 添加了多个工作区，先确定任务相关的工作区。
+
+   For each task:
+   ```
+   codeagent-wrapper --progress --backend <{{BACKEND_PRIMARY}}|{{FRONTEND_PRIMARY}}> {{GEMINI_MODEL_FLAG}}- "{{WORKDIR}}" <<'EOF'
+   TASK: <task description from tasks.md>
+   CONTEXT: <relevant code context>
+   CONSTRAINTS: <constraints from spec>
+   OUTPUT: Unified Diff Patch format ONLY
+   EOF
+   ```
+
+   **会话复用**：保存返回的 `SESSION_ID:`（{{BACKEND_PRIMARY}} → `CODEX_PROTO_SESSION`，{{FRONTEND_PRIMARY}} → `GEMINI_PROTO_SESSION`），Step 7 审查时复用。
+
+5. **Rewrite Prototype to Production Code**
+   Upon receiving diff patch, **NEVER apply directly**. Rewrite by:
+   - Removing redundancy
+   - Ensuring clear naming and simple structure
+   - Aligning with project style
+   - Eliminating unnecessary comments
+   - Verifying no new dependencies introduced
+
+6. **Side-Effect Review** (Mandatory before apply)
+   Verify the change:
+   - [ ] Does not exceed `tasks.md` scope
+   - [ ] Does not affect unrelated modules
+   - [ ] Does not introduce new dependencies
+   - [ ] Does not break existing interfaces
+
+   If issues found, make targeted corrections.
+
+7. **Multi-Model Review (PARALLEL)**
+   - **CRITICAL**: You MUST launch BOTH {{BACKEND_PRIMARY}} AND {{FRONTEND_PRIMARY}} in a SINGLE message with TWO Bash tool calls.
+   - **DO NOT** call one model first and wait. Launch BOTH simultaneously with `run_in_background: true`.
+
+   **Step 7.1**: In ONE message, make TWO parallel Bash calls:
+
+   **FIRST Bash call ({{BACKEND_PRIMARY}})**:
+   ```
+   Bash({
+     command: "~/.claude/bin/codeagent-wrapper --progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}resume <CODEX_PROTO_SESSION> - \"{{WORKDIR}}\" <<'EOF'\nReview the implementation changes:\n- Correctness: logic errors, edge cases\n- Security: injection, auth issues\n- Spec compliance: constraints satisfied\nOUTPUT: JSON with findings\nEOF",
+     run_in_background: true,
+     timeout: 300000,
+     description: "{{BACKEND_PRIMARY}}: correctness/security review"
+   })
+   ```
+
+   **SECOND Bash call ({{FRONTEND_PRIMARY}}) - IN THE SAME MESSAGE**:
+   ```
+   Bash({
+     command: "~/.claude/bin/codeagent-wrapper --progress --backend {{FRONTEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}resume <GEMINI_PROTO_SESSION> - \"{{WORKDIR}}\" <<'EOF'\nReview the implementation changes:\n- Maintainability: readability, complexity\n- Patterns: consistency with project style\n- Integration: cross-module impacts\nOUTPUT: JSON with findings\nEOF",
+     run_in_background: true,
+     timeout: 300000,
+     description: "{{FRONTEND_PRIMARY}}: maintainability/patterns review"
+   })
+   ```
+
+   **Step 7.2 (v4.5.2 事件驱动)**: spawn 两个 Bash bg 后说明 task-id 然后 **turn end**。引擎在每个 task 完成时自动发 `<task-notification>`，主线在通知触发的新 turn 处理结果。**不调 TaskOutput**。两个 task 都收到通知后才进 step 7.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 次全失败才降级单模型。
+
+   Address any critical findings before proceeding.
+
+8. **Update Task Status**
+   - Mark completed task in `tasks.md`: `- [x] Task description`
+   - Commit changes if appropriate.
+
+9. **Context Checkpoint**
+   - After completing a phase, report context usage.
+   - If below 80K: Ask user "Continue to next phase?"
+   - If approaching 80K: Suggest "Run `/clear` and resume with `/ccg:spec:impl`"
+
+10. **Archive on Completion**
+    - When ALL tasks in `tasks.md` are marked `[x]`:
+    - Call `/opsx:archive` internally to archive the change:
+      ```
+      /opsx:archive
+      ```
+    - This merges spec deltas to `openspec/specs/` and moves change to archive.
+    - **Note**: This is an internal call. If archiving fails, guide the user to re-run `/ccg:spec-impl`.
+
+**Reference**
+- Check task status: `openspec status --change "<id>" --json`
+- View active changes: `openspec list --json`
+- Search existing patterns: `rg -n "function|class" <file>`
+
+**Exit Criteria**
+Implementation is complete when:
+- [ ] All tasks in `tasks.md` marked `[x]`
+- [ ] All multi-model reviews passed
+- [ ] Side-effect review confirmed no regressions
+- [ ] Change archived successfully
+<!-- CCG:SPEC:IMPL:END -->