ccgx-workflow 1.0.0

package/templates/commands/cancel.md

@@ -0,0 +1,132 @@
+---
+description: '中止活跃后台任务：先写 cancel.flag（cooperative）→ grace 5s → kill-tree 强制（v4.5 P1b 升级）'
+argument-hint: "<job-id> [--force]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+# Cancel - 中止活跃后台任务（v4.5 升级）
+
+写一个**协作式**取消信号到 `.context/jobs/<job-id>/cancel.flag`，并在 grace period（默认 5s）后**强制 kill 进程树**作为兜底。后台子任务（codex:codex-rescue / phase-runner / autonomous loop）每次推进步骤前轮询 cancel.flag，发现存在则清理并退出。卡在 OS-level 不可中断 syscall 的子进程由 kill-tree fallback 兜底。
+
+> ⚠️ v4.5 之前是**纯协作**取消（不持有 PID），v4.5 P1b 引入 supervisor + cli_pid + process_group_id 后升级为**协作 + 强制兜底**。如果 phase-runner 已通过 `ccg-phase-runner-launcher.mjs` 启动，state.json 会含 `cli_pid`，本命令在 grace period 后调用 kill-tree（POSIX：`kill -TERM -<pgid>` → `kill -KILL`；Windows：`taskkill /T /F /PID`）。
+
+## 使用方法
+
+```bash
+/ccg:cancel <job-id>          # 默认：cancel.flag + 5s grace + kill-tree
+/ccg:cancel <job-id> --force  # 跳过 grace，立即 kill-tree（紧急停机）
+```
+
+## 工作流程
+
+### Step 1：校验 job 存在 + 状态可取消
+
+1. Read `.context/jobs/<job-id>/state.json`
+2. 不存在 → "Job not found: <id>，run /ccg:status to list all jobs"，退出
+3. `status` ∈ `{done, failed, canceled}` → "Job <id> already <status>，nothing to cancel"，退出（**不报错**）
+4. `status` ∈ `{queued, running}` → 进入 Step 2
+
+### Step 2：写 cancel.flag + 更新 state.json
+
+1. 写文件 `.context/jobs/<job-id>/cancel.flag`，内容：
+
+   ```
+   cancel-requested-at: <ISO timestamp>
+   requested-by: /ccg:cancel
+   ```
+
+   v4.5+：`src/utils/jobs.ts` 的 `requestCancel` 走 `atomicWriteFileSync`（temp + rename），cancel.flag 永远不会半写。
+
+2. 更新 state.json：把 `cancel_requested` 设为 `true`（**status 仍保持 running/queued** —— 真实 status 转 `canceled` 由子任务退出时自己写或由 Step 4 兜底写）
+
+### Step 3：grace period（默认 5s，`--force` 跳过）
+
+观察子任务是否自己退出：每秒 Read `state.json.status`，如果在 5s 内变成 `canceled` / `failed` / `done` → 跳过 Step 4，输出"协作取消生效"。
+
+### Step 4：kill-tree fallback（grace 超时后）
+
+读取 state.json 中的 `cli_pid` + `process_group_id`：
+
+- **没有 cli_pid**（v4.5 之前的 legacy job 或非 launcher 路径）：保持原有协作行为，提醒用户"无 PID 记录，请手动 `kill -9` 残留进程"。
+- **有 cli_pid**：用 Bash 执行 kill-tree：
+  - **POSIX**: 优先 `kill -TERM -<pgid>` 走进程组（含 nested plugin 子进程）；失败回退 `kill -TERM <cli_pid>`；再 grace 1s 后 `kill -KILL`。
+  - **Windows**: `taskkill /T /F /PID <cli_pid>` 杀整棵进程树（含 nested plugin）。
+
+  生成的 Bash（示例）：
+
+  ```bash
+  # POSIX
+  kill -TERM -42 2>/dev/null || kill -TERM 42 2>/dev/null
+  sleep 1
+  kill -0 42 2>/dev/null && (kill -KILL -42 2>/dev/null || kill -KILL 42 2>/dev/null)
+
+  # Windows
+  taskkill /T /F /PID 1234
+  ```
+
+- 写终态 state.json：`status=canceled`，`summary="canceled by /ccg:cancel + kill-tree fallback"`。
+
+### Step 5：通知用户
+
+输出（协作取消生效）：
+
+```
+✓ Job <id> canceled cooperatively (status: canceled, no kill-tree needed)
+```
+
+输出（kill-tree 兜底）：
+
+```
+⚠ Cooperative grace period (5s) elapsed without exit.
+✓ Issued kill-tree on cli_pid=<N> (pgid=<M>): step1=SIGTERM, step2=SIGKILL after 1s
+Status: canceled (forced via kill-tree)
+```
+
+## 严格约束
+
+- ✅ **协作优先**——总是先写 cancel.flag 给子进程自己退的机会，避免半写文件
+- ✅ **强制兜底**（v4.5+ supervised job）——grace 后 kill-tree 防 hang 死循环
+- ✅ 幂等——多次调用不报错，不重写 flag
+- ✅ 已终态的 job 调用 cancel 也不报错（友好降级）
+- ✅ atomic write（v4.5 P1b）——cancel.flag 永远不会半写
+- ❌ **不要**直接把 status 改成 `canceled`——会与子任务退出时的写入产生竞态（除非 kill-tree 生效后）
+- ❌ **不要**删除 `.context/jobs/<id>/` 目录——历史可观测性必须保留
+
+## 子任务侧契约（开发者参考）
+
+后台子任务必须周期性检查 cancel.flag 才能让协作路径生效（避免 kill-tree 兜底）。最小契约：
+
+```typescript
+import { isCancelRequested, writeJobState, getJob } from '~/.claude/.ccg/utils/jobs'
+
+// 每个推进步骤前
+if (isCancelRequested(workdir, jobId)) {
+  const cur = getJob(workdir, jobId)!
+  writeJobState(workdir, { ...cur, status: 'canceled', summary: 'canceled by user' })
+  // optional: write result.md with "STATUS: canceled\nNOTES: aborted at <step>"
+  process.exit(0)
+}
+```
+
+phase-runner / codex:codex-rescue / autonomous loop 全部接入此契约（v4.0 Phase 7 + v4.5 P1b）。
+
+## 与其他命令的协作
+
+| 时序 | 命令 | 作用 |
+|------|------|------|
+| t0 | `/ccg:autonomous` | spawn launcher + child；写 state.json (running, cli_pid, pgid) |
+| t1 | `/ccg:status` | 用户看到 running 太久 |
+| t2 | `/ccg:cancel <id>` | **本命令**——写 cancel.flag |
+| t3a | (子任务下次轮询) | isCancelRequested → 自己写 state.json (canceled) |
+| t3b | (grace 5s 超时, t3a 未发生) | 本命令 kill-tree → 写 state.json (canceled, forced) |
+| t4 | `/ccg:result <id>` | 看到 canceled 摘要 |
+
+## 实现锚点
+
+- `src/utils/jobs.ts` 的 `requestCancel` 是后端真相源（atomic write）
+- `src/utils/process-tree.ts` 的 `killProcessTree` 是 kill-tree 真相源（POSIX pgid + Windows taskkill）
+- `templates/scripts/ccg-phase-runner-launcher.mjs` 的 launcher 是 cli_pid / pgid 的写入者
+- 失败模式：见 `src/utils/__tests__/jobs.test.ts`（atomic write）+ `processTree.test.ts`（kill-tree 13 种 failure mode 覆盖）

package/templates/commands/clean-branches.md

@@ -0,0 +1,117 @@
+---
+description: '清理 Git 分支：安全清理已合并或过期分支，默认 dry-run 模式'
+---
+
+# Clean-Branches - 清理 Git 分支
+
+安全识别并清理已合并或长期未更新的分支。
+
+## 使用方法
+
+```bash
+/clean-branches [options]
+```
+
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `--base <branch>` | 基准分支（默认 main/master） |
+| `--stale <days>` | 清理超过 N 天未更新的分支 |
+| `--remote` | 同时清理远程分支 |
+| `--dry-run` | 只预览，不执行（**默认**） |
+| `--yes` | 跳过确认直接删除 |
+| `--force` | 强制删除未合并分支 |
+
+---
+
+## 执行工作流
+
+### 🔍 阶段 1：预检
+
+`[模式：准备]`
+
+1. 同步远端：`git fetch --all --prune`
+2. 读取保护分支配置
+3. 确定基准分支
+
+### 📋 阶段 2：分析识别
+
+`[模式：分析]`
+
+**已合并分支**：
+- 已完全合并到 `--base` 的分支
+
+**过期分支**（如指定 `--stale`）：
+- 最后提交在 N 天前的分支
+
+**排除**：
+- 从待清理列表中移除保护分支
+
+### 📊 阶段 3：报告预览
+
+`[模式：报告]`
+
+```markdown
+## 将要删除的分支
+
+### 已合并分支
+- feature/old-feature (合并于 3 天前)
+- bugfix/fixed-issue (合并于 7 天前)
+
+### 过期分支
+- experiment/old-test (最后更新 90 天前)
+```
+
+### ✅ 阶段 4：执行清理
+
+`[模式：执行]`
+
+仅在不带 `--dry-run` 且确认后执行：
+
+```bash
+# 本地分支
+git branch -d <branch>
+
+# 远程分支（如果 --remote）
+git push origin --delete <branch>
+
+# 强制删除（如果 --force）
+git branch -D <branch>
+```
+
+---
+
+## 保护分支配置
+
+```bash
+# 添加保护分支
+git config --add branch.cleanup.protected develop
+git config --add branch.cleanup.protected 'release/*'
+
+# 查看保护分支
+git config --get-all branch.cleanup.protected
+```
+
+---
+
+## 示例
+
+```bash
+# 预览将清理的分支
+/clean-branches --dry-run
+
+# 清理已合并且超过 90 天未动的分支
+/clean-branches --stale 90
+
+# 清理已合并到 release/v2.1 的分支
+/clean-branches --base release/v2.1 --remote --yes
+```
+
+## 最佳实践
+
+1. **优先 dry-run** – 先预览再执行
+2. **活用 --base** – 适配 release 工作流
+3. **谨慎 --force** – 除非确定无用
+4. **团队协作** – 清理远程分支前先通知
+5. **定期运行** – 每月/季度一次保持清爽

package/templates/commands/codex-exec.md

@@ -0,0 +1,404 @@
+---
+description: '{{BACKEND_PRIMARY}} 全权执行计划 - 读取 /ccg:plan 产出的计划文件，{{BACKEND_PRIMARY}} 承担 MCP 搜索 + 代码实现 + 测试，多模型审核'
+---
+
+# Codex-Exec - Codex 全权执行计划
+
+$ARGUMENTS
+
+---
+
+## 核心理念
+
+**与 `/ccg:plan` 配对使用**：
+
+```
+/ccg:plan → 多模型协同规划（Codex ∥ Gemini 分析 → Claude 综合）
+                ↓ 计划文件 (.claude/plan/xxx.md)
+/ccg:codex-exec → Codex 全权执行（MCP 搜索 + 代码实现 + 测试）
+                ↓ 代码变更
+                → 多模型审核（Codex ∥ Gemini 交叉审查）
+```
+
+**与 `/ccg:execute` 的区别**：
+
+| 维度 | `/ccg:execute` | `/ccg:codex-exec` |
+|------|---------------|-------------------|
+| 代码实现 | Claude 重构 {{BACKEND_PRIMARY}}/{{FRONTEND_PRIMARY}} 的 Diff | **{{BACKEND_PRIMARY}} 直接实现** |
+| MCP 搜索 | Claude 调用 MCP | **{{BACKEND_PRIMARY}} 调用 MCP** |
+| Claude 上下文 | 高（搜索结果 + 代码全进来） | **极低（只看摘要 + diff）** |
+| Claude token | 大量消耗 | **极少消耗** |
+| 审核 | 多模型审查 | **多模型审查（不变）** |
+
+---
+
+## 语言协议
+
+- 与工具/模型交互用 **英语**
+- 与用户交互用 **中文**
+
+---
+
+## 多模型调用规范
+
+**工作目录**：
+- `{{WORKDIR}}`：**必须通过 Bash 执行 `pwd`（Unix）或 `cd`（Windows CMD）获取当前工作目录的绝对路径**，禁止从 `$HOME` 或环境变量推断
+- 如果用户通过 `/add-dir` 添加了多个工作区，先用 Glob/Grep 确定任务相关的工作区
+- 如果无法确定，用 `AskUserQuestion` 询问用户选择目标工作区
+
+**{{BACKEND_PRIMARY}} 执行调用语法**：
+
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EXEC_EOF'
+<TASK>
+<指令内容>
+</TASK>
+EXEC_EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "简短描述"
+})
+```
+
+**{{BACKEND_PRIMARY}} 复用会话调用**：
+
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - \"{{WORKDIR}}\" <<'EXEC_EOF'
+<TASK>
+<指令内容>
+</TASK>
+EXEC_EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "简短描述"
+})
+```
+
+**审核调用语法**（Codex ∥ Gemini 并行审查）：
+
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend <{{BACKEND_PRIMARY}}|{{FRONTEND_PRIMARY}}> {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'REVIEW_EOF'
+ROLE_FILE: <角色提示词路径>
+<TASK>
+Scope: Audit the code changes made by Codex.
+Inputs:
+- The git diff (applied changes)
+- The implementation plan
+Constraints:
+- Do NOT modify any files.
+</TASK>
+OUTPUT:
+1) A prioritized list of issues (severity, file, rationale)
+2) If code changes are needed, include a Unified Diff Patch in a fenced code block.
+REVIEW_EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "简短描述"
+})
+```
+
+**角色提示词**：
+
+| 阶段 | 后端 | 前端 |
+|------|-------|--------|
+| 审查 | `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md` | `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md` |
+
+**事件驱动等待（v4.5.2 起）**：spawn 后主线说明 task-id 然后 **turn end**，引擎自动 `<task-notification>` 触发新 turn 处理结果。**不调 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 次全失败才降级单模型。
+
+---
+
+## 执行工作流
+
+**执行任务**：$ARGUMENTS
+
+### 📖 Phase 0：读取计划
+
+`[模式：准备]`
+
+1. **识别输入类型**：
+   - 计划文件路径（如 `.claude/plan/xxx.md`）→ 读取并解析
+   - 直接的任务描述 → 提示用户先执行 `/ccg:plan`
+
+2. **解析计划内容**，提取：
+   - 任务类型（前端/后端/全栈）
+   - 技术方案
+   - 实施步骤
+   - 关键文件列表
+   - SESSION_ID（`CODEX_SESSION` / `GEMINI_SESSION`）
+
+3. **执行前确认**：
+   向用户展示计划摘要，确认后执行：
+
+   ```markdown
+   ## 即将执行
+
+   **任务**：<计划标题>
+   **模式**：Codex 全权执行
+   **步骤**：<N 步>
+   **关键文件**：<N 个>
+
+   Codex 将自主完成：MCP 搜索 + 代码实现 + 测试验证
+   Claude 仅做最终审核
+
+   确认执行？(Y/N)
+   ```
+
+---
+
+### ⚡ Phase 1：Codex 全权执行
+
+`[模式：执行]`
+
+**将计划转化为 Codex 结构化指令，一次性下发**：
+
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}resume <CODEX_SESSION> - \"{{WORKDIR}}\" <<'EXEC_EOF'
+<TASK>
+You are a full-stack execution agent. Implement the following plan end-to-end.
+
+## Implementation Plan
+<将 Phase 0 解析出的完整计划内容粘贴于此>
+
+## Your Instructions
+
+### Step 1: Context Verification
+Before coding, verify you have sufficient context:
+- Use ace-tool MCP (search_context) to search for relevant existing code patterns
+- Read the key files listed in the plan to understand current implementation
+- If the plan references external libraries/APIs, use context7 MCP to query their latest documentation
+- If latest information is needed, use grok-search MCP for web search
+
+### Step 2: Implementation
+Implement each step from the plan in order:
+<将计划的实施步骤逐条列出>
+
+Constraints:
+- Follow existing code conventions in this project
+- Handle edge cases and errors properly
+- Keep changes minimal and focused on the plan
+- Do NOT modify files outside the plan's scope
+
+### Step 3: Self-Verification
+After implementation:
+- Run lint/typecheck if available
+- Run existing tests: <从计划中提取测试命令，如无则 "run project's test suite">
+- Verify no regressions in touched modules
+
+## Output Format
+Respond with a structured report:
+
+### CONTEXT_GATHERED
+<What information was searched/found, key findings from MCP tools>
+
+### CHANGES_MADE
+For each file changed:
+- File path
+- What was changed and why
+- Lines added/removed
+
+### VERIFICATION_RESULTS
+- Lint/typecheck: pass/fail
+- Tests: pass/fail (details if fail)
+- Manual checks performed
+
+### REMAINING_ISSUES
+<Any unresolved issues, edge cases, or suggestions>
+</TASK>
+EXEC_EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex 全权执行：<计划标题>"
+})
+```
+
+**📌 记录 SESSION_ID**（`CODEX_EXEC_SESSION`）
+
+如果计划中无 `CODEX_SESSION`（用户跳过了 `/ccg:plan` 的多模型分析），则使用新会话。
+
+事件驱动等待 (v4.5.2)：spawn 完后主线 turn end，等 task-notification 自动唤醒。
+
+---
+
+### 🔍 Phase 2：Claude 轻量审核
+
+`[模式：审核]`
+
+**Claude 只做最小验证，不重复 Codex 已做的工作**：
+
+1. **读取 Codex 报告**：解析 CONTEXT_GATHERED / CHANGES_MADE / VERIFICATION_RESULTS / REMAINING_ISSUES
+2. **查看实际变更**：
+
+   ```
+   Bash({ command: "git diff HEAD", description: "查看 Codex 实际变更" })
+   ```
+
+3. **快速判定**：
+   - 变更是否在计划范围内？
+   - 是否有明显安全/逻辑问题？
+   - 测试是否通过？
+
+4. **处理结果**：
+   - ✅ **通过** → Phase 3 多模型审核
+   - ⚠️ **小问题** → Claude 直接修复（< 10 行的修正 Claude 自己做）
+   - ❌ **需返工** → Phase 2.5 追加指令
+
+---
+
+### 🔄 Phase 2.5：追加指令（仅在需返工时）
+
+`[模式：追加]`
+
+**复用 Codex 会话，下发修正指令**：
+
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend {{BACKEND_PRIMARY}} {{GEMINI_MODEL_FLAG}}resume <CODEX_EXEC_SESSION> - \"{{WORKDIR}}\" <<'FIXEOF'
+<TASK>
+The implementation needs corrections:
+
+## Issues Found
+1. <问题描述 + 具体文件:行号>
+2. <问题描述 + 具体文件:行号>
+
+## Required Fixes
+1. <具体修正要求>
+2. <具体修正要求>
+
+Apply fixes and re-run tests. Report results in the same format.
+</TASK>
+FIXEOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex 修正：<问题简述>"
+})
+```
+
+等待完成后回到 Phase 2。**最多 2 轮返工**，超过则 Claude 直接接管修复。
+
+---
+
+### ✅ Phase 3：多模型审核
+
+`[模式：审核]`
+
+**并行调用 {{BACKEND_PRIMARY}} + {{FRONTEND_PRIMARY}} 交叉审查**（多模型协同不变）：
+
+1. **获取变更 diff**：
+
+   ```
+   Bash({ command: "git diff HEAD", description: "获取完整变更 diff" })
+   ```
+
+2. **并行调用**（`run_in_background: true`）：
+
+   - **{{BACKEND_PRIMARY}} 审查**：
+     - ROLE_FILE: `~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md`
+     - 输入：变更 Diff + 计划文件内容
+     - 关注：安全性、性能、错误处理、逻辑正确性
+
+   - **{{FRONTEND_PRIMARY}} 审查**：
+     - ROLE_FILE: `~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md`
+     - 输入：变更 Diff + 计划文件内容
+     - 关注：代码可读性、设计一致性、可维护性
+
+   用 `TaskOutput` 等待两个模型的完整审查结果。
+
+3. **整合审查意见**：
+   - 按信任规则：后端问题以 {{BACKEND_PRIMARY}} 为准，前端问题以 {{FRONTEND_PRIMARY}} 为准
+   - **Critical** → 必须修复（Claude 直接修或再派 Codex）
+   - **Warning** → 建议修复，报告给用户决定
+   - **Info** → 记录不处理
+
+4. **执行修复**（如有 Critical）：
+   - < 10 行修正：Claude 直接修
+   - ≥ 10 行修正：再派 Codex（复用 `CODEX_EXEC_SESSION`）
+   - 修复后可选重复 Phase 3（直到风险可接受）
+
+---
+
+### 📦 Phase 4：交付
+
+`[模式：交付]`
+
+向用户报告：
+
+```markdown
+## ✅ 执行完成
+
+### 执行摘要
+| 项目 | 详情 |
+|------|------|
+| 计划 | <计划文件路径> |
+| 模式 | Codex 全权执行 + 多模型审核 |
+| 搜索 | <Codex 使用了哪些 MCP 工具，关键发现> |
+| 变更 | <N 个文件，+X/-Y 行> |
+| 测试 | <通过/失败> |
+| 返工 | <0/1/2 轮> |
+
+### 变更清单
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| path/to/file.ts | 修改/新增 | 描述 |
+
+### 审核结果
+- Codex 审查：<通过/发现 N 个问题>
+- Gemini 审查：<通过/发现 N 个问题>
+- Claude 处理：<已修复 N 个 Critical，N 个 Warning 待用户决定>
+
+### 后续建议
+1. [ ] <建议的测试步骤>
+2. [ ] <建议的验证步骤>
+```
+
+---
+
+## 关键规则
+
+1. **Claude 极简原则** — Claude 不调用 MCP、不做代码检索。只读计划、指挥 Codex、审核结果。
+2. **{{BACKEND_PRIMARY}} 全权执行** — MCP 搜索、文档查询、代码检索、实现、测试全由 {{BACKEND_PRIMARY}} 完成。
+3. **多模型审核不变** — 审核阶段仍然 Codex ∥ Gemini 交叉审查，保证质量。
+4. **信任规则** — 后端以 {{BACKEND_PRIMARY}} 为准，前端以 {{FRONTEND_PRIMARY}} 为准。
+5. **一次性下发** — 尽量一次给 Codex 完整指令 + 完整计划，减少来回通信。
+6. **最多 2 轮返工** — 超过 2 轮 Claude 直接接管，避免无限循环。
+7. **计划对齐** — Codex 实现必须在计划范围内，超出范围的变更视为违规。
+
+---
+
+## 使用方法
+
+```bash
+# 标准流程：先规划，再执行
+/ccg:plan 实现用户认证功能
+# 审查计划后...
+/ccg:codex-exec .claude/plan/user-auth.md
+
+# 直接执行（会提示先 /ccg:plan）
+/ccg:codex-exec 实现用户认证功能
+```
+
+---
+
+## 与 /ccg:plan 的关系
+
+```
+/ccg:plan ──→ .claude/plan/xxx.md
+                    │
+          ┌─────────┴─────────┐
+          ↓                   ↓
+   /ccg:execute        /ccg:codex-exec
+   (Claude 重构)       (Codex 全权)
+   Claude 高消耗       Claude 极低消耗
+   精细控制             高效执行
+```
+
+用户可根据任务特点选择：
+- **需要精细控制** → `/ccg:execute`（Claude 逐行重构）
+- **需要高效执行** → `/ccg:codex-exec`（Codex 一把梭）