ccg-workflow 1.0.0 → 1.0.2

package/README.md

@@ -1,25 +1,80 @@
-# CCG: 多模型协作系统
+# 【开源缝合】CCG v3.0: Claude Code 编排三 CLI 协作
 
 <div align="center">
 
-**Claude Code + Codex + Gemini 多模型协作工作流系统**
+**Claude Code 主导 + Codex CLI + Gemini CLI + Claude CLI 协作工作流系统**
 
 [![npm version](https://img.shields.io/npm/v/ccg-workflow.svg)](https://www.npmjs.com/package/ccg-workflow)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-green.svg)](https://claude.ai/code)
 
+> **v3.0.0 重大更新**：从 Python 脚本进化为 npm 包，三 CLI 协作时代正式开启！
+
 </div>
 
 ---
 
+## 🎉 v3.0.0 重大更新
+
+### 安装方式革命性升级
+- ✅ 从 Python 脚本重构为 **TypeScript + unbuild** 构建系统
+- ✅ 发布到 npm: **`npx ccg-workflow`** 一键安装
+- ✅ 交互式配置菜单（初始化/更新/卸载）
+- ✅ 更好的跨平台兼容性
+
+### 三 CLI 协作时代
+- ✅ **Claude Code CLI** 作为主导编排者
+- ✅ **Codex CLI** 负责后端原型生成
+- ✅ **Gemini CLI** 负责前端原型生成
+- ✅ **Claude CLI** 子进程负责全栈整合
+- ✅ 新增 6 个 Claude 角色提示词
+- ✅ 从 12 个专家提示词扩展到 **18 个**
+
+### 配置系统升级
+- ✅ 配置文件从 `config.json` 迁移到 `~/.ccg/config.toml`
+- ✅ 支持 **smart/parallel/sequential** 三种协作模式
+- ✅ 可配置前端/后端模型优先级
+
+---
+
+## 架构说明
+
+### Claude Code 主导的三 CLI 协作模式
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Claude Code CLI (主导)                    │
+│                  编排、决策、代码实施                         │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐        │
+│  │  Codex CLI  │  │ Gemini CLI  │  │ Claude CLI  │        │
+│  │  (后端原型) │  │  (前端原型) │  │  (全栈整合) │        │
+│  └─────────────┘  └─────────────┘  └─────────────┘        │
+│                                                             │
+│  通过 codeagent-wrapper 调用，返回 Unified Diff Patch      │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**关键特性**：
+- **Claude Code** 是主对话，负责编排整个工作流、做最终决策、实施代码
+- **Codex/Gemini/Claude 子进程** 通过 `codeagent-wrapper` 调用，生成原型代码
+- **零写入权限**：子进程只能返回 Unified Diff Patch，不能直接修改文件
+- **脏原型处理**：子进程输出视为"脏原型"，需经 Claude Code 重构为生产级代码
+
+---
+
 ## 核心特性
 
 | 特性 | 描述 |
 |------|------|
-| **智能路由** | 前端任务自动路由到 Gemini，后端任务路由到 Codex |
-| **三模型协作** | 同时调用 Claude + Codex + Gemini 进行交叉验证 |
+| **Claude Code 主导** | Claude Code CLI 作为编排者，Codex/Gemini/Claude 子进程协作 |
+| **三 CLI 协作** | 同时调用 Codex CLI + Gemini CLI + Claude CLI 进行交叉验证 |
+| **智能路由** | 前端任务 → Gemini，后端任务 → Codex，全栈整合 → Claude |
 | **Prompt 增强** | 集成 ace-tool MCP，自动优化需求描述 |
-| **6阶段工作流** | Prompt增强 → 上下文检索 → 多模型分析 → 原型生成 → 代码实施 → 审计交付 |
+| **6阶段工作流** | Prompt增强 → 上下文检索 → 三 CLI 分析 → 原型生成 → 代码实施 → 审计交付 |
+| **18个专家提示词** | Codex 6个 + Gemini 6个 + Claude 6个角色 |
 | **交互式安装** | npx 一键运行，图形化配置界面 |
 | **跨平台** | 支持 macOS、Linux、Windows |
 
@@ -148,20 +203,20 @@ pnpm start
 
 ### 开发工作流
 
-| 命令 | 用途 | 模型路由 |
+| 命令 | 用途 | CLI 路由 |
 |------|------|----------|
-| `/ccg:dev` | 完整6阶段开发工作流（含Prompt增强） | Auggie + Codex + Gemini |
-| `/ccg:code` | 多模型代码生成（智能路由） | 前端→Gemini / 后端→Codex |
-| `/ccg:debug` | UltraThink 多模型调试 | Codex + Gemini 并行诊断 |
-| `/ccg:test` | 多模型测试生成 | Codex 后端测试 + Gemini 前端测试 |
-| `/ccg:bugfix` | 质量门控修复（90%+ 通过） | 双模型交叉验证 |
-| `/ccg:think` | 深度分析 | 双模型并行分析 |
-| `/ccg:optimize` | 性能优化 | Codex 后端 + Gemini 前端 |
-| `/ccg:frontend` | 前端/UI/样式任务 | Gemini |
-| `/ccg:backend` | 后端/逻辑/算法任务 | Codex |
-| `/ccg:review` | 代码审查（无参数自动审查 git diff） | Codex + Gemini |
-| `/ccg:analyze` | 技术分析 | Codex + Gemini |
-| `/ccg:enhance` | Prompt 增强 | Auggie MCP |
+| `/ccg:dev` | 完整6阶段开发工作流（含Prompt增强） | ace-tool + Codex + Gemini + Claude |
+| `/ccg:code` | 三 CLI 代码生成（智能路由） | 前端→Gemini / 后端→Codex / 整合→Claude |
+| `/ccg:debug` | UltraThink 三 CLI 调试 | Codex + Gemini + Claude 并行诊断 |
+| `/ccg:test` | 三 CLI 测试生成 | Codex 后端 + Gemini 前端 + Claude 集成 |
+| `/ccg:bugfix` | 质量门控修复（90%+ 通过） | 三 CLI 交叉验证 |
+| `/ccg:think` | 深度分析 | 三 CLI 并行分析 |
+| `/ccg:optimize` | 性能优化 | Codex 后端 + Gemini 前端 + Claude 全栈 |
+| `/ccg:frontend` | 前端/UI/样式任务 | Gemini + Claude 整合 |
+| `/ccg:backend` | 后端/逻辑/算法任务 | Codex + Claude 整合 |
+| `/ccg:review` | 代码审查（无参数自动审查 git diff） | Codex + Gemini + Claude |
+| `/ccg:analyze` | 技术分析 | Codex + Gemini + Claude |
+| `/ccg:enhance` | Prompt 增强 | ace-tool MCP |
 
 ### Git 工具
 
@@ -184,22 +239,23 @@ pnpm start
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│                   /ccg:dev 工作流                            │
+│                   /ccg:dev 工作流（v3.0）                    │
 ├─────────────────────────────────────────────────────────────┤
 │                                                             │
-│  Phase 0: Prompt 增强 (Auggie prompt-enhancer)              │
+│  Phase 0: Prompt 增强 (ace-tool prompt-enhancer)            │
 │      ↓                                                      │
-│  Phase 1: 上下文检索 (Auggie codebase-retrieval)            │
+│  Phase 1: 上下文检索 (ace-tool codebase-retrieval)          │
 │      ↓                                                      │
-│  Phase 2: 多模型分析 (Codex ∥ Gemini) ← 并行执行            │
+│  Phase 2: 三 CLI 分析 (Codex ∥ Gemini ∥ Claude) ← 并行     │
 │      ↓                                                      │
-│  Phase 3: 原型生成                                           │
-│      ├── 前端任务 → Gemini                                  │
-│      └── 后端任务 → Codex                                   │
+│  Phase 3: 三 CLI 原型生成                                    │
+│      ├── 前端任务 → Gemini CLI                              │
+│      ├── 后端任务 → Codex CLI                               │
+│      └── 全栈整合 → Claude CLI                              │
 │      ↓                                                      │
-│  Phase 4: 代码实施 (Claude 重构为生产级代码)                 │
+│  Phase 4: 代码实施 (Claude Code 交叉验证后重构)             │
 │      ↓                                                      │
-│  Phase 5: 审计交付 (Codex ∥ Gemini) ← 并行审查              │
+│  Phase 5: 审计交付 (Codex ∥ Gemini ∥ Claude) ← 并行审查    │
 │                                                             │
 └─────────────────────────────────────────────────────────────┘
 ```
@@ -245,7 +301,7 @@ pnpm start
 
 ```toml
 [general]
-version = "1.0.0"
+version = "3.0.0"
 language = "zh-CN"
 
 [routing]
@@ -361,34 +417,61 @@ TaskOutput: task_id=<task_id>
 
 ---
 
-## 模型分工
+## CLI 分工
 
-| 模型 | 擅长领域 | 使用场景 |
+| CLI | 擅长领域 | 使用场景 |
 |------|----------|----------|
-| **Gemini** | 前端、UI/UX、视觉设计 | CSS、React、Vue 组件 |
-| **Codex** | 后端、算法、调试 | API、业务逻辑、性能优化 |
-| **Claude** | 编排、重构、交付 | 工作流控制、代码审核 |
-| **Auggie** | 代码检索、Prompt 增强 | 上下文获取、需求优化 |
+| **Claude Code** | 编排、决策、代码实施 | 工作流控制、最终代码重构、交付 |
+| **Gemini CLI** | 前端、UI/UX、视觉设计 | CSS、React、Vue 组件原型 |
+| **Codex CLI** | 后端、算法、调试 | API、业务逻辑、性能优化原型 |
+| **Claude CLI** | 全栈整合、交叉验证 | 契约设计、原型整合 |
+| **ace-tool** | 代码检索、Prompt 增强 | 上下文获取、需求优化 |
 
 ---
 
 ## 专家系统提示词
 
-调用外部模型时动态注入相应的角色设定，确保输出质量和一致性。
+调用外部 CLI 时动态注入相应的角色设定，确保输出质量和一致性。
+
+### 18个角色文件
+
+**Codex CLI 角色**（6个）：
+- `prompts/codex/architect.md` - 后端架构师
+- `prompts/codex/analyzer.md` - 技术分析师
+- `prompts/codex/debugger.md` - 调试专家
+- `prompts/codex/tester.md` - 测试工程师
+- `prompts/codex/reviewer.md` - 代码审查员
+- `prompts/codex/optimizer.md` - 性能优化专家
+
+**Gemini CLI 角色**（6个）：
+- `prompts/gemini/frontend.md` - 前端开发专家
+- `prompts/gemini/analyzer.md` - 设计分析师
+- `prompts/gemini/debugger.md` - UI调试专家
+- `prompts/gemini/tester.md` - 前端测试工程师
+- `prompts/gemini/reviewer.md` - UI审查员
+- `prompts/gemini/optimizer.md` - 前端性能优化专家
+
+**Claude CLI 角色**（6个）：
+- `prompts/claude/architect.md` - 全栈架构师
+- `prompts/claude/analyzer.md` - 综合分析师
+- `prompts/claude/debugger.md` - 全栈调试专家
+- `prompts/claude/tester.md` - 集成测试工程师
+- `prompts/claude/reviewer.md` - 代码质量审查员
+- `prompts/claude/optimizer.md` - 全栈性能优化专家
 
 ### 角色文件结构
 
 每个命令根据任务类型注入不同的角色提示词：
 
-| 命令 | Codex 角色 | Gemini 角色 |
-|------|-----------|-------------|
-| `/ccg:code`, `/ccg:backend` | `prompts/codex/architect.md` | - |
-| `/ccg:frontend` | - | `prompts/gemini/frontend.md` |
-| `/ccg:analyze`, `/ccg:think`, `/ccg:dev` | `prompts/codex/analyzer.md` | `prompts/gemini/analyzer.md` |
-| `/ccg:debug` | `prompts/codex/debugger.md` | `prompts/gemini/debugger.md` |
-| `/ccg:test` | `prompts/codex/tester.md` | `prompts/gemini/tester.md` |
-| `/ccg:review`, `/ccg:bugfix` | `prompts/codex/reviewer.md` | `prompts/gemini/reviewer.md` |
-| `/ccg:optimize` | `prompts/codex/optimizer.md` | `prompts/gemini/optimizer.md` |
+| 命令 | Codex 角色 | Gemini 角色 | Claude 角色 |
+|------|-----------|-------------|-------------|
+| `/ccg:code`, `/ccg:backend` | `architect.md` | - | `architect.md` |
+| `/ccg:frontend` | - | `frontend.md` | `architect.md` |
+| `/ccg:analyze`, `/ccg:think`, `/ccg:dev` | `analyzer.md` | `analyzer.md` | `analyzer.md` |
+| `/ccg:debug` | `debugger.md` | `debugger.md` | `debugger.md` |
+| `/ccg:test` | `tester.md` | `tester.md` | `tester.md` |
+| `/ccg:review`, `/ccg:bugfix` | `reviewer.md` | `reviewer.md` | `reviewer.md` |
+| `/ccg:optimize` | `optimizer.md` | `optimizer.md` | `optimizer.md` |
 
 ### 动态角色注入
 
@@ -413,8 +496,9 @@ EOF
 
 ### 完整提示词文件
 
-- **Codex 角色**: `prompts/codex/` 目录下的 6 个文件
-- **Gemini 角色**: `prompts/gemini/` 目录下的 6 个文件
+- **Codex CLI 角色**: `prompts/codex/` 目录下的 6 个文件
+- **Gemini CLI 角色**: `prompts/gemini/` 目录下的 6 个文件
+- **Claude CLI 角色**: `prompts/claude/` 目录下的 6 个文件
 
 ---
 
@@ -431,4 +515,4 @@ Copyright (c) 2025 fengshao1227
 - **[cexll/myclaude](https://github.com/cexll/myclaude)** - codeagent-wrapper 多后端调用工具的 Go 代码来源，以及 `/ccg:code`、`/ccg:debug`、`/ccg:test`、`/ccg:bugfix`、`/ccg:think`、`/ccg:optimize` 命令的设计参考
 - **[UfoMiao/zcf](https://github.com/UfoMiao/zcf)** - Git 工具（commit、rollback、clean-branches、worktree）和项目初始化（init）命令来源
 - **[GudaStudio/skills](https://github.com/GuDaStudio/skills)** - 智能路由（前端→Gemini、后端→Codex）的设计理念
-- **[linux.do 社区](https://linux.do/t/topic/1280612)** - Auggie MCP prompt-enhancer 补丁
+- **[ace-tool MCP](https://linux.do/t/topic/1344562)** - [@mistripple](https://linux.do/u/mistripple) 的 ace-tool 轻量级代码检索和 Prompt 增强方案

package/dist/cli.mjs

@@ -11,7 +11,7 @@ import 'node:url';
 import 'ora';
 import 'smol-toml';
 
-const version = "1.0.0";
+const version = "1.0.2";
 
 function customizeHelp(sections) {
   sections.unshift({

package/package.json

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

package/templates/commands/_config.md

@@ -34,11 +34,13 @@ strategy = "parallel"
 
 ## 调用语法模板
 
+**⚠️ 重要**: 使用 `Bash` 工具调用 `codeagent-wrapper`，**不要**使用 `/collaborating-with-codex` 或 `/collaborating-with-gemini` 等旧的 Skill 方式！
+
 ### 基础模式
 ```bash
 codeagent-wrapper --backend <MODEL> - $PROJECT_DIR <<'EOF'
 <ROLE>
-{{读取 prompts/<model>/<role>.md 注入}}
+{{读取 ~/.claude/prompts/ccg/<model>/<role>.md 注入}}
 </ROLE>
 
 <TASK>

package/templates/commands/analyze.md

@@ -37,7 +37,9 @@ You are the **Analysis Coordinator** orchestrating multi-model research. You dir
 1. **读取 `~/.ccg/config.toml`** 获取模型配置
 2. 合并 `routing.frontend.models` 和 `routing.backend.models` 获取分析模型列表
 3. 如果配置不存在，默认使用 `["codex", "gemini"]`
-4. Call `mcp__ace-tool__search_context` to understand relevant code
+4. 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
 
 ### Step 2: 并行分析

package/templates/commands/backend.md

@@ -35,7 +35,9 @@ You are the **Backend Orchestrator** specializing in server-side logic. You coor
 3. If config doesn't exist, default to `codex`
 
 ### Step 2: 上下文检索
-1. Call `mcp__ace-tool__search_context` 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
 
 ### Step 3: 模型原型生成

package/templates/commands/bugfix.md

@@ -15,7 +15,9 @@ description: 质量门控修复（双模型交叉验证，90%+ 通过）
 ## 流程
 
 ### Phase 1: Bug 分析
-1. 调用 `mcp__ace-tool__search_context` 检索相关代码
+1. 调用 `mcp__ace-tool__search_context` 检索相关代码:
+   - `project_root_path`: 项目根目录绝对路径
+   - `query`: Bug 的自然语言描述
 2. 分析 bug 类型：前端/后端/全栈
 3. 收集复现步骤、错误日志、预期行为
 

package/templates/commands/code.md

@@ -16,7 +16,9 @@ description: 三模型代码生成（Codex + Gemini + Claude 并行原型，集
 
 ### Phase 1: 需求分析
 
-1. 调用 `mcp__ace-tool__search_context` 检索：
+1. 调用 `mcp__ace-tool__search_context` 检索:
+   - `project_root_path`: 项目根目录绝对路径
+   - `query`: 功能需求的自然语言描述
    - 相关模块和文件结构
    - 现有代码模式和风格
    - 依赖和接口定义

package/templates/commands/debug.md

@@ -16,7 +16,9 @@ description: UltraThink 多模型调试（Codex 后端诊断 + Gemini 前端诊
 
 ### Phase 1: 上下文检索
 
-1. 调用 `mcp__ace-tool__search_context` 检索相关代码
+1. 调用 `mcp__ace-tool__search_context` 检索相关代码:
+   - `project_root_path`: 项目根目录绝对路径
+   - `query`: 问题的自然语言描述
 2. 收集错误日志、堆栈信息、复现步骤
 3. 识别问题涉及的模块（前端/后端/全栈）
 

package/templates/commands/dev.md

@@ -50,7 +50,10 @@ strategy = "parallel"
 ### 阶段 0: 读取配置 + Prompt 增强
 1. **读取 `~/.ccg/config.toml`** 获取模型路由配置
 2. 如果配置不存在，使用默认值：frontend=gemini, backend=codex
-3. 调用 `mcp__ace-tool__enhance_prompt` 优化原始需求
+3. 调用 `mcp__ace-tool__enhance_prompt` 优化原始需求:
+   - `prompt`: 用户的原始需求 ($ARGUMENTS)
+   - `conversation_history`: 最近的对话历史(5-10轮对话)
+   - `project_root_path`: 当前项目根目录绝对路径
 4. 向用户展示原始和增强后的 prompt:
 
 ```
@@ -74,7 +77,9 @@ strategy = "parallel"
    - 如果 N: 使用原始 prompt 或要求修改
 
 ### 阶段 1: 上下文检索
-1. 调用 `mcp__ace-tool__search_context` 获取（增强后的）需求相关代码
+1. 调用 `mcp__ace-tool__search_context` 获取（增强后的）需求相关代码:
+   - `project_root_path`: 项目根目录绝对路径
+   - `query`: 增强后的需求描述
 2. 识别所有相关文件、类、函数和依赖
 3. 如需求仍不清晰，提出澄清问题
 
@@ -82,9 +87,27 @@ strategy = "parallel"
 
 **根据配置并行调用模型进行分析**（使用 `run_in_background: true` 非阻塞执行）：
 
+**调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`（不要使用 `/collaborating-with-codex` 或 `/collaborating-with-gemini`）
+
+```bash
+# 后端模型分析示例
+codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
+<ROLE>
+{{读取 ~/.claude/prompts/ccg/codex/analyzer.md 内容}}
+</ROLE>
+
+<TASK>
+分析需求: {{增强后的需求}}
+Context: {{从 ace-tool 获取的代码上下文}}
+</TASK>
+
+OUTPUT: Structured analysis/diagnostic report.
+EOF
+```
+
 根据 `routing.backend.models` 和 `routing.frontend.models` 动态生成调用：
-- **后端模型**: 使用 `analyzer` 角色，输出实现方案
-- **前端模型**: 使用 `analyzer` 角色，输出实现方案
+- **后端模型**: 使用 Bash 调用 `codeagent-wrapper --backend codex/gemini/claude` + `analyzer` 角色
+- **前端模型**: 使用 Bash 调用 `codeagent-wrapper --backend gemini/codex/claude` + `analyzer` 角色
 
 然后使用 `TaskOutput` 获取所有任务的结果，交叉验证后综合方案。
 
@@ -94,10 +117,28 @@ strategy = "parallel"
 
 **三模型并行生成原型**（使用 `run_in_background: true`）：
 
+**调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
+
+```bash
+# Codex 后端原型示例
+codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
+<ROLE>
+{{读取 ~/.claude/prompts/ccg/codex/architect.md 内容}}
+</ROLE>
+
+<TASK>
+生成原型: {{功能需求}}
+Context: {{相关代码}}
+</TASK>
+
+OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
+EOF
+```
+
 根据 `routing.prototype.models` 配置，同时调用三个模型：
-- **Codex** + `architect` 角色 → 后端架构视角的原型
-- **Gemini** + `frontend` 角色 → 前端 UI 视角的原型
-- **Claude** + `architect` 角色 → 全栈整合视角的原型
+- **Codex**: `codeagent-wrapper --backend codex` + `architect` 角色 → 后端架构视角的原型
+- **Gemini**: `codeagent-wrapper --backend gemini` + `frontend` 角色 → 前端 UI 视角的原型
+- **Claude**: `codeagent-wrapper --backend claude` + `architect` 角色 → 全栈整合视角的原型
 
 输出: `Unified Diff Patch ONLY`
 
@@ -123,10 +164,27 @@ strategy = "parallel"
 
 **三模型并行代码审查**（使用 `run_in_background: true`）：
 
+**调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
+
+```bash
+# Codex 代码审查示例
+codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
+<ROLE>
+{{读取 ~/.claude/prompts/ccg/codex/reviewer.md 内容}}
+</ROLE>
+
+<TASK>
+审查代码: {{实施的代码变更}}
+</TASK>
+
+OUTPUT: Review comments only. No code modifications.
+EOF
+```
+
 根据 `routing.review.models` 配置调用所有模型：
-- **Codex** + `reviewer` 角色 → 安全性、性能、错误处理
-- **Gemini** + `reviewer` 角色 → 可访问性、响应式设计、设计一致性
-- **Claude** + `reviewer` 角色 → 集成正确性、契约一致性、可维护性
+- **Codex**: `codeagent-wrapper --backend codex` + `reviewer` 角色 → 安全性、性能、错误处理
+- **Gemini**: `codeagent-wrapper --backend gemini` + `reviewer` 角色 → 可访问性、响应式设计、设计一致性
+- **Claude**: `codeagent-wrapper --backend claude` + `reviewer` 角色 → 集成正确性、契约一致性、可维护性
 
 输出: `Review comments only`
 

package/templates/commands/enhance.md

@@ -15,7 +15,10 @@ You are the **Prompt Enhancer** that optimizes user prompts for better AI task e
 ## Process
 
 ### Step 1: Enhance Prompt
-1. Call `mcp__ace-tool__enhance_prompt` with the original prompt
+1. Call `mcp__ace-tool__enhance_prompt` with:
+   - `prompt`: The original user prompt ($ARGUMENTS)
+   - `conversation_history`: Recent conversation history (5-10 turns)
+   - `project_root_path`: Current project root directory (optional)
 2. Extract the enhanced version
 
 ### Step 2: User Confirmation (寸止)

package/templates/commands/frontend.md

@@ -35,7 +35,9 @@ You are the **Frontend Orchestrator** specializing in UI/UX implementation. You
 3. If config doesn't exist, default to `gemini`
 
 ### Step 2: 上下文检索
-1. Call `mcp__ace-tool__search_context` to find existing UI components, styles, and patterns
+1. Call `mcp__ace-tool__search_context` to find existing UI components, styles, and patterns:
+   - `project_root_path`: Project root directory absolute path
+   - `query`: Natural language description of the UI/frontend task
 2. Identify the design system, component library, and styling conventions in use
 
 ### Step 3: 模型原型生成

package/templates/commands/optimize.md

@@ -15,7 +15,9 @@ description: 多模型性能优化（Codex 后端优化 + Gemini 前端优化）
 ## 流程
 
 ### Phase 1: 性能基线分析
-1. 调用 `mcp__ace-tool__search_context` 检索目标代码
+1. 调用 `mcp__ace-tool__search_context` 检索目标代码:
+   - `project_root_path`: 项目根目录绝对路径
+   - `query`: 需要优化的目标代码描述
 2. 识别性能关键路径
 3. 收集现有指标（如有）：
    - 后端: 响应时间、查询耗时、内存占用

package/templates/commands/review.md

@@ -46,7 +46,9 @@ git status --short
 
 **If arguments provided**, use the specified code/description.
 
-Then call `mcp__ace-tool__search_context` to get related context.
+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
 
 ### Step 2: 并行审查
 

package/templates/commands/test.md

@@ -14,7 +14,9 @@ description: 多模型测试生成（Codex 后端测试 + Gemini 前端测试）
 ## 流程
 
 ### Phase 1: 测试分析
-1. 调用 `mcp__ace-tool__search_context` 检索：
+1. 调用 `mcp__ace-tool__search_context` 检索:
+   - `project_root_path`: 项目根目录绝对路径
+   - `query`: 需要测试的代码/功能描述
    - 目标代码的完整实现
    - 现有测试文件和测试框架
    - 项目测试配置（jest.config, pytest.ini 等）

package/templates/commands/think.md

@@ -15,7 +15,9 @@ description: UltraThink 深度分析（双模型并行分析 + 综合见解）
 ## 流程
 
 ### Phase 1: 上下文收集
-1. 调用 `mcp__ace-tool__search_context` 检索相关代码
+1. 调用 `mcp__ace-tool__search_context` 检索相关代码:
+   - `project_root_path`: 项目根目录绝对路径
+   - `query`: 需要深度分析的问题描述
 2. 识别分析范围和关键组件
 3. 列出已知约束和假设