ccg-ros2-workflow 1.0.0

package/README.md

@@ -0,0 +1,121 @@
+# CCG-ROS2-Workflow
+
+ROS2 多模型协作开发工具 - 基于 Claude Code CLI
+
+## 特性
+
+- **多模型协作**: Codex (底层控制) + Gemini (上层集成) + Claude (编排)
+- **ROS2 Humble**: 专为物理机器人开发优化
+- **简洁原则**: 信任模型能力，上下文由 MCP 检索
+- **跨平台**: macOS / Ubuntu 支持
+
+## 安装
+
+```bash
+npx ccg-ros2-workflow
+```
+
+或全局安装：
+
+```bash
+npm install -g ccg-ros2-workflow
+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) (可选)
+
+```bash
+# Gemini CLI
+npm install -g @google/gemini-cli
+```
+
+## 使用方法
+
+在 Claude Code 中：
+
+```bash
+# 完整工作流
+/ccg:workflow 为移动机器人添加速度限制器
+
+# 分析任务
+/ccg:analyze 分析控制器实现
+
+# 代码审查
+/ccg:review
+
+# 查看所有命令
+/ccg:<Tab>
+```
+
+## 命令列表
+
+| 命令 | 说明 |
+|------|------|
+| `/ccg:workflow` | 6 阶段完整工作流 |
+| `/ccg:analyze` | 双模型并行分析 |
+| `/ccg:plan` | 多模型协作规划 |
+| `/ccg:execute` | 执行实施 |
+| `/ccg:review` | 双模型代码审查 |
+| `/ccg:debug` | 多模型调试 |
+| `/ccg:optimize` | 性能优化 |
+| `/ccg:test` | 测试生成 |
+| `/ccg:commit` | 智能 Git 提交 |
+
+## 架构
+
+```
+┌─────────────────────────────────────────┐
+│              Claude (编排)               │
+│         执行代码修改、协调工作流          │
+└─────────────────┬───────────────────────┘
+                  │
+        ┌─────────┴─────────┐
+        ▼                   ▼
+┌───────────────┐   ┌───────────────┐
+│  Codex (底层)  │   │ Gemini (上层) │
+│  控制、C++     │   │ 集成、Python  │
+│  硬件、实时    │   │ 配置、诊断    │
+└───────────────┘   └───────────────┘
+```
+
+## 配置
+
+安装后配置文件位于：
+
+```
+~/.claude/
+├── .ccg/
+│   ├── config.toml          # 主配置
+│   └── prompts/             # 提示词
+│       ├── codex/
+│       ├── gemini/
+│       └── claude/
+├── commands/ccg/            # 命令文件
+└── bin/
+    └── codeagent-wrapper    # 模型调用脚本
+```
+
+## 语言配置
+
+| 场景 | 语言 |
+|------|------|
+| 提示词 | English |
+| 交互 | 中文 |
+| 代码注释 | 中文 |
+
+## 卸载
+
+```bash
+npx ccg-ros2-workflow
+# 选择 "卸载工作流"
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { execSync } = require('child_process');
+
+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 SRC_DIR = path.join(__dirname, '..', 'src');
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+function question(prompt) {
+  return new Promise(resolve => rl.question(prompt, resolve));
+}
+
+function copyRecursive(src, dest) {
+  if (!fs.existsSync(src)) return;
+
+  if (fs.statSync(src).isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    fs.readdirSync(src).forEach(child => {
+      copyRecursive(path.join(src, child), path.join(dest, child));
+    });
+  } else {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+  }
+}
+
+function replaceInFile(filePath, replacements) {
+  if (!fs.existsSync(filePath)) return;
+  let content = fs.readFileSync(filePath, 'utf8');
+  for (const [search, replace] of Object.entries(replacements)) {
+    content = content.replace(new RegExp(search, 'g'), replace);
+  }
+  fs.writeFileSync(filePath, content);
+}
+
+async function main() {
+  console.log('\n🤖 CCG-ROS2-Workflow 安装程序');
+  console.log('================================');
+  console.log('ROS2 多模型协作开发工具');
+  console.log('Codex (底层) + Gemini (上层) + Claude (编排)\n');
+
+  // 检查是否已安装
+  if (fs.existsSync(path.join(CCG_DIR, 'config.toml'))) {
+    const overwrite = await question('⚠️  检测到已有安装，是否覆盖？ (y/N): ');
+    if (overwrite.toLowerCase() !== 'y') {
+      console.log('取消安装');
+      rl.close();
+      return;
+    }
+  }
+
+  // 选择操作
+  console.log('\n请选择操作：');
+  console.log('1. 安装工作流');
+  console.log('2. 配置 API 密钥');
+  console.log('3. 卸载工作流');
+  console.log('4. 退出');
+
+  const choice = await question('\n请输入选项 (1-4): ');
+
+  switch (choice) {
+    case '1':
+      await install();
+      break;
+    case '2':
+      await configureApiKeys();
+      break;
+    case '3':
+      await uninstall();
+      break;
+    default:
+      console.log('退出');
+  }
+
+  rl.close();
+}
+
+async function install() {
+  console.log('\n📦 开始安装...\n');
+
+  // 创建目录
+  [CCG_DIR, COMMANDS_DIR, BIN_DIR].forEach(dir => {
+    fs.mkdirSync(dir, { recursive: true });
+  });
+
+  // 复制文件
+  console.log('复制配置文件...');
+  copyRecursive(path.join(SRC_DIR, 'prompts'), path.join(CCG_DIR, 'prompts'));
+
+  console.log('复制命令文件...');
+  copyRecursive(path.join(SRC_DIR, 'commands', 'ccg'), COMMANDS_DIR);
+
+  console.log('复制配置...');
+  fs.copyFileSync(
+    path.join(SRC_DIR, 'config.toml'),
+    path.join(CCG_DIR, 'config.toml')
+  );
+
+  // 复制 codeagent-wrapper 脚本
+  console.log('安装 codeagent-wrapper...');
+  const wrapperSrc = path.join(SRC_DIR, 'codeagent-wrapper.sh');
+  const wrapperDest = path.join(BIN_DIR, 'codeagent-wrapper');
+  fs.copyFileSync(wrapperSrc, wrapperDest);
+  fs.chmodSync(wrapperDest, '755');
+
+  // 替换路径
+  const homeDir = process.env.HOME;
+  const filesToUpdate = [
+    path.join(CCG_DIR, 'config.toml'),
+    ...fs.readdirSync(COMMANDS_DIR)
+      .filter(f => f.endsWith('.md'))
+      .map(f => path.join(COMMANDS_DIR, f))
+  ];
+
+  filesToUpdate.forEach(file => {
+    replaceInFile(file, {
+      '/Users/super': homeDir,
+      '\\$HOME': homeDir
+    });
+  });
+
+  console.log('\n✅ 安装完成！\n');
+
+  // 询问是否配置 API
+  const configApi = await question('是否现在配置 API 密钥？ (Y/n): ');
+  if (configApi.toLowerCase() !== 'n') {
+    await configureApiKeys();
+  }
+
+  console.log('\n📖 使用方法：');
+  console.log('  在 Claude Code 中使用 /ccg:workflow <任务描述>');
+  console.log('  查看所有命令：/ccg:<Tab>');
+}
+
+async function configureApiKeys() {
+  console.log('\n🔑 配置 API 密钥\n');
+
+  const geminiKey = await question('Gemini API Key (留空跳过): ');
+  const geminiBaseUrl = await question('Gemini Base URL (默认 https://api.ikuncode.cc): ');
+  const codexKey = await question('Codex API Key (留空跳过): ');
+
+  // 检测 shell 配置文件
+  const shellRc = fs.existsSync(path.join(process.env.HOME, '.zshrc'))
+    ? '.zshrc'
+    : '.bashrc';
+  const rcPath = path.join(process.env.HOME, shellRc);
+
+  let rcContent = fs.existsSync(rcPath) ? fs.readFileSync(rcPath, 'utf8') : '';
+
+  // 添加环境变量
+  const envVars = [];
+  if (geminiKey) {
+    envVars.push(`export GEMINI_API_KEY="${geminiKey}"`);
+    envVars.push(`export GOOGLE_GEMINI_BASE_URL="${geminiBaseUrl || 'https://api.ikuncode.cc'}"`);
+    envVars.push('export GEMINI_MODEL="gemini-3-pro-preview"');
+  }
+  if (codexKey) {
+    envVars.push(`export CODEX_API_KEY="${codexKey}"`);
+  }
+
+  if (envVars.length > 0) {
+    const marker = '# CCG-ROS2-Workflow';
+    if (!rcContent.includes(marker)) {
+      rcContent += `\n${marker}\n${envVars.join('\n')}\n`;
+      fs.writeFileSync(rcPath, rcContent);
+      console.log(`\n✅ 已添加到 ~/${shellRc}`);
+      console.log(`   请运行: source ~/${shellRc}`);
+    } else {
+      console.log(`\n⚠️  ~/${shellRc} 中已存在配置，请手动更新`);
+    }
+  }
+}
+
+async function uninstall() {
+  console.log('\n🗑️  卸载工作流...\n');
+
+  const confirm = await question('确定要卸载吗？这将删除所有配置文件 (y/N): ');
+  if (confirm.toLowerCase() !== 'y') {
+    console.log('取消卸载');
+    return;
+  }
+
+  // 删除目录
+  [CCG_DIR, COMMANDS_DIR].forEach(dir => {
+    if (fs.existsSync(dir)) {
+      fs.rmSync(dir, { recursive: true });
+      console.log(`已删除: ${dir}`);
+    }
+  });
+
+  // 删除 codeagent-wrapper
+  const wrapperPath = path.join(BIN_DIR, 'codeagent-wrapper');
+  if (fs.existsSync(wrapperPath)) {
+    fs.unlinkSync(wrapperPath);
+    console.log(`已删除: ${wrapperPath}`);
+  }
+
+  console.log('\n✅ 卸载完成');
+  console.log('注意: 环境变量需要手动从 ~/.zshrc 或 ~/.bashrc 中删除');
+}
+
+main().catch(console.error);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "ccg-ros2-workflow",
+  "version": "1.0.0",
+  "description": "ROS2 Multi-model Collaborative Development Workflow - Codex (Low-level) + Gemini (High-level) + Claude (Orchestration)",
+  "main": "bin/cli.js",
+  "bin": {
+    "ccg-ros2-workflow": "bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": [
+    "ros2",
+    "humble",
+    "claude-code",
+    "codex",
+    "gemini",
+    "multi-model",
+    "robotics",
+    "workflow"
+  ],
+  "author": "super",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/你的用户名/ccg-ros2-workflow.git"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/"
+  ]
+}

package/src/codeagent-wrapper.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+# codeagent-wrapper - 跨平台多模型调用脚本
+# 用于 CCG-ROS2-Workflow
+
+set -e
+
+BACKEND=""
+LITE=""
+RESUME_ID=""
+WORKDIR="$(pwd)"
+LOG_DIR="/tmp/ccg-wrapper"
+
+# 解析参数
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --lite)
+      LITE="true"
+      shift
+      ;;
+    --backend)
+      BACKEND="$2"
+      shift 2
+      ;;
+    resume)
+      RESUME_ID="$2"
+      shift 2
+      ;;
+    -)
+      WORKDIR="$2"
+      shift 2
+      ;;
+    *)
+      shift
+      ;;
+  esac
+done
+
+# 创建日志目录
+mkdir -p "$LOG_DIR"
+LOG_FILE="$LOG_DIR/wrapper-$$.log"
+
+# 读取 stdin
+PROMPT=$(cat)
+
+# 记录日志
+echo "[$(date)] Backend: $BACKEND, Resume: $RESUME_ID, Workdir: $WORKDIR" >> "$LOG_FILE"
+
+# 切换工作目录
+cd "$WORKDIR" 2>/dev/null || cd "$HOME"
+
+# 生成 SESSION_ID
+SESSION_ID="${RESUME_ID:-$(uuidgen 2>/dev/null || cat /proc/sys/kernel/random/uuid 2>/dev/null || echo "sess-$$-$(date +%s)")}"
+
+# 调用对应的后端
+case "$BACKEND" in
+  codex)
+    # Codex CLI 调用
+    if command -v codex &> /dev/null; then
+      echo "$PROMPT" | codex -a auto -q 2>> "$LOG_FILE"
+    else
+      echo "[ERROR] codex CLI 未安装" >&2
+      echo "请安装: npm install -g @openai/codex-cli" >&2
+      exit 1
+    fi
+    ;;
+  gemini)
+    # Gemini CLI 调用
+    if command -v gemini &> /dev/null; then
+      echo "$PROMPT" | gemini -p - 2>> "$LOG_FILE"
+    else
+      echo "[ERROR] gemini CLI 未安装" >&2
+      echo "请安装: npm install -g @google/gemini-cli" >&2
+      exit 1
+    fi
+    ;;
+  *)
+    echo "[ERROR] 未知的后端: $BACKEND" >&2
+    echo "支持的后端: codex, gemini" >&2
+    exit 1
+    ;;
+esac
+
+# 输出 SESSION_ID
+echo ""
+echo "---"
+echo "SESSION_ID: $SESSION_ID"

package/src/commands/ccg/analyze.md

@@ -0,0 +1,152 @@
+---
+description: '多模型技术分析（并行执行）：Codex 后端视角 + Gemini 前端视角，交叉验证后综合见解'
+---
+
+# Analyze - 多模型技术分析
+
+使用双模型并行分析，交叉验证得出综合技术见解。**仅分析，不修改代码。**
+
+## 使用方法
+
+```bash
+/analyze <分析问题或任务>
+```
+
+## 你的角色
+
+你是**分析协调者**，编排多模型分析流程：
+- **ace-tool** – 代码上下文检索
+- **Codex** – 后端/系统视角（**后端权威**）
+- **Gemini** – 前端/用户视角（**前端权威**）
+- **Claude (自己)** – 综合见解
+
+---
+
+## 多模型调用规范
+
+**调用语法**（并行用 `run_in_background: true`）：
+
+```
+Bash({
+  command: "/Users/super/.claude/bin/codeagent-wrapper --lite --backend <codex|gemini> - \"$PWD\" <<'EOF'
+ROLE_FILE: <角色提示词路径>
+<TASK>
+需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
+上下文：<前序阶段检索到的代码上下文>
+</TASK>
+OUTPUT: 期望输出格式
+EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "简短描述"
+})
+```
+
+**角色提示词**：
+
+| 模型 | 提示词 |
+|------|--------|
+| Codex | `/Users/super/.claude/.ccg/prompts/codex/analyzer.md` |
+| Gemini | `/Users/super/.claude/.ccg/prompts/gemini/analyzer.md` |
+
+**并行调用**：使用 `run_in_background: true` 启动，用 `TaskOutput` 等待结果。**必须等所有模型返回后才能进入下一阶段**。
+
+**等待后台任务**（使用最大超时 600000ms = 10 分钟）：
+
+```
+TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
+```
+
+**重要**：
+- 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时。
+如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**。
+- 若因等待时间过长跳过了等待 TaskOutput 结果，则**必须调用 `AskUserQuestion` 工具询问用户选择继续等待还是 Kill Task。禁止直接 Kill Task。**
+
+---
+
+## 执行工作流
+
+**分析任务**：$ARGUMENTS
+
+### 🔍 阶段 0：Prompt 增强（可选）
+
+`[模式：准备]` - 如 ace-tool MCP 可用，调用 `mcp__ace-tool__enhance_prompt`，**用增强结果替代原始 $ARGUMENTS，后续调用 Codex/Gemini 时传入增强后的需求**
+
+### 🔍 阶段 1：上下文检索
+
+`[模式：研究]`
+
+1. 调用 `mcp__ace-tool__search_context` 检索相关代码
+2. 识别分析范围和关键组件
+3. 列出已知约束和假设
+
+### 💡 阶段 2：并行分析
+
+`[模式：分析]`
+
+**⚠️ 必须发起两个并行 Bash 调用**（参照上方调用规范）：
+
+1. **Codex 后端分析**：`Bash({ command: "...--backend codex...", run_in_background: true })`
+   - ROLE_FILE: `/Users/super/.claude/.ccg/prompts/codex/analyzer.md`
+   - OUTPUT：技术可行性、架构影响、性能考量
+
+2. **Gemini 前端分析**：`Bash({ command: "...--backend gemini...", run_in_background: true })`
+   - ROLE_FILE: `/Users/super/.claude/.ccg/prompts/gemini/analyzer.md`
+   - OUTPUT：UI/UX 影响、用户体验、视觉设计考量
+
+用 `TaskOutput` 等待两个模型的完整结果。**必须等所有模型返回后才能进入下一阶段**。
+
+**务必遵循上方 `多模型调用规范` 的 `重要` 指示**
+
+### 🔀 阶段 3：交叉验证
+
+`[模式：验证]`
+
+1. 对比双方分析结果
+2. 识别：
+   - **一致观点**（强信号）
+   - **分歧点**（需权衡）
+   - **互补见解**（各自领域洞察）
+3. 按信任规则权衡：后端以 Codex 为准，前端以 Gemini 为准
+
+### 📊 阶段 4：综合输出
+
+`[模式：总结]`
+
+```markdown
+## 🔬 技术分析：<主题>
+
+### 一致观点（强信号）
+1. <双方都认同的点>
+
+### 分歧点（需权衡）
+| 议题 | Codex 观点 | Gemini 观点 | 建议 |
+|------|------------|-------------|------|
+
+### 核心结论
+<1-2 句话总结>
+
+### 推荐方案
+**首选**：<方案>
+- 理由 / 风险 / 缓解措施
+
+### 后续行动
+1. [ ] <具体步骤>
+```
+
+---
+
+## 适用场景
+
+| 场景 | 示例 |
+|------|------|
+| 技术选型 | "比较 Redux vs Zustand" |
+| 架构评估 | "评估微服务拆分方案" |
+| 性能分析 | "分析 API 响应慢的原因" |
+| 安全审计 | "评估认证模块安全性" |
+
+## 关键规则
+
+1. **仅分析不修改** – 本命令不执行任何代码变更
+2. **信任规则** – 后端以 Codex 为准，前端以 Gemini 为准
+3. 外部模型对文件系统**零写入权限**