ccg-workflow 1.6.0 → 1.7.1

package/templates/commands/review.md

@@ -1,89 +1,149 @@
 ---
-description: 多模型代码审查（并行执行），无参数时自动审查 git diff
+description: '多模型代码审查：无参数时自动审查 git diff，双模型交叉验证'
 ---
 
-## 用法
-`/review [CODE_OR_DESCRIPTION]`
+# Review - 多模型代码审查
 
-## 上下文
-- Arguments: $ARGUMENTS
-- This command triggers multi-model code review based on your configuration.
-- Configured models review simultaneously for comprehensive feedback.
+双模型并行审查，交叉验证综合反馈。无参数时自动审查当前 git 变更。
 
-## 行为
-- **No arguments**: Automatically review current git changes (staged + unstaged)
-- **With arguments**: Review specified code or description
+## 多模型调用语法
 
-## 你的角色
-You are the **Code Review Coordinator** orchestrating multi-model review. You direct:
-1. **ace-tool** – for retrieving code context
-2. **Configured Review Models** – for comprehensive code review
-3. **Claude (Self)** – for synthesizing feedback and recommendations
+**⚠️ 必须使用 heredoc 语法调用外部模型**：
 
-## 流程
+```bash
+~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - "$PWD" <<'EOF'
+<任务内容>
+EOF
+```
+
+---
+
+## 使用方法
+
+```bash
+/review [代码或描述]
+```
+
+- **无参数**：自动审查 `git diff HEAD`
+- **有参数**：审查指定代码或描述
 
-### Step 1: 获取待审查代码
+---
+
+## 执行工作流
+
+### 🔍 阶段 1：获取待审查代码
 
-**If no arguments provided**, run git commands to get current changes:
+`[模式：研究]`
+
+**无参数时**：
 ```bash
-# Get staged and unstaged changes
 git diff HEAD
 git status --short
 ```
 
-**If arguments provided**, use the specified code/description.
+**有参数时**：使用指定的代码/描述
 
-Then call `mcp__ace-tool__search_context` to get related context:
-   - `project_root_path`: Project root directory absolute path
-   - `query`: Description of code/files to review
+调用 `mcp__ace-tool__search_context` 获取相关上下文。
 
-### Step 2: 并行审查
+### 🔬 阶段 2：并行审查
 
-**并行调用所有配置的审查模型**（使用 `run_in_background: true`）：
+`[模式：审查]`
 
-遍历 {{REVIEW_MODELS}} 中的每个模型进行代码审查：
+**并行调用两个模型**：
 
-```bash
-# 遍历审查模型列表（默认: codex, gemini）
-for model in $(echo '{{REVIEW_MODELS}}' | jq -r '.[]'); do
-  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
-ROLE_FILE: ~/.claude/.ccg/prompts/$model/reviewer.md
+**执行步骤**：
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程：
 
-<TASK>
-审查代码: {{待审查的代码变更}}
-关注点: 安全性、性能、错误处理、可访问性、响应式设计、设计一致性
-</TASK>
+**Codex 审查进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
+[角色] 后端代码审查专家
+[任务] 审查以下代码变更
 
-OUTPUT: Review comments only. No code modifications.
-EOF
-done
-wait  # 等待所有后台任务完成
+## 审查重点
+- 安全性：注入、认证、授权
+- 性能：N+1 查询、缓存、复杂度
+- 错误处理：异常捕获、边界条件
+- 可维护性：命名、结构、文档
+
+## 待审查代码
+<粘贴 git diff 内容>
+
+## 输出格式
+按 Critical/Major/Minor/Suggestion 分类列出问题
+EOF_CODEX",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex 后端代码审查"
+})
 ```
 
-### Step 3: 综合反馈
-使用 `TaskOutput` 获取所有任务的结果，然后：
-1. Collect feedback from all configured models
-2. Categorize by severity (Critical, Major, Minor, Suggestion)
-3. Remove duplicate concerns
-4. Cross-validate findings across models
-5. Prioritize actionable items
+**Gemini 审查进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
+[角色] 前端代码审查专家
+[任务] 审查以下代码变更
+
+## 审查重点
+- 可访问性：ARIA、键盘导航、色彩对比
+- 响应式：移动端适配、断点
+- 设计一致性：组件复用、样式规范
+- 用户体验：加载状态、错误提示
 
-### Step 4: 呈现审查结果
-Provide unified review report to user with recommendations.
+## 待审查代码
+<粘贴 git diff 内容>
 
 ## 输出格式
-1. **Configuration** – models used for review
-2. **Review Summary** – overall assessment
-3. **Critical Issues** – must fix before merge
-4. **Major Issues** – should fix
-5. **Minor Issues** – nice to fix
-6. **Suggestions** – optional improvements
-7. **Recommended Actions** – prioritized fix list
-
-## 注意事项
-- **审查模型已在安装时注入**: {{REVIEW_MODELS}}
-- **No arguments** = auto-review git changes (`git diff HEAD`)
-- **With arguments** = review specified content
-- **Use `run_in_background: true` for parallel execution** to avoid blocking
-- 多模型结果交叉验证，综合反馈
-- Use HEREDOC syntax (`<<'EOF'`) to avoid shell escaping issues
+按 Critical/Major/Minor/Suggestion 分类列出问题
+EOF_GEMINI",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Gemini 前端代码审查"
+})
+```
+
+2. 使用 `TaskOutput` 监控并获取 2 个模型的审查结果。
+
+**⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
+
+### 🔀 阶段 3：综合反馈
+
+`[模式：综合]`
+
+1. 收集双方审查结果
+2. 按严重程度分类：Critical / Major / Minor / Suggestion
+3. 去重合并 + 交叉验证
+
+### 📊 阶段 4：呈现审查结果
+
+`[模式：总结]`
+
+```markdown
+## 📋 代码审查报告
+
+### 审查范围
+- 变更文件：<数量> | 代码行数：+X / -Y
+
+### 关键问题 (Critical)
+> 必须修复才能合并
+1. <问题描述> - [Codex/Gemini]
+
+### 主要问题 (Major) / 次要问题 (Minor) / 建议 (Suggestions)
+...
+
+### 总体评价
+- 代码质量：[优秀/良好/需改进]
+- 是否可合并：[是/否/需修复后]
+```
+
+---
+
+## 关键规则
+
+1. **无参数 = 审查 git diff** – 自动获取当前变更
+2. **heredoc 语法** – 必须使用 `<<'EOF'` 传递多行任务
+3. **双模型交叉验证** – 后端问题以 Codex 为准，前端问题以 Gemini 为准
+4. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
+5. **必须等待所有模型返回** – 禁止提前进入下一步

package/templates/commands/rollback.md

@@ -1,90 +1,116 @@
 ---
-description: 交互式回滚 Git 分支到历史版本；列分支、列版本、二次确认后执行 reset / revert
-allowed-tools: Read(**), Exec(git fetch, git branch, git tag, git log, git reflog, git checkout, git reset, git revert, git switch), Write()
-argument-hint: [--branch <branch>] [--target <rev>] [--mode reset|revert] [--depth <n>] [--dry-run] [--yes]
-# examples:
-#   - /git-rollback                # 全交互模式，dry‑run
-#   - /git-rollback --branch dev   # 直接选 dev，其他交互
-#   - /git-rollback --branch dev --target v1.2.0 --mode reset --yes
+description: '交互式 Git 回滚：安全回滚分支到历史版本，支持 reset/revert 模式'
 ---
 
-# Claude Command: Git Rollback
+# Rollback - 交互式 Git 回滚
 
-**目的**：安全、可视地将指定分支回滚到旧版本。
-默认处于 **只读预览 (`--dry-run`)**；真正执行需加 `--yes` 或在交互中确认。
+安全地将分支回滚到指定历史版本，默认 dry-run 模式。
+
+## 使用方法
+
+```bash
+/rollback [options]
+```
+
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `--branch <branch>` | 要回滚的分支 |
+| `--target <rev>` | 目标版本（commit/tag/reflog） |
+| `--mode reset\|revert` | 回滚模式 |
+| `--depth <n>` | 列出最近 n 个版本（默认 20） |
+| `--dry-run` | 只预览，不执行（**默认**） |
+| `--yes` | 跳过确认直接执行 |
 
 ---
 
-## Usage
+## 执行工作流
+
+### 🔍 阶段 1：同步远端
+
+`[模式：准备]`
 
 ```bash
-# 纯交互：列出分支 → 选分支 → 列最近 20 个版本 → 选目标 → 选择 reset 或 revert → 二次确认
-/git-rollback
+git fetch --all --prune
+```
 
-# 指定分支，其他交互
-/git-rollback --branch feature/calculator
+### 📋 阶段 2：选择分支
 
-# 指定分支与目标 commit，并用 hard‑reset 一键执行（危险）
-/git-rollback --branch main --target 1a2b3c4d --mode reset --yes
+`[模式：选择]`
 
-# 只想生成 revert 提交（非破坏式回滚），预览即可
-/git-rollback --branch release/v2.1 --target v2.0.5 --mode revert --dry-run
-```
+1. 列出本地 + 远端分支
+2. 过滤受保护分支
+3. 用户选择或使用 `--branch` 参数
 
-### Options
+### 📜 阶段 3：选择版本
 
-| 选项                   | 说明                                                                               |
-| ---------------------- | ---------------------------------------------------------------------------------- |
-| `--branch <branch>`    | 要回滚的分支；缺省时交互选择。                                                     |
-| `--target <rev>`       | 目标版本（commit Hash、Tag、reflog 引用都行）；缺省时交互选择近 `--depth` 条记录。 |
-| `--mode reset\|revert` | `reset`：硬回滚历史；`revert`：生成反向提交保持历史完整。默认询问。                |
-| `--depth <n>`          | 在交互模式下列出最近 n 个版本（默认 20）。                                         |
-| `--dry-run`            | **默认开启**，只预览即将执行的命令。                                               |
-| `--yes`                | 跳过所有确认直接执行，适合 CI/CD 脚本。                                            |
+`[模式：选择]`
 
----
+1. 显示最近 N 个版本（`git log --oneline`）
+2. 显示相关 tags（`git tag --merged`）
+3. 用户选择或使用 `--target` 参数
+
+### ⚙️ 阶段 4：选择模式
+
+`[模式：决策]`
+
+| 模式 | 说明 | 推送方式 |
+|------|------|----------|
+| `reset` | 硬回滚，改变历史 | `--force-with-lease` |
+| `revert` | 生成反向提交，保留历史 | 普通 push |
 
-## 交互流程
+### ⛔ 阶段 5：最终确认
 
-1. **同步远端** → `git fetch --all --prune`
-2. **列分支** → `git branch -a`（本地＋远端，过滤受保护分支）
-3. **选分支** → 用户输入或传参
-4. **列版本** → `git log --oneline -n <depth>` + `git tag --merged` + `git reflog -n <depth>`
-5. **选目标** → 用户输入 commit hash / tag
-6. **选模式** → `reset` 或 `revert`
-7. **最终确认** （除非 `--yes`）
-8. **执行回滚**
-   - `reset`：`git switch <branch> && git reset --hard <target>`
-   - `revert`：`git switch <branch> && git revert --no-edit <target>..HEAD`
-9. **推送建议** → 提示是否 `git push --force-with-lease`（reset）或普通 `git push`（revert）
+`[模式：确认]`
+
+显示即将执行的命令，等待用户确认（除非 `--yes`）。
+
+### ✅ 阶段 6：执行回滚
+
+`[模式：执行]`
+
+**reset 模式**：
+```bash
+git switch <branch>
+git reset --hard <target>
+```
+
+**revert 模式**：
+```bash
+git switch <branch>
+git revert --no-edit <target>..HEAD
+```
 
 ---
 
 ## 安全护栏
 
-- **备份**：执行前自动在 reflog 中记录当前 HEAD，可用 `git switch -c backup/<timestamp>` 恢复。
-- **保护分支**：如检测到 `main` / `master` / `production` 等受保护分支且开启 `reset` 模式，将要求额外确认。
-- **--dry-run 默认开启**：防止误操作。
-- **--force 禁止**：不提供 `--force`；如需强推，请手动输入 `git push --force-with-lease`。
+1. **备份**：执行前自动记录当前 HEAD 到 reflog
+2. **保护分支**：`main`/`master`/`production` 需额外确认
+3. **dry-run 默认**：防止误操作
+4. **禁止 --force**：如需强推，手动执行
 
 ---
 
-## 适用场景示例
+## 示例
 
-| 场景                                            | 调用示例                                                         |
-| ----------------------------------------------- | ---------------------------------------------------------------- |
-| 热修补丁上线后发现 bug，需要回到 Tag `v1.2.0`   | `/git-rollback --branch release/v1 --target v1.2.0 --mode reset` |
-| 运维同事误推了 debug 日志提交，需要生成反向提交 | `/git-rollback --branch main --target 3f2e7c9 --mode revert`     |
-| 调研历史 bug，引导新人浏览分支历史              | `/git-rollback` （全交互，dry‑run）                              |
+```bash
+# 全交互模式（dry-run）
+/rollback
 
----
+# 指定分支
+/rollback --branch dev
 
-## 注意
+# 完整指定，一键执行
+/rollback --branch main --target v1.2.0 --mode reset --yes
 
-1. **reset vs revert**
-   - **reset** 会改变历史，需要强推并可能影响其他协作者，谨慎使用。
-   - **revert** 更安全，生成新提交保留历史，但会增加一次记录。
-2. **嵌入式仓库** 常有大体积二进制文件；回滚前请确保 LFS/子模块状态一致。
-3. 若仓库启用了 CI 强制校验，回滚后可能自动触发流水线；确认管控策略以免误部署旧版本。
+# 生成反向提交
+/rollback --branch release/v2.1 --target v2.0.5 --mode revert
+```
 
----
+## 注意事项
+
+- **reset vs revert**：reset 改变历史，需强推；revert 更安全
+- **LFS/子模块**：回滚前确保状态一致
+- **CI 触发**：回滚后可能自动触发流水线

package/templates/commands/test.md

@@ -1,83 +1,172 @@
 ---
-description: 多模型测试生成（Codex 后端测试 + Gemini 前端测试）
+description: '多模型测试生成：智能路由 Codex 后端测试 / Gemini 前端测试'
 ---
 
-## 用法
-`/test <测试目标>`
+# Test - 多模型测试生成
+
+根据代码类型智能路由，生成高质量测试用例。
+
+## 多模型调用语法
+
+**必须使用 heredoc 语法调用 codeagent-wrapper**：
+
+```bash
+~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - [工作目录] <<'EOF'
+<任务内容>
+EOF
+```
+
+## 使用方法
+
+```bash
+/test <测试目标>
+```
 
 ## 上下文
-- 测试目标: $ARGUMENTS
-- Codex 生成后端测试，Gemini 生成前端测试
-
-## 流程
-
-### Phase 1: 测试分析
-1. 调用 `mcp__ace-tool__search_context` 检索:
-   - `project_root_path`: 项目根目录绝对路径
-   - `query`: 需要测试的代码/功能描述
-   - 目标代码的完整实现
-   - 现有测试文件和测试框架
-   - 项目测试配置（jest.config, pytest.ini 等）
-2. 识别代码类型：前端组件 / 后端逻辑 / 全栈
-3. 评估当前测试覆盖率和缺口
-
-### Phase 2: 智能路由测试生成
+
+- 测试目标：$ARGUMENTS
+- 智能路由：后端 → Codex，前端 → Gemini，全栈 → 并行
+- 遵循项目现有测试框架和风格
+
+## 你的角色
+
+你是**测试工程师**，编排测试生成流程：
+- **Codex** – 后端测试生成（**后端权威**）
+- **Gemini** – 前端测试生成（**前端权威**）
+- **Claude (自己)** – 整合测试、验证运行
+
+---
+
+## 执行工作流
+
+**测试目标**：$ARGUMENTS
+
+### 🔍 阶段 0：Prompt 增强（可选）
+
+`[模式：准备]` - 增强测试需求
+
+**如果 ace-tool MCP 可用**，调用 `mcp__ace-tool__enhance_prompt`：
+- 输入原始测试目标
+- 获取增强后的详细测试需求
+- 用增强后的需求替代原始 $ARGUMENTS
+
+### 🔍 阶段 1：测试分析
+
+`[模式：研究]`
+
+1. 检索目标代码的完整实现
+2. 查找现有测试文件和测试框架配置
+3. 识别代码类型：[后端/前端/全栈]
+4. 评估当前测试覆盖率和缺口
+
+### 🔬 阶段 2：智能路由测试生成
+
+`[模式：生成]`
+
 | 代码类型 | 路由 | 角色 |
 |---------|------|------|
-| 后端 | Codex | `tester` |
-| 前端 | Gemini | `tester` |
+| 后端 | Codex | `tester.md` |
+| 前端 | Gemini | `tester.md` |
 | 全栈 | 并行执行 | 两者 |
 
-**调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
+**全栈代码并行调用**：
 
-```bash
-# Codex 后端测试生成
-codeagent-wrapper --backend {{BACKEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/tester.md
+**执行步骤**：
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程：
 
-<TASK>
-生成测试: {{需要测试的代码}}
-Context: {{现有测试和测试框架配置}}
-</TASK>
+**Codex 测试生成进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
+你是后端测试专家，角色提示词见 ~/.claude/.ccg/prompts/codex/tester.md
+
+任务：为以下代码生成单元测试
+<代码内容>
+
+要求：
+1. 使用项目现有测试框架
+2. 覆盖正常路径、边界条件、异常处理
+3. 输出完整测试代码
+EOF_CODEX",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex 后端测试生成"
+})
+```
 
-OUTPUT: Unified Diff Patch for test files ONLY.
-EOF
+**Gemini 测试生成进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
+你是前端测试专家，角色提示词见 ~/.claude/.ccg/prompts/gemini/tester.md
+
+任务：为以下组件生成测试
+<组件代码>
+
+要求：
+1. 使用项目现有测试框架
+2. 测试渲染、交互、状态变化
+3. 输出完整测试代码
+EOF_GEMINI",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Gemini 前端测试生成"
+})
 ```
 
-```bash
-# Gemini 前端测试生成
-codeagent-wrapper --backend {{FRONTEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/tester.md
+2. 使用 `TaskOutput` 监控并获取 2 个模型的测试代码。
 
-<TASK>
-生成测试: {{需要测试的代码}}
-Context: {{现有测试和测试框架配置}}
-</TASK>
+**⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
 
-OUTPUT: Unified Diff Patch for test files ONLY.
-EOF
-```
+### 🔀 阶段 3：测试整合
 
-根据代码类型选择调用对应模型，全栈代码则并行调用（`run_in_background: true`）。
+`[模式：计划]`
 
-### Phase 3: 测试整合
-1. 收集模型输出（`TaskOutput`）
+1. 收集模型输出
 2. Claude 重构：统一风格、确保命名一致、优化结构、移除冗余
 
-### Phase 4: 测试验证
-1. 运行生成的测试
-2. 检查通过率
+### ✅ 阶段 4：测试验证
+
+`[模式：执行]`
+
+1. 创建测试文件
+2. 运行生成的测试
 3. 如有失败，分析原因并修复
 
+---
+
+## 输出格式
+
+```markdown
+## 🧪 测试生成：<测试目标>
+
+### 分析结果
+- 代码类型：[后端/前端/全栈]
+- 测试框架：<检测到的框架>
+
+### 生成的测试
+- 测试文件：<文件路径>
+- 测试用例数：<数量>
+
+### 运行结果
+- 通过：X / Y
+- 失败：<如有，列出原因>
+```
+
 ## 测试策略金字塔
+
 ```
     /\      E2E (10%)
    /--\     Integration (20%)
   /----\    Unit (70%)
 ```
 
-## 关键原则
-1. **测试行为，不测试实现** - 关注输入输出
-2. **智能路由** - 后端测试用 Codex，前端测试用 Gemini
-3. **复用现有模式** - 遵循项目已有的测试风格
-4. **覆盖优先级** - 先覆盖关键路径和高风险代码
+---
+
+## 关键规则
+
+1. **测试行为，不测试实现** – 关注输入输出
+2. **智能路由** – 后端测试用 Codex，前端测试用 Gemini
+3. **复用现有模式** – 遵循项目已有的测试风格
+4. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
+5. **必须等待所有模型返回** – 禁止提前进入下一步