ccg-workflow 1.5.0 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Claude-Codex-Gemini 多模型协作系统 - 智能路由多模型开发工作流",
   "type": "module",
   "packageManager": "pnpm@10.17.1",

package/templates/commands/agents/planner.md

@@ -1,7 +1,7 @@
 ---
 name: planner
 description: 📋 任务规划师 - 使用 WBS 方法论分解功能需求为可执行任务
-tools: Read, Write, {{MCP_SEARCH_TOOL}}
+tools: Read, Write, mcp__ace-tool__search_context
 color: blue
 ---
 
@@ -29,7 +29,7 @@ color: blue
 如果需要了解现有实现，使用 ace-tool 检索：
 
 ```
-{{MCP_SEARCH_TOOL}} {
+mcp__ace-tool__search_context {
   "project_root_path": "{{项目路径}}",
   "query": "{{相关功能关键词}}"
 }

package/templates/commands/agents/ui-ux-designer.md

@@ -1,7 +1,7 @@
 ---
 name: ui-ux-designer
 description: 🎨 UI/UX 设计师 - 为前端功能生成页面结构、组件拆分和交互流程设计
-tools: Read, Write, {{MCP_SEARCH_TOOL}}
+tools: Read, Write, mcp__ace-tool__search_context
 color: magenta
 ---
 
@@ -30,7 +30,7 @@ color: magenta
 如果项目已有组件库，使用 ace-tool 检索：
 
 ```
-{{MCP_SEARCH_TOOL}} {
+mcp__ace-tool__search_context {
   "project_root_path": "{{项目路径}}",
   "query": "可复用的 UI 组件、按钮、表单、卡片、布局组件"
 }

package/templates/commands/analyze.md

@@ -2,8 +2,6 @@
 description: 多模型技术分析（并行执行），交叉验证后综合见解
 ---
 
-> 调用语法见 `_config.md`
-
 ## 用法
 `/analyze <QUESTION_OR_TASK>`
 
@@ -22,7 +20,7 @@ You are the **Analysis Coordinator** orchestrating multi-model research. You dir
 
 ### Step 1: 上下文检索
 
-1. Call `{{MCP_SEARCH_TOOL}}` to understand relevant code:
+1. Call `mcp__ace-tool__search_context` to understand relevant code:
    - `project_root_path`: Project root directory absolute path
    - `query`: Natural language description of what to analyze
 5. Identify key files, patterns, and architecture

package/templates/commands/backend.md

@@ -2,8 +2,6 @@
 description: 后端/逻辑/算法任务，自动路由到配置的后端模型进行原型生成和审计
 ---
 
-> 调用语法见 `_config.md`
-
 ## 用法
 `/backend <LOGIC_TASK_DESCRIPTION>`
 
@@ -12,6 +10,46 @@ description: 后端/逻辑/算法任务，自动路由到配置的后端模型
 - This command routes to your configured backend models.
 - Default authority for algorithms, APIs, and business logic.
 
+## ⭐ v1.6.0 重大升级
+
+**从单模型调用升级为多模型并行工作流！**
+
+### 新增功能
+
+✅ **5阶段完整工作流**：
+- Step 1: 上下文检索（MCP）
+- Step 2: **多模型后端分析**（Codex + Gemini 并行） ← 新增
+- Step 3: **多模型原型生成**（所有后端模型并行） ← 增强
+- Step 4: 重构与实施（Claude 综合各模型优势）
+- Step 5: **多模型审计交付**（Codex + Gemini 交叉验证） ← 新增
+
+✅ **交叉验证机制**：
+- Codex 提供深度后端专业知识（算法、调试）
+- Gemini 提供现代架构视角
+- Claude 综合各家所长，重构为生产级代码
+
+✅ **强制用户确认**：
+- Step 2 分析完成后，会询问"是否继续执行此方案？(Y/N)"
+- 避免盲目执行，确保用户对方案满意
+
+### 与 /ccg:dev 的区别
+
+| 特性 | /ccg:backend | /ccg:dev |
+|------|-------------|----------|
+| **模型范围** | 仅后端模型（Codex + Gemini）| 全部模型（前端+后端）|
+| **适用场景** | 后端专项任务 | 全栈功能开发 |
+| **Prompt 增强** | ❌ 不包含 | ✅ Phase 0 |
+| **工作流阶段** | 5 阶段 | 6 阶段（含 Prompt 增强）|
+| **推荐用户** | 后端开发者 | 全栈开发者 |
+
+### 使用建议
+
+- 🎯 **纯后端任务**：使用 `/ccg:backend`（如：API 设计、数据库优化、算法实现）
+- 🎯 **全栈功能**：使用 `/ccg:dev`（如：用户登录功能，涉及前后端）
+- 🎯 **需要 Prompt 增强**：使用 `/ccg:dev`（复杂需求，需先优化需求描述）
+
+---
+
 ## 你的角色
 You are the **Backend Orchestrator** specializing in server-side logic. You coordinate:
 1. **ace-tool** – for retrieving existing backend code and architecture
@@ -21,47 +59,137 @@ You are the **Backend Orchestrator** specializing in server-side logic. You coor
 ## 流程
 
 ### Step 1: 上下文检索
-1. Call `{{MCP_SEARCH_TOOL}}` to understand existing architecture:
+1. Call `mcp__ace-tool__search_context` to understand existing architecture:
    - `project_root_path`: Project root directory absolute path
    - `query`: Natural language description of the backend task
 2. Identify API patterns, data models, services, and dependencies
+3. 如需求仍不清晰，提出澄清问题
+
+### Step 2: 多模型后端分析
 
-### Step 2: 调用后端模型生成原型
+**并行调用所有配置的后端模型进行分析**（使用 `run_in_background: true`）：
 
-使用配置的后端主模型 ({{BACKEND_PRIMARY}}) 生成后端原型：
+遍历 {{BACKEND_MODELS}} 中的每个模型进行后端分析：
+- 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/analyzer.md`
+- 输出：`Structured analysis/diagnostic report`
 
+**总共并行调用次数**: {{BACKEND_MODELS}} 长度（例如：配置 codex + gemini = 2次）
+
+调用示例：
 ```bash
-codeagent-wrapper --backend {{BACKEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/architect.md
+# 遍历后端模型列表（假设配置了 codex 和 gemini）
+for model in codex gemini; do
+  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/$model/analyzer.md
 
 <TASK>
-实现后端功能: {{后端任务描述}}
+分析后端需求: {{后端任务描述}}
 Context: {{从 MCP 获取的 API 架构和数据模型}}
+关注点:
+- API 设计和 RESTful 规范
+- 数据模型和关系设计
+- 业务逻辑复杂度
+- 性能瓶颈和优化点
+- 安全风险和防护措施
+</TASK>
+
+OUTPUT: Structured analysis/diagnostic report.
+EOF
+done
+```
+
+使用 `TaskOutput` 获取所有模型的分析结果，交叉验证后综合方案。
+
+**强制停止**: 询问用户 **"是否继续执行此方案？(Y/N)"** 并等待确认
+
+### Step 3: 多模型原型生成
+
+**并行调用所有配置的后端模型生成原型**（使用 `run_in_background: true`）：
+
+遍历 {{BACKEND_MODELS}} 中的每个模型生成后端原型：
+- 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/architect.md`
+- 输出：`Unified Diff Patch ONLY`
+
+**总共并行调用次数**: {{BACKEND_MODELS}} 长度（例如：配置 codex + gemini = 2次）
+
+调用示例：
+```bash
+# 遍历后端模型生成原型
+for model in $(echo '{{BACKEND_MODELS}}' | jq -r '.[]'); do
+  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/$model/architect.md
+
+<TASK>
+生成后端原型: {{后端任务描述}}
+Context: {{相关代码和架构}}
+实现要点:
+- 遵循现有 API 设计模式
+- 实现完整的错误处理
+- 添加必要的参数验证
+- 考虑并发和性能
 </TASK>
 
 OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
 EOF
+done
 ```
 
+使用 `TaskOutput` 收集所有模型的原型结果。
+
 ### Step 4: 重构与实施
-1. Review model prototype(s) as "dirty prototype"
-2. If multiple models, cross-validate and select best patterns
-3. Refactor into clean, maintainable code
-4. Ensure proper error handling and security
+1. 将所有模型的原型视为"脏原型" – 仅作参考
+2. **交叉验证所有模型结果，集各家所长**：
+   - 分析每个模型的优势和不足
+   - Codex 通常在算法和调试上更强
+   - Gemini 可能提供更现代的架构思路
+   - 选择最佳实现方案或综合创新点
+3. 重构为干净的生产级代码
+4. 确保正确的错误处理和安全性
+5. 验证变更不会引入副作用
+
+### Step 5: 多模型审计交付
+
+**并行调用所有配置的后端模型进行审计**（使用 `run_in_background: true`）：
+
+遍历 {{BACKEND_MODELS}} 中的每个模型进行代码审查：
+- 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/reviewer.md`
+- 输出：`Review comments only`
+
+**总共并行调用次数**: {{BACKEND_MODELS}} 长度（例如：配置 codex + gemini = 2次）
+
+调用示例：
+```bash
+# 遍历后端模型列表进行审计
+for model in $(echo '{{BACKEND_MODELS}}' | jq -r '.[]'); do
+  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/$model/reviewer.md
+
+<TASK>
+审查后端代码: {{实施的代码变更}}
+关注点:
+- 安全性（SQL 注入、XSS、CSRF 等）
+- 性能（N+1 查询、缓存策略）
+- 错误处理（异常捕获、日志记录）
+- 代码质量（可读性、可维护性）
+- API 规范（RESTful 设计、HTTP 状态码）
+</TASK>
+
+OUTPUT: Review comments only. No code modifications.
+EOF
+done
+```
 
-### Step 5: 审计
+使用 `TaskOutput` 收集所有模型的审计结果，交叉验证后提供综合反馈。
 
-Call configured backend model(s) to review the final implementation:
-- 使用 `reviewer` 角色
-- 审查内容: security, performance, error handling
-- 输出: `Review comments only`
+**最终交付**: 根据审计反馈进行必要的调整，确保代码达到生产级质量。
 
 ## 输出格式
-1. **Configuration** – models and strategy being used
-2. **Architecture Analysis** – existing patterns and dependencies
-3. **Model Prototype(s)** – raw prototypes from configured models
-4. **Refined Implementation** – production-ready backend code
-5. **Audit Feedback** – security and performance review
+1. **Configuration** – 使用的模型和策略 ({{BACKEND_MODELS}})
+2. **Architecture Analysis** – 现有模式和依赖关系
+3. **Multi-Model Analysis** – 所有后端模型的分析报告（交叉验证）
+4. **Multi-Model Prototypes** – 所有后端模型的原型（交叉验证）
+5. **Refined Implementation** – 综合各模型优势的生产级代码
+6. **Multi-Model Audit** – 所有后端模型的审计反馈（交叉验证）
 
 ## 注意事项
 - Codex excels at complex logic and debugging

package/templates/commands/bugfix.md

@@ -2,8 +2,6 @@
 description: 质量门控修复（双模型交叉验证，90%+ 通过）
 ---
 
-> 调用语法见 `_config.md`
-
 ## 用法
 `/bugfix <bug描述>`
 
@@ -15,7 +13,7 @@ description: 质量门控修复（双模型交叉验证，90%+ 通过）
 ## 流程
 
 ### Phase 1: Bug 分析
-1. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码:
+1. 调用 `mcp__ace-tool__search_context` 检索相关代码:
    - `project_root_path`: 项目根目录绝对路径
    - `query`: Bug 的自然语言描述
 2. 分析 bug 类型：前端/后端/全栈

package/templates/commands/code.md

@@ -2,8 +2,6 @@
 description: 三模型代码生成（Codex + Gemini + Claude 并行原型，集各家所长）
 ---
 
-> 调用语法见 `_config.md`
-
 ## 用法
 `/code <功能描述>`
 
@@ -16,7 +14,7 @@ description: 三模型代码生成（Codex + Gemini + Claude 并行原型，集
 
 ### Phase 1: 需求分析
 
-1. 调用 `{{MCP_SEARCH_TOOL}}` 检索:
+1. 调用 `mcp__ace-tool__search_context` 检索:
    - `project_root_path`: 项目根目录绝对路径
    - `query`: 功能需求的自然语言描述
    - 相关模块和文件结构

package/templates/commands/debug.md

@@ -2,8 +2,6 @@
 description: UltraThink 多模型调试（Codex 后端诊断 + Gemini 前端诊断）
 ---
 
-> 调用语法见 `_config.md`
-
 ## 用法
 `/debug <问题描述>`
 
@@ -16,7 +14,7 @@ description: UltraThink 多模型调试（Codex 后端诊断 + Gemini 前端诊
 
 ### Phase 1: 上下文检索
 
-1. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码:
+1. 调用 `mcp__ace-tool__search_context` 检索相关代码:
    - `project_root_path`: 项目根目录绝对路径
    - `query`: 问题的自然语言描述
 2. 收集错误日志、堆栈信息、复现步骤

package/templates/commands/dev.md

@@ -2,8 +2,6 @@
 description: 完整6阶段多模型协作工作流（Prompt增强 → 上下文检索 → 多模型分析 → 原型生成 → 代码实施 → 审计交付）
 ---
 
-> 调用语法见 `_config.md`
-
 ## 用法
 `/dev <功能描述>`
 
@@ -13,7 +11,7 @@ description: 完整6阶段多模型协作工作流（Prompt增强 → 上下文
 
 ## 你的角色
 你是**编排者**，协调三模型协作系统。你指挥:
-1. **MCP 工具** – 代码库检索和 Prompt 增强（已配置为 `{{MCP_SEARCH_TOOL}}` 和 `{{MCP_ENHANCE_TOOL}}`）
+1. **ace-tool MCP** – 代码库检索 (`search_context`) 和 Prompt 增强 (`enhance_prompt`)
 2. **Codex** – 后端逻辑、算法、调试专家
 3. **Gemini** – 前端 UI/UX、视觉设计专家
 4. **Claude (子进程)** – 全栈整合、契约设计、跨层问题
@@ -22,8 +20,11 @@ description: 完整6阶段多模型协作工作流（Prompt增强 → 上下文
 ## 流程
 
 ### 阶段 0: Prompt 增强
-1. **Prompt 增强**（调用 `{{MCP_ENHANCE_TOOL}}`）:
-   - 参数：`{{MCP_ENHANCE_PARAM}}`（用户的原始需求），`conversation_history`（最近 5-10 轮对话，可选），`project_root_path`（当前项目根目录，可选）
+1. **Prompt 增强**（调用 `mcp__ace-tool__enhance_prompt`）:
+   - 参数：
+     - `prompt`（必需）：用户的原始需求
+     - `conversation_history`（可选）：最近 5-10 轮对话历史
+     - `project_root_path`（可选）：当前项目根目录绝对路径
    - 如果工具不可用，直接使用原始 prompt
 
 2. 向用户展示原始和增强后的 prompt:
@@ -49,46 +50,45 @@ description: 完整6阶段多模型协作工作流（Prompt增强 → 上下文
    - 如果 N: 使用原始 prompt 或要求修改
 
 ### 阶段 1: 上下文检索
-1. **代码库检索**（调用 `{{MCP_SEARCH_TOOL}}`）:
-   - 参数：`{{MCP_SEARCH_PARAM}}`（增强后的需求描述）
-   - 对于 ace-tool：还需要 `project_root_path`（项目根目录绝对路径）
+1. **代码库检索**（调用 `mcp__ace-tool__search_context`）:
+   - 参数：
+     - `project_root_path`（必需）：项目根目录的绝对路径
+     - `query`（必需）：增强后的需求描述（自然语言）
 2. 识别所有相关文件、类、函数和依赖
 3. 如需求仍不清晰，提出澄清问题
 
 ### 阶段 2: 多模型分析
 
-**并行调用以下模型进行分析**（使用 `run_in_background: true` 非阻塞执行）：
-- 前端分析: {{FRONTEND_PRIMARY}}
-- 后端分析: {{BACKEND_PRIMARY}}
-
-**调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
+**并行调用 codex 和 gemini 进行分析**（使用 `run_in_background: true`）：
 
-**并行调用所有配置的模型进行分析**（使用 `run_in_background: true`）：
-
-1. **后端模型**：遍历 {{BACKEND_MODELS}} 中的每个模型
-   - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/analyzer.md`
+1. **Codex 分析**：`~/.claude/.ccg/prompts/codex/analyzer.md`
    - 输出：`Structured analysis/diagnostic report`
 
-2. **前端模型**：遍历 {{FRONTEND_MODELS}} 中的每个模型
-   - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/analyzer.md`
+2. **Gemini 分析**：`~/.claude/.ccg/prompts/gemini/analyzer.md`
    - 输出：`Structured analysis/diagnostic report`
 
 调用示例：
 ```bash
-# 遍历后端模型列表（假设配置了 codex 和 gemini）
-for model in codex gemini; do
-  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
-ROLE_FILE: ~/.claude/.ccg/prompts/$model/analyzer.md
+codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/codex/analyzer.md
+<TASK>
+分析需求: {{增强后的需求}}
+Context: {{从 MCP 获取的代码上下文}}
+</TASK>
+OUTPUT: Structured analysis/diagnostic report.
+EOF
+
+codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF' &
+ROLE_FILE: ~/.claude/.ccg/prompts/gemini/analyzer.md
 <TASK>
 分析需求: {{增强后的需求}}
 Context: {{从 MCP 获取的代码上下文}}
 </TASK>
 OUTPUT: Structured analysis/diagnostic report.
 EOF
-done
 ```
 
-使用 `TaskOutput` 获取所有模型的分析结果，交叉验证后综合方案。
+使用 `TaskOutput` 获取 2 个模型的分析结果，交叉验证后综合方案。
 
 **强制停止**: 询问用户 **"是否继续执行此方案？(Y/N)"** 并等待确认
 
@@ -96,14 +96,17 @@ done
 
 **并行调用所有配置的模型生成原型**（使用 `run_in_background: true`）：
 
-1. **后端模型**：遍历 {{BACKEND_MODELS}} 中的每个模型
+1. **后端模型**：遍历 {{BACKEND_MODELS}} 中的每个模型生成后端原型
    - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/architect.md`
    - 输出：`Unified Diff Patch ONLY`
 
-2. **前端模型**：遍历 {{FRONTEND_MODELS}} 中的每个模型
-   - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/frontend.md`（如无 frontend 角色，使用 architect）
+2. **前端模型**：遍历 {{FRONTEND_MODELS}} 中的每个模型生成前端原型
+   - **优先使用 frontend.md**：如果模型有 `~/.claude/.ccg/prompts/<模型名>/frontend.md`，使用该文件
+   - **降级使用 architect.md**：如果没有 frontend.md，使用 `~/.claude/.ccg/prompts/<模型名>/architect.md`
    - 输出：`Unified Diff Patch ONLY`
 
+**总共并行调用次数**: {{BACKEND_MODELS}} 长度 + {{FRONTEND_MODELS}} 长度（例如：2个后端模型 + 2个前端模型 = 4次）
+
 调用示例：
 ```bash
 # 遍历后端模型生成原型
@@ -138,6 +141,8 @@ done
 - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/reviewer.md`
 - 输出：`Review comments only`
 
+**总共并行调用次数**: {{REVIEW_MODELS}} 长度（例如：2个审查模型 = 2次）
+
 调用示例：
 ```bash
 # 遍历审查模型列表（默认: codex, gemini）

package/templates/commands/feat.md

@@ -40,11 +40,11 @@ tools: Task, Read, Write, Bash, AskUserQuestion, Glob
 
 #### 2.1 上下文检索
 
-调用 {{MCP_SEARCH_TOOL}} 检索相关代码：
+调用 mcp__ace-tool__search_context 检索相关代码：
 
 ```
-{{MCP_SEARCH_TOOL}} {
-  "{{MCP_SEARCH_PARAM}}": "{{用户需求关键词}} + 相关代码实现、API、组件、数据模型、技术栈"
+mcp__ace-tool__search_context {
+  "query": "{{用户需求关键词}} + 相关代码实现、API、组件、数据模型、技术栈"
 }
 ```