ccg-workflow 1.5.1 → 1.7.0

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,85 +1,148 @@
 ---
-description: 多模型测试生成（Codex 后端测试 + Gemini 前端测试）
+description: '多模型测试生成：智能路由 Codex 后端测试 / Gemini 前端测试'
 ---
 
-> 调用语法见 `_config.md`
+# Test - 多模型测试生成
 
-## 用法
-`/test <测试目标>`
+根据代码类型智能路由，生成高质量测试用例。
+
+## 多模型调用语法
+
+**必须使用 heredoc 语法调用 codeagent-wrapper**：
+
+```bash
+~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - [工作目录] <<'EOF'
+<任务内容>
+EOF
+```
+
+## 使用方法
+
+```bash
+/test <测试目标>
+```
 
 ## 上下文
-- 测试目标: $ARGUMENTS
-- Codex 生成后端测试，Gemini 生成前端测试
-
-## 流程
-
-### Phase 1: 测试分析
-1. 调用 `{{MCP_SEARCH_TOOL}}` 检索:
-   - `project_root_path`: 项目根目录绝对路径
-   - `query`: 需要测试的代码/功能描述
-   - 目标代码的完整实现
-   - 现有测试文件和测试框架
-   - 项目测试配置（jest.config, pytest.ini 等）
-2. 识别代码类型：前端组件 / 后端逻辑 / 全栈
-3. 评估当前测试覆盖率和缺口
-
-### Phase 2: 智能路由测试生成
+
+- 测试目标：$ARGUMENTS
+- 智能路由：后端 → Codex，前端 → Gemini，全栈 → 并行
+- 遵循项目现有测试框架和风格
+
+## 你的角色
+
+你是**测试工程师**，编排测试生成流程：
+- **Codex** – 后端测试生成（**后端权威**）
+- **Gemini** – 前端测试生成（**前端权威**）
+- **Claude (自己)** – 整合测试、验证运行
+
+---
+
+## 执行工作流
+
+**测试目标**：$ARGUMENTS
+
+### 🔍 阶段 1：测试分析
+
+`[模式：研究]`
+
+1. 检索目标代码的完整实现
+2. 查找现有测试文件和测试框架配置
+3. 识别代码类型：[后端/前端/全栈]
+4. 评估当前测试覆盖率和缺口
+
+### 🔬 阶段 2：智能路由测试生成
+
+`[模式：生成]`
+
 | 代码类型 | 路由 | 角色 |
 |---------|------|------|
-| 后端 | Codex | `tester` |
-| 前端 | Gemini | `tester` |
+| 后端 | Codex | `tester.md` |
+| 前端 | Gemini | `tester.md` |
 | 全栈 | 并行执行 | 两者 |
 
-**调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
+**全栈代码并行调用**：
 
+**执行步骤**：
+1. 在**同一个 Bash 调用**中启动两个后台进程（不加 wait，立即返回）：
 ```bash
-# Codex 后端测试生成
-codeagent-wrapper --backend {{BACKEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/tester.md
+# Codex 后端测试调用
+~/.claude/bin/codeagent-wrapper --backend codex - $PWD <<'EOF' &
+你是后端测试专家，角色提示词见 ~/.claude/.ccg/prompts/codex/tester.md
 
-<TASK>
-生成测试: {{需要测试的代码}}
-Context: {{现有测试和测试框架配置}}
-</TASK>
+任务：为以下代码生成单元测试
+<代码内容>
 
-OUTPUT: Unified Diff Patch for test files ONLY.
+要求：
+1. 使用项目现有测试框架
+2. 覆盖正常路径、边界条件、异常处理
+3. 输出完整测试代码
 EOF
-```
 
-```bash
-# Gemini 前端测试生成
-codeagent-wrapper --backend {{FRONTEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/tester.md
+# Gemini 前端测试调用
+~/.claude/bin/codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+你是前端测试专家，角色提示词见 ~/.claude/.ccg/prompts/gemini/tester.md
 
-<TASK>
-生成测试: {{需要测试的代码}}
-Context: {{现有测试和测试框架配置}}
-</TASK>
+任务：为以下组件生成测试
+<组件代码>
 
-OUTPUT: Unified Diff Patch for test files ONLY.
+要求：
+1. 使用项目现有测试框架
+2. 测试渲染、交互、状态变化
+3. 输出完整测试代码
 EOF
 ```
+2. 使用 `TaskOutput` 监控并获取 2 个模型的测试代码。
+
+**⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
 
-根据代码类型选择调用对应模型，全栈代码则并行调用（`run_in_background: true`）。
+### 🔀 阶段 3：测试整合
 
-### 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. **必须等待所有模型返回** – 禁止提前进入下一步

package/templates/commands/workflow.md

@@ -0,0 +1,198 @@
+---
+description: '多模型协作开发工作流（研究→构思→计划→执行→优化→评审），智能路由前端→Gemini、后端→Codex'
+---
+
+# Workflow - 多模型协作开发
+
+使用质量把关、MCP 服务和多模型协作执行结构化开发工作流。
+
+## 使用方法
+
+```bash
+/workflow <任务描述>
+```
+
+## 上下文
+
+- 要开发的任务：$ARGUMENTS
+- 带质量把关的结构化 6 阶段工作流
+- 多模型协作：Codex（后端）+ Gemini（前端）+ Claude（编排）
+- MCP 服务集成（ace-tool）以增强功能
+
+## 你的角色
+
+你是**编排者**，协调多模型协作系统（研究 → 构思 → 计划 → 执行 → 优化 → 评审），用中文协助用户，面向专业程序员，交互应简洁专业，避免不必要解释。
+
+**协作模型**：
+- **ace-tool MCP** – 代码检索 + Prompt 增强
+- **Codex** – 后端逻辑、算法、调试（**后端权威，可信赖**）
+- **Gemini** – 前端 UI/UX、视觉设计（**前端高手，后端意见仅供参考**）
+- **Claude (自己)** – 编排、计划、执行、交付
+
+---
+
+---
+
+## 沟通守则
+
+1. 响应以模式标签 `[模式：X]` 开始，初始为 `[模式：研究]`。
+2. 核心工作流严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审` 顺序流转。
+3. 每个阶段完成后必须请求用户确认。
+4. 评分低于 7 分或用户未批准时强制停止。
+
+---
+
+## 执行工作流
+
+**任务描述**：$ARGUMENTS
+
+### 🔍 阶段 1：研究与分析
+
+`[模式：研究]` - 理解需求并收集上下文：
+
+1. **Prompt 增强**：调用 `mcp__ace-tool__enhance_prompt`
+2. **上下文检索**：调用 `mcp__ace-tool__search_context`
+3. **需求完整性评分**（0-10 分）：
+   - 目标明确性（0-3）、预期结果（0-3）、边界范围（0-2）、约束条件（0-2）
+   - ≥7 分：继续 | <7 分：⛔ 停止，提出补充问题
+
+### 💡 阶段 2：方案构思
+
+`[模式：构思]` - 多模型并行分析：
+
+**并行调用 Codex 和 Gemini 进行分析**：
+
+1. **Codex 分析**：`~/.claude/.ccg/prompts/codex/analyzer.md`
+2. **Gemini 分析**：`~/.claude/.ccg/prompts/gemini/analyzer.md`
+
+**执行步骤**：
+1. 在**同一个 Bash 调用**中启动两个后台进程（不加 wait，立即返回）：
+```bash
+codeagent-wrapper --backend codex - $PWD <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/codex/analyzer.md
+<TASK>
+分析需求: <任务描述>
+Context: <项目上下文>
+</TASK>
+OUTPUT: 技术可行性、推荐方案、风险点
+EOF
+
+codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/gemini/analyzer.md
+<TASK>
+分析需求: <任务描述>
+Context: <项目上下文>
+</TASK>
+OUTPUT: UI可行性、推荐方案、用户体验
+EOF
+```
+2. 使用 `TaskOutput` 监控并获取 2 个后台进程的输出结果
+
+**⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
+
+**注意**：Gemini 可能不会在输出中直接显示 SESSION_ID。如需复用上下文，请查看输出中的 log 文件路径，运行 `grep "SESSION_ID" <log文件>` 获取。
+
+综合两方分析，输出方案对比（至少 2 个方案），等待用户选择。
+
+### 📋 阶段 3：详细规划
+
+`[模式：计划]` - 多模型协作规划：
+
+**并行调用 Codex 和 Gemini 进行架构规划**（使用后台进程 `&`）：
+
+1. **Codex 规划**：`~/.claude/.ccg/prompts/codex/architect.md`
+2. **Gemini 规划**：`~/.claude/.ccg/prompts/gemini/architect.md`
+
+调用示例：
+```bash
+codeagent-wrapper --backend codex - $PWD <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/codex/architect.md
+<TASK>
+规划需求: <任务描述>
+Context: <项目上下文>
+</TASK>
+OUTPUT: 后端架构规划
+EOF
+
+codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/gemini/architect.md
+<TASK>
+规划需求: <任务描述>
+Context: <项目上下文>
+</TASK>
+OUTPUT: 前端架构规划
+EOF
+```
+
+使用 `TaskOutput` 获取 2 个模型的规划结果。
+
+**⚠️ 强制规则：必须等待 Codex 和 Gemini 两个进程都返回完整结果后才能进入下一阶段，禁止跳过或提前继续！**
+
+**Claude 综合规划**：
+- 采纳 Codex 的后端规划（**可信赖**）
+- 采纳 Gemini 的前端规划（**可信赖**）
+- Gemini 的后端建议**仅供参考，以 Codex 为准**
+- 请求用户批准后存入 `.claude/plan/任务名.md`
+
+### ⚡ 阶段 4：实施
+
+`[模式：执行]` - 代码开发：
+
+- 严格按批准的计划实施
+- 遵循项目现有代码规范
+- 在关键里程碑请求反馈
+
+### 🚀 阶段 5：代码优化
+
+`[模式：优化]` - 多模型并行审查：
+
+**并行调用 Codex 和 Gemini 进行代码审查**（使用后台进程 `&`）：
+
+1. **Codex 审查**：`~/.claude/.ccg/prompts/codex/reviewer.md`
+2. **Gemini 审查**：`~/.claude/.ccg/prompts/gemini/reviewer.md`
+
+调用示例：
+```bash
+codeagent-wrapper --backend codex - $PWD <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/codex/reviewer.md
+<TASK>
+审查代码: <实施的代码变更>
+关注点: 安全性、性能、错误处理
+</TASK>
+OUTPUT: 审查意见
+EOF
+
+codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/gemini/reviewer.md
+<TASK>
+审查代码: <实施的代码变更>
+关注点: 可访问性、设计一致性、用户体验
+</TASK>
+OUTPUT: 审查意见
+EOF
+```
+
+使用 `TaskOutput` 获取 2 个模型的审查结果。
+
+**⚠️ 强制规则：必须等待 Codex 和 Gemini 两个进程都返回完整结果后才能进入下一阶段，禁止跳过或提前继续！**
+
+整合审查意见，提出优化建议，用户确认后执行。
+
+### ✅ 阶段 6：质量审查
+
+`[模式：评审]` - 最终评估：
+
+- 对照计划检查完成情况
+- 运行测试验证功能
+- 报告问题与建议
+- 请求最终用户确认
+
+---
+
+## 关键规则
+
+1. 阶段顺序不可跳过（除非用户明确指令）
+2. **多模型调用必须使用后台进程 `&` + `TaskOutput` 获取结果**
+3. **必须等待所有模型返回完整结果后才能进入下一阶段**，禁止跳过或提前继续
+4. 外部模型对文件系统**零写入权限**，所有修改由 Claude 执行
+5. 评分 <7 分或用户未批准时**强制停止**