ccg-ros2-workflow 1.0.0 → 1.0.2

package/README.md

@@ -7,6 +7,7 @@ ROS2 多模型协作开发工具 - 基于 Claude Code CLI
 - **多模型协作**: Codex (底层控制) + Gemini (上层集成) + Claude (编排)
 - **ROS2 Humble**: 专为物理机器人开发优化
 - **简洁原则**: 信任模型能力，上下文由 MCP 检索
+- **ace-tool MCP**: 自动理解项目结构和代码上下文
 - **跨平台**: macOS / Ubuntu 支持
 
 ## 安装
@@ -22,6 +23,12 @@ npm install -g ccg-ros2-workflow
 ccg-ros2-workflow
 ```
 
+安装程序提供以下选项：
+1. 安装工作流
+2. 配置 API 密钥
+3. 配置 ace-tool MCP
+4. 卸载工作流
+
 ## 前置依赖
 
 需要先安装：
@@ -29,6 +36,7 @@ ccg-ros2-workflow
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
 - [Codex CLI](https://github.com/openai/codex) (可选)
 - [Gemini CLI](https://github.com/google/gemini-cli) (可选)
+- [ace-tool](https://augmentcode.com/) (推荐，提供代码上下文)
 
 ```bash
 # Gemini CLI
@@ -43,6 +51,9 @@ npm install -g @google/gemini-cli
 # 完整工作流
 /ccg:workflow 为移动机器人添加速度限制器
 
+# 智能功能开发
+/ccg:feat 实现 PID 控制器
+
 # 分析任务
 /ccg:analyze 分析控制器实现
 
@@ -55,17 +66,42 @@ npm install -g @google/gemini-cli
 
 ## 命令列表
 
+### 核心工作流
+
+| 命令 | 说明 |
+|------|------|
+| `/ccg:workflow` | 🚀 主工作流 - 6阶段完整开发流程（研究→构思→计划→执行→优化→评审） |
+| `/ccg:plan` | 📋 多模型协作规划 - Codex + Gemini 双模型生成实施计划 |
+| `/ccg:execute` | ⚡ 多模型协作执行 - 根据计划获取原型 → Claude 重构实施 |
+| `/ccg:feat` | ✨ 智能功能开发 - 自动识别输入类型，规划/讨论/实施全流程 |
+
+### 专项开发
+
 | 命令 | 说明 |
 |------|------|
-| `/ccg:workflow` | 6 阶段完整工作流 |
-| `/ccg:analyze` | 双模型并行分析 |
-| `/ccg:plan` | 多模型协作规划 |
-| `/ccg:execute` | 执行实施 |
-| `/ccg:review` | 双模型代码审查 |
-| `/ccg:debug` | 多模型调试 |
-| `/ccg:optimize` | 性能优化 |
-| `/ccg:test` | 测试生成 |
-| `/ccg:commit` | 智能 Git 提交 |
+| `/ccg:frontend` | 🎨 前端专项开发 - Gemini 主导（Python 节点、配置、诊断） |
+| `/ccg:backend` | 🔧 后端专项开发 - Codex 主导（C++ 节点、控制、驱动） |
+
+### 分析与优化
+
+| 命令 | 说明 |
+|------|------|
+| `/ccg:analyze` | 🔍 多模型技术分析 - Codex 底层视角 + Gemini 上层视角交叉验证 |
+| `/ccg:review` | 👀 多模型代码审查 - 双模型交叉验证 git diff |
+| `/ccg:test` | 🧪 多模型测试生成 - Codex 后端测试 / Gemini 前端测试 |
+| `/ccg:debug` | 🐛 多模型调试 - Codex 后端诊断 + Gemini 前端诊断 |
+| `/ccg:optimize` | ⚡ 多模型性能优化 - Codex 后端优化 + Gemini 前端优化 |
+
+### 辅助工具
+
+| 命令 | 说明 |
+|------|------|
+| `/ccg:init` | 🏗️ 初始化项目 AI 上下文 - 生成 CLAUDE.md 索引 |
+| `/ccg:enhance` | 📝 Prompt 优化 - 使用 ace-tool 增强用户提示词 |
+| `/ccg:commit` | 💾 智能 Git 提交 - 分析改动生成 Conventional Commit |
+| `/ccg:rollback` | ⏪ 交互式 Git 回滚 - 安全回滚到历史版本 |
+| `/ccg:clean-branches` | 🧹 清理 Git 分支 - 安全清理已合并/过期分支 |
+| `/ccg:worktree` | 🌲 Git Worktree 管理 - 创建工作树支持 IDE 集成 |
 
 ## 架构
 
@@ -84,6 +120,14 @@ npm install -g @google/gemini-cli
 └───────────────┘   └───────────────┘
 ```
 
+### 模型分工
+
+| 模型 | 职责 | 关键词 |
+|------|------|--------|
+| **Codex** | 底层系统 | 控制算法、运动学/动力学、实时性能、硬件驱动、C++ 节点、安全系统 |
+| **Gemini** | 上层集成 | Launch 文件、YAML 配置、Python 节点、系统诊断、参数管理 |
+| **Claude** | 编排执行 | 综合两个模型输出、执行代码修改、协调工作流 |
+
 ## 配置
 
 安装后配置文件位于：
@@ -93,14 +137,36 @@ npm install -g @google/gemini-cli
 ├── .ccg/
 │   ├── config.toml          # 主配置
 │   └── prompts/             # 提示词
-│       ├── codex/
-│       ├── gemini/
-│       └── claude/
-├── commands/ccg/            # 命令文件
+│       ├── codex/           # 底层分析/架构/审查/调试/优化/测试
+│       ├── gemini/          # 上层分析/架构/审查/调试/优化/测试/前端
+│       └── claude/          # 编排分析/架构/审查/调试/优化/测试
+├── commands/ccg/            # 17 个命令文件
+├── mcp_servers.json         # MCP 配置 (ace-tool)
 └── bin/
     └── codeagent-wrapper    # 模型调用脚本
 ```
 
+## MCP 配置 (ace-tool)
+
+ace-tool 是 Augment Code 的代码上下文引擎，让 AI 自动理解项目结构。
+
+安装时选择「配置 ace-tool MCP」会自动添加到 `~/.claude/mcp_servers.json`：
+
+```json
+{
+  "ace-tool": {
+    "command": "ace-tool",
+    "args": ["mcp"],
+    "env": {}
+  }
+}
+```
+
+使用前需要：
+1. 安装 ace-tool CLI（访问 https://augmentcode.com/）
+2. 运行 `ace-tool login` 登录
+3. 重启 Claude Code
+
 ## 语言配置
 
 | 场景 | 语言 |
@@ -109,6 +175,14 @@ npm install -g @google/gemini-cli
 | 交互 | 中文 |
 | 代码注释 | 中文 |
 
+## ROS2 配置
+
+| 项目 | 值 |
+|------|-----|
+| 发行版 | Humble |
+| 目标 | 物理机器人 |
+| 路由模式 | 智能路由 |
+
 ## 卸载
 
 ```bash

package/bin/cli.js

@@ -9,6 +9,7 @@ const CLAUDE_DIR = path.join(process.env.HOME, '.claude');
 const CCG_DIR = path.join(CLAUDE_DIR, '.ccg');
 const COMMANDS_DIR = path.join(CLAUDE_DIR, 'commands', 'ccg');
 const BIN_DIR = path.join(CLAUDE_DIR, 'bin');
+const MCP_CONFIG_PATH = path.join(CLAUDE_DIR, 'mcp_servers.json');
 const SRC_DIR = path.join(__dirname, '..', 'src');
 
 const rl = readline.createInterface({
@@ -63,10 +64,11 @@ async function main() {
   console.log('\n请选择操作：');
   console.log('1. 安装工作流');
   console.log('2. 配置 API 密钥');
-  console.log('3. 卸载工作流');
-  console.log('4. 退出');
+  console.log('3. 配置 ace-tool MCP');
+  console.log('4. 卸载工作流');
+  console.log('5. 退出');
 
-  const choice = await question('\n请输入选项 (1-4): ');
+  const choice = await question('\n请输入选项 (1-5): ');
 
   switch (choice) {
     case '1':
@@ -76,6 +78,9 @@ async function main() {
       await configureApiKeys();
       break;
     case '3':
+      await configureMCP();
+      break;
+    case '4':
       await uninstall();
       break;
     default:
@@ -129,10 +134,16 @@ async function install() {
     });
   });
 
-  console.log('\n✅ 安装完成！\n');
+  console.log('\n✅ 工作流安装完成！\n');
+
+  // 询问是否配置 MCP
+  const configMcp = await question('是否配置 ace-tool MCP？(推荐，提供代码上下文) (Y/n): ');
+  if (configMcp.toLowerCase() !== 'n') {
+    await configureMCP();
+  }
 
   // 询问是否配置 API
-  const configApi = await question('是否现在配置 API 密钥？ (Y/n): ');
+  const configApi = await question('\n是否配置 API 密钥？ (Y/n): ');
   if (configApi.toLowerCase() !== 'n') {
     await configureApiKeys();
   }
@@ -140,6 +151,68 @@ async function install() {
   console.log('\n📖 使用方法：');
   console.log('  在 Claude Code 中使用 /ccg:workflow <任务描述>');
   console.log('  查看所有命令：/ccg:<Tab>');
+  console.log('\n⚠️  请重启终端或 Claude Code 使配置生效');
+}
+
+async function configureMCP() {
+  console.log('\n🔧 配置 ace-tool MCP\n');
+  console.log('ace-tool 是 Augment Code 的代码上下文引擎');
+  console.log('它能让 AI 自动理解你的项目结构和代码\n');
+
+  // 检查是否已安装 ace-tool
+  let aceToolInstalled = false;
+  try {
+    execSync('which ace-tool', { stdio: 'ignore' });
+    aceToolInstalled = true;
+    console.log('✅ 检测到 ace-tool 已安装\n');
+  } catch {
+    console.log('⚠️  未检测到 ace-tool\n');
+  }
+
+  if (!aceToolInstalled) {
+    console.log('安装 ace-tool 的方式：');
+    console.log('1. 访问 https://augmentcode.com/ 注册账号');
+    console.log('2. 按照官方指引安装 ace-tool CLI\n');
+
+    const proceed = await question('是否继续配置 MCP？(可以稍后安装 ace-tool) (Y/n): ');
+    if (proceed.toLowerCase() === 'n') {
+      return;
+    }
+  }
+
+  // 读取或创建 MCP 配置
+  let mcpConfig = {};
+  if (fs.existsSync(MCP_CONFIG_PATH)) {
+    try {
+      mcpConfig = JSON.parse(fs.readFileSync(MCP_CONFIG_PATH, 'utf8'));
+      console.log('检测到已有 MCP 配置，将添加 ace-tool\n');
+    } catch {
+      mcpConfig = {};
+    }
+  }
+
+  // 添加 ace-tool 配置
+  mcpConfig['ace-tool'] = {
+    command: 'ace-tool',
+    args: ['mcp'],
+    env: {}
+  };
+
+  // 写入配置
+  fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+  fs.writeFileSync(MCP_CONFIG_PATH, JSON.stringify(mcpConfig, null, 2));
+
+  console.log('✅ MCP 配置已写入: ~/.claude/mcp_servers.json\n');
+  console.log('配置内容：');
+  console.log(JSON.stringify(mcpConfig['ace-tool'], null, 2));
+
+  console.log('\n📌 后续步骤：');
+  console.log('1. 确保已安装 ace-tool CLI');
+  console.log('2. 运行 ace-tool login 登录 Augment 账号');
+  console.log('3. 重启 Claude Code 使 MCP 生效');
+  console.log('\n使用方式：');
+  console.log('  在 workflow 中自动调用 mcp__ace-tool__search_context');
+  console.log('  或手动调用 mcp__ace-tool__enhance_prompt');
 }
 
 async function configureApiKeys() {
@@ -205,6 +278,26 @@ async function uninstall() {
     console.log(`已删除: ${wrapperPath}`);
   }
 
+  // 询问是否删除 MCP 配置
+  if (fs.existsSync(MCP_CONFIG_PATH)) {
+    const removeMcp = await question('是否删除 MCP 配置？ (y/N): ');
+    if (removeMcp.toLowerCase() === 'y') {
+      try {
+        let mcpConfig = JSON.parse(fs.readFileSync(MCP_CONFIG_PATH, 'utf8'));
+        delete mcpConfig['ace-tool'];
+        if (Object.keys(mcpConfig).length === 0) {
+          fs.unlinkSync(MCP_CONFIG_PATH);
+          console.log('已删除: ~/.claude/mcp_servers.json');
+        } else {
+          fs.writeFileSync(MCP_CONFIG_PATH, JSON.stringify(mcpConfig, null, 2));
+          console.log('已从 MCP 配置中移除 ace-tool');
+        }
+      } catch {
+        // ignore
+      }
+    }
+  }
+
   console.log('\n✅ 卸载完成');
   console.log('注意: 环境变量需要手动从 ~/.zshrc 或 ~/.bashrc 中删除');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-ros2-workflow",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "ROS2 Multi-model Collaborative Development Workflow - Codex (Low-level) + Gemini (High-level) + Claude (Orchestration)",
   "main": "bin/cli.js",
   "bin": {