ccg-ros2-workflow 1.4.0 → 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 fengshao1227
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,303 +1,190 @@
-# CCG-ROS2-Workflow
+# CCG - Claude + Codex + Gemini Multi-Model Collaboration
 
-[![npm version](https://badge.fury.io/js/ccg-ros2-workflow.svg)](https://www.npmjs.com/package/ccg-ros2-workflow)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<div align="center">
 
-ROS2 多模型协作开发工具 - 基于 Claude Code 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)
 
-> **v1.4.0** - Agents 独立文件化，ROS2 完整版实现
+</div>
 
-## 特性
-
-- **多模型协作**: Codex (底层控制) + Gemini (上层集成) + Claude (编排)
-- **ROS2 Humble**: 专为物理机器人开发优化
-- **简洁原则**: 信任模型能力，上下文由 MCP 检索
-- **ace-tool MCP**: 自动理解项目结构和代码上下文
-- **跨平台**: macOS / Ubuntu 支持
+Claude Code 编排 Codex + Gemini 的多模型协作开发系统。前端任务路由至 Gemini，后端任务路由至 Codex，Claude 负责编排决策和代码审核。
 
 ## 安装
 
 ```bash
-npx ccg-ros2-workflow
+npx ccg-workflow
 ```
 
-或全局安装：
-
-```bash
-npm install -g ccg-ros2-workflow
-ccg-ros2-workflow
-```
+**要求**：Claude Code CLI、Node.js 20+
 
-安装程序提供以下选项：
-1. 安装/重装工作流
-2. 更新工作流
-3. 配置 ace-tool MCP
-4. 配置 API 密钥
-5. 帮助
-6. 卸载工作流
-7. 退出
+> **重要**：本项目依赖 `ora@9.x` 和 `string-width@8.x`，这些包要求 Node.js >= 20。使用 Node.js 18 会导致 `SyntaxError: Invalid regular expression flags` 错误。请确保升级到 Node.js 20 或更高版本。
 
-## 前置依赖
+**可选**：Codex CLI（后端）、Gemini CLI（前端）
 
-**必须安装**：
+## 命令
 
-- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) - 核心运行环境
+| 命令 | 说明 |
+|------|------|
+| `/ccg:workflow` | 6 阶段完整工作流 |
+| `/ccg:plan` | 多模型协作规划 (Phase 1-2) |
+| `/ccg:execute` | 多模型协作执行 (Phase 3-5) |
+| `/ccg:feat` | 新功能开发 |
+| `/ccg:frontend` | 前端任务 (Gemini) |
+| `/ccg:backend` | 后端任务 (Codex) |
+| `/ccg:analyze` | 技术分析 |
+| `/ccg:debug` | 问题诊断 |
+| `/ccg:optimize` | 性能优化 |
+| `/ccg:test` | 测试生成 |
+| `/ccg:review` | 代码审查 |
+| `/ccg:commit` | Git 提交 |
+| `/ccg:rollback` | Git 回滚 |
+| `/ccg:clean-branches` | 清理分支 |
+| `/ccg:worktree` | Worktree 管理 |
+| `/ccg:init` | 初始化 CLAUDE.md |
+| `/ccg:enhance` | Prompt 增强 |
+| `/ccg:spec-init` | 初始化 OPSX 环境 |
+| `/ccg:spec-research` | 需求 → 约束集 |
+| `/ccg:spec-plan` | 约束 → 零决策计划 |
+| `/ccg:spec-impl` | 按计划执行 + 归档 |
+| `/ccg:spec-review` | 双模型交叉审查 |
+
+### OPSX 规范驱动（v1.7.52+）
+
+集成 [OPSX 架构](https://github.com/fission-ai/opsx)，把需求变成约束，让 AI 没法自由发挥：
 
 ```bash
-# Claude Code CLI (必须)
-npm install -g @anthropic-ai/claude-code
-```
+# 初始化 OPSX 环境
+/ccg:spec-init
 
-**可选安装**（启用多模型协作）：
+# 研究需求 → 输出约束集
+/ccg:spec-research 实现用户认证
 
-- [Codex CLI](https://github.com/openai/codex) - 底层控制专家
-- [Gemini CLI](https://github.com/google/gemini-cli) - 上层集成专家
-- [ace-tool](https://augmentcode.com/) - 代码上下文引擎（推荐）
+# 并行分析 → 零决策计划
+/ccg:spec-plan
 
-```bash
-# Codex CLI (可选)
-npm install -g @openai/codex
+# 按计划执行
+/ccg:spec-impl
 
-# Gemini CLI (可选)
-npm install -g @google/gemini-cli
+# 独立审查（随时可用）
+/ccg:spec-review
 ```
 
-## 使用方法
-
-在 Claude Code 中：
+**说明**：`/ccg:spec-*` 命令是 CCG 对 OPSX 的封装，内部调用 `/opsx:*` 命令。每阶段之间可 `/clear`，状态存在 `openspec/` 目录，不怕上下文爆。
 
-```bash
-# 完整工作流
-/ccg:workflow 为移动机器人添加速度限制器
+### 规划与执行分离
 
-# 智能功能开发
-/ccg:feat 实现 PID 控制器
+v1.7.39 新增 `/ccg:plan` 和 `/ccg:execute` 命令，将规划与执行解耦：
 
-# 分析任务
-/ccg:analyze 分析控制器实现
+```bash
+# 1. 生成实施计划
+/ccg:plan 实现用户认证功能
 
-# 代码审查
-/ccg:review
+# 2. 审查计划（可修改）
+# 计划保存至 .claude/plan/user-auth.md
 
-# 查看所有命令
-/ccg:<Tab>
+# 3. 执行计划（新会话也可执行）
+/ccg:execute .claude/plan/user-auth.md
 ```
 
-## 命令列表
-
-### 核心工作流
-
-| 命令 | 说明 |
-|------|------|
-| `/ccg:workflow` | 🚀 ROS2 多模型协作开发 (研究→构思→计划→执行→优化→评审)，智能路由 Codex/Gemini |
-| `/ccg:plan` | 📋 多模型协作规划 - 上下文检索 + 双模型分析 → 生成 Step-by-step 实施计划 |
-| `/ccg:execute` | ⚡ 多模型协作执行 - 根据计划获取原型 → Claude 重构实施 → 多模型审计交付 |
-| `/ccg:feat` | ✨ 智能功能开发 - 自动识别输入类型，规划/讨论/实施全流程 |
-
-### 专项开发
-
-| 命令 | 说明 |
-|------|------|
-| `/ccg:frontend` | 🎨 上层应用专项工作流 - Gemini 主导集成、可视化、Launch、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 enhance_prompt 优化提示词，展示原始与增强版本供确认 |
-| `/ccg:commit` | 💾 智能 Git 提交 - 分析改动生成 Conventional Commit 信息，支持拆分建议 |
-| `/ccg:rollback` | ⏪ 交互式 Git 回滚 - 安全回滚分支到历史版本，支持 reset/revert 模式 |
-| `/ccg:clean-branches` | 🧹 清理 Git 分支 - 安全清理已合并或过期分支，默认 dry-run 模式 |
-| `/ccg:worktree` | 🌲 Git Worktree 管理 - 在 ../.ccg/项目名/ 目录创建，支持 IDE 集成和内容迁移 |
-
-## 架构
+### 目录结构
 
 ```
-┌─────────────────────────────────────────┐
-│              Claude (编排)               │
-│         执行代码修改、协调工作流          │
-└─────────────────┬───────────────────────┘
-                  │
-        ┌─────────┴─────────┐
-        ▼                   ▼
-┌───────────────┐   ┌───────────────┐
-│  Codex (底层)  │   │ Gemini (上层) │
-│  控制、C++     │   │ 集成、Python  │
-│  硬件、实时    │   │ 配置、诊断    │
-└───────────────┘   └───────────────┘
+~/.claude/
+├── commands/ccg/       # 斜杠命令
+├── agents/ccg/         # 子智能体
+├── bin/codeagent-wrapper
+└── .ccg/
+    ├── config.toml
+    └── prompts/{codex,gemini}/
 ```
 
-### 模型分工
+### 环境变量
 
-| 模型 | 职责 | 关键词 |
+| 变量 | 说明 | 默认值 |
 |------|------|--------|
-| **Codex** | 底层系统 | 控制算法、运动学/动力学、实时性能、硬件驱动、C++ 节点、安全系统 |
-| **Gemini** | 上层集成 | Launch 文件、YAML 配置、Python 节点、系统诊断、参数管理 |
-| **Claude** | 编排执行 | 综合两个模型输出、执行代码修改、协调工作流 |
-
-### 智能路由
-
-系统根据任务类型自动分配到合适的模型：
-
-| 任务类型 | 路由目标 |
-|----------|----------|
-| 控制算法、C++、硬件驱动、实时性 | → Codex |
-| Launch、YAML、Python、诊断、集成 | → Gemini |
-| 代码审查、测试 | → 双模型并行 |
-
-## 配置
+| `CODEAGENT_POST_MESSAGE_DELAY` | Codex 完成后等待时间（秒） | 5 |
+| `CODEX_TIMEOUT` | codeagent-wrapper 执行超时（秒） | 7200 |
+| `BASH_DEFAULT_TIMEOUT_MS` | Claude Code Bash 默认超时（毫秒） | 120000 |
+| `BASH_MAX_TIMEOUT_MS` | Claude Code Bash 最大超时（毫秒） | 600000 |
 
-安装后配置文件位于：
+配置方式（`~/.claude/settings.json`）：
 
+```json
+{
+  "env": {
+    "CODEAGENT_POST_MESSAGE_DELAY": "1",
+    "CODEX_TIMEOUT": "7200",
+    "BASH_DEFAULT_TIMEOUT_MS": "600000",
+    "BASH_MAX_TIMEOUT_MS": "3600000",
+    "GEMINI_API_KEY": "your-gemini-api-key",
+    "GOOGLE_API_KEY": "your-google-api-key"
+  }
+}
 ```
-~/.claude/
-├── .ccg/
-│   ├── config.toml          # 主配置
-│   └── prompts/             # 提示词 (19个)
-│       ├── codex/           # analyzer, architect, reviewer, debugger, optimizer, tester
-│       ├── gemini/          # analyzer, architect, reviewer, debugger, optimizer, tester, frontend
-│       └── claude/          # analyzer, architect, reviewer, debugger, optimizer, tester
-├── commands/ccg/            # 17 个命令文件
-├── agents/ccg/              # 4 个 agent 文件
-│   ├── planner.md           # ROS2 任务规划师 (WBS 方法论)
-│   ├── system-integrator.md # ROS2 系统集成设计师
-│   ├── init-architect.md    # 项目初始化架构师
-│   └── get-current-datetime.md # 时间工具
-├── mcp_servers.json         # MCP 配置 (ace-tool)
-└── bin/
-    └── codeagent-wrapper    # 模型调用脚本
-```
 
-## MCP 配置 (ace-tool)
+> **VSCode 插件用户注意**：VSCode 启动的子进程不会继承终端环境变量，必须在 `settings.json` 中配置 API 密钥，否则 Gemini 会报退出码 41（授权失败）。
+
+### MCP 配置
 
-ace-tool 是 Augment Code 的代码上下文引擎，让 AI 自动理解项目结构。
+ace-tool 用于代码检索和 Prompt 增强，安装时可选配置。
 
-### 安装方式
+Token 获取：https://augmentcode.com/
 
-运行安装程序，选择「配置 ace-tool MCP」：
+## 更新 / 卸载
 
 ```bash
-npx ccg-ros2-workflow
-# 选择 3. 配置 ace-tool MCP
-# 选择版本：ace-tool (Node.js) 或 ace-tool-rs (Rust，推荐)
-# 输入 Token（从 augmentcode.com 或中转服务获取）
+# 更新
+npx ccg-workflow@latest          # npx 用户
+npm install -g ccg-workflow@latest  # npm 全局用户
+
+# 卸载
+npx ccg-workflow  # 选择 "卸载工作流"
+npm uninstall -g ccg-workflow  # npm 全局用户需额外执行
 ```
 
-### 配置示例
+## 已知问题
 
-```json
-{
-  "ace-tool": {
-    "command": "npx",
-    "args": ["ace-tool-rs", "mcp", "--token", "your-token"],
-    "env": { "RUST_LOG": "info" }
-  }
-}
-```
+**Codex CLI 0.80.0 进程不退出**
 
-### Token 获取
+`--json` 模式下 Codex 完成输出后进程不会自动退出。
 
-- **官方服务**: https://augmentcode.com/ 注册获取
-- **中转服务**: 使用第三方中转（需要配置 Base URL）
+解决：设置 `CODEAGENT_POST_MESSAGE_DELAY=1`
 
-配置完成后重启 Claude Code 即可使用。
+## 架构
 
-## 语言配置
+```
+Claude Code (编排)
+       │
+   ┌───┴───┐
+   ↓       ↓
+Codex   Gemini
+(后端)   (前端)
+   │       │
+   └───┬───┘
+       ↓
+  Unified Patch
+```
 
-| 场景 | 语言 |
-|------|------|
-| 提示词 | English |
-| 交互 | 中文 |
-| 代码注释 | 中文 |
+外部模型无写入权限，仅返回 Patch，由 Claude 审核后应用。
 
-## ROS2 配置
+## 致谢
 
-| 项目 | 值 |
-|------|-----|
-| 发行版 | Humble |
-| 目标 | 物理机器人 |
-| 路由模式 | 智能路由 |
+- [cexll/myclaude](https://github.com/cexll/myclaude) - codeagent-wrapper
+- [UfoMiao/zcf](https://github.com/UfoMiao/zcf) - Git 工具
+- [GudaStudio/skills](https://github.com/GuDaStudio/skills) - 路由设计
+- [ace-tool](https://linux.do/t/topic/1344562) - MCP 工具
 
-## 卸载
+## Star History
 
-```bash
-npx ccg-ros2-workflow
-# 选择 "卸载工作流"
-```
+[![Star History Chart](https://api.star-history.com/svg?repos=fengshao1227/ccg-workflow&type=timeline&legend=top-left)](https://www.star-history.com/#fengshao1227/ccg-workflow&type=timeline&legend=top-left)
 
 ## License
 
 MIT
 
-## 更新日志
-
-### v1.4.0
-- **Agents 目录改造**：agents 从 cli.js 内联生成改为独立文件
-- 新增 `src/agents/ccg/` 目录，包含 4 个 ROS2 专用 agent：
-  - `planner.md`：基于 WBS 方法论的 ROS2 任务规划师，支持 ace-tool 检索、Mermaid 依赖图
-  - `system-integrator.md`：ROS2 系统集成设计师（替代 ui-ux-designer），负责节点架构、Launch 配置、参数管理、QoS 策略
-  - `init-architect.md`：项目初始化架构师（通用版本）
-  - `get-current-datetime.md`：时间工具（通用版本）
-- 所有 agent 添加 frontmatter（name, tools, color 字段）
-- cli.js 改为使用 `copyRecursive` 安装 agents，与 commands/prompts 保持一致
-- 完整 ROS2 示例（PID 控制器、底盘驱动集成）
-
-### v1.3.0
-- 参考 ccg-workflow 官方实现重写 CLI
-- 全新交互式安装流程，支持 MCP 工具选择
-- 配置摘要显示（模型路由、命令数量、MCP 工具、目标平台）
-- 安装成功后显示已安装命令列表（逐个显示 ✓）
-- 显示已安装提示词（按模型分组）
-- 显示已安装二进制文件和 PATH 配置
-- 改进卸载流程，检测全局安装并提供完整卸载指引
-- 添加 ora 加载动画 spinner
-
-### v1.2.0
-- 全新交互式菜单 (inquirer + chalk)
-- 添加更新检查功能，支持 npm 版本对比
-- 新增 agents 目录，包含 3 个 agent 文件
-- 改进卸载流程，显示详细文件统计
-- 新增帮助命令，展示所有可用 /ccg: 命令
-- 优化安装流程，显示安装摘要
-
-### v1.1.0
-- 支持直接安装 ace-tool，无需手动安装 CLI
-- 支持 ace-tool (Node.js) 和 ace-tool-rs (Rust) 两种版本
-- 支持配置 Token 和 Base URL（中转服务）
-- 使用 npx 自动下载运行，首次使用自动安装
-
-### v1.0.9
-- 提示词文件统一使用英文
-- 保留 "Code comments in Chinese" 指令
-- 语言规范：提示词(英文) / 交互(中文) / 注释(中文)
-
-### v1.0.8
-- 基于 Codex+Gemini 双模型交叉验证分析优化
-- `gemini/architect.md`: 增加 QoS 策略设计 + Node Composition
-- `codex/architect.md`: 增加 RT Checklist (executor/ros2_control/E-stop)
-- `workflow.md`: 新增 Stage 7 硬件验证 gate
-- 术语规范化：`ui-ux-designer` → `system-integrator`
-
-### v1.0.7
-- 完成所有 17 个命令文件的 ROS2 术语适配
-- 术语映射：前端/后端 → 上层应用/底层控制
-- 任务路由：Launch/Python → Gemini，C++/控制 → Codex
-
-### v1.0.6
-- 更新 README 文档，添加完整命令列表
-- 修复 "仿真" → "集成" 术语
-
-### v1.0.5
-- 初始 ROS2 Humble 物理机器人版本
+---
+
+v1.7.52 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues)

package/bin/ccg.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli.mjs'

package/dist/cli.d.mts

@@ -0,0 +1 @@
+

package/dist/cli.d.ts

@@ -0,0 +1 @@
+

package/dist/cli.mjs

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+import cac from 'cac';
+import ansis from 'ansis';
+import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, t as readCcgConfig, n as initI18n, u as showMainMenu, m as init, E as configMcp, F as version, l as i18n } from './shared/ccg-ros2-workflow.CpLJvcLP.mjs';
+import 'inquirer';
+import 'node:child_process';
+import 'node:util';
+import 'node:os';
+import 'pathe';
+import 'fs-extra';
+import 'node:url';
+import 'i18next';
+import 'ora';
+import 'smol-toml';
+
+async function diagnoseMcp() {
+  console.log();
+  console.log(ansis.cyan.bold("  \u{1F50D} MCP Configuration Diagnostics"));
+  console.log();
+  const issues = await diagnoseMcpConfig();
+  console.log(ansis.bold("  Diagnostic Results:"));
+  console.log();
+  for (const issue of issues) {
+    if (issue.startsWith("\u2705")) {
+      console.log(ansis.green(`  ${issue}`));
+    } else if (issue.startsWith("\u26A0\uFE0F")) {
+      console.log(ansis.yellow(`  ${issue}`));
+    } else if (issue.startsWith("\u274C")) {
+      console.log(ansis.red(`  ${issue}`));
+    } else {
+      console.log(`  ${issue}`);
+    }
+  }
+  if (isWindows() && issues.some((i) => i.includes("not properly wrapped"))) {
+    console.log();
+    console.log(ansis.yellow("  \u{1F4A1} Tip: Run the following command to fix Windows MCP configuration:"));
+    console.log(ansis.gray("     npx ccg fix-mcp"));
+  }
+  console.log();
+}
+async function fixMcp() {
+  console.log();
+  console.log(ansis.cyan.bold("  \u{1F527} Fixing MCP Configuration"));
+  console.log();
+  if (!isWindows()) {
+    console.log(ansis.yellow("  \u26A0\uFE0F  This command is only needed on Windows"));
+    console.log();
+    return;
+  }
+  try {
+    const config = await readClaudeCodeConfig();
+    if (!config) {
+      console.log(ansis.red("  \u274C No ~/.claude.json found"));
+      console.log();
+      return;
+    }
+    if (!config.mcpServers || Object.keys(config.mcpServers).length === 0) {
+      console.log(ansis.yellow("  \u26A0\uFE0F  No MCP servers configured"));
+      console.log();
+      return;
+    }
+    const fixedConfig = fixWindowsMcpConfig(config);
+    await writeClaudeCodeConfig(fixedConfig);
+    console.log(ansis.green("  \u2705 Windows MCP configuration fixed"));
+    console.log();
+    console.log(ansis.gray("  Run diagnostics again to verify:"));
+    console.log(ansis.gray("     npx ccg diagnose-mcp"));
+    console.log();
+  } catch (error) {
+    console.log(ansis.red(`  \u274C Failed to fix MCP configuration: ${error}`));
+    console.log();
+  }
+}
+
+function customizeHelp(sections) {
+  sections.unshift({
+    title: "",
+    body: ansis.cyan.bold(`CCG-ROS2 - Claude + Codex + Gemini v${version}`)
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.commands")),
+    body: [
+      `  ${ansis.cyan("ccg")}              ${i18n.t("cli:help.commandDescriptions.showMenu")}`,
+      `  ${ansis.cyan("ccg init")} | ${ansis.cyan("i")}     ${i18n.t("cli:help.commandDescriptions.initConfig")}`,
+      `  ${ansis.cyan("ccg config mcp")}   \u914D\u7F6E ace-tool MCP Token`,
+      `  ${ansis.cyan("ccg diagnose-mcp")} \u8BCA\u65AD MCP \u914D\u7F6E\u95EE\u9898`,
+      `  ${ansis.cyan("ccg fix-mcp")}      \u4FEE\u590D Windows MCP \u914D\u7F6E`,
+      "",
+      ansis.gray(`  ${i18n.t("cli:help.shortcuts")}`),
+      `  ${ansis.cyan("ccg i")}            ${i18n.t("cli:help.shortcutDescriptions.quickInit")}`
+    ].join("\n")
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.options")),
+    body: [
+      `  ${ansis.green("--lang, -l")} <lang>         ${i18n.t("cli:help.optionDescriptions.displayLanguage")} (zh-CN, en)`,
+      `  ${ansis.green("--force, -f")}               ${i18n.t("cli:help.optionDescriptions.forceOverwrite")}`,
+      `  ${ansis.green("--help, -h")}                ${i18n.t("cli:help.optionDescriptions.displayHelp")}`,
+      `  ${ansis.green("--version, -v")}             ${i18n.t("cli:help.optionDescriptions.displayVersion")}`,
+      "",
+      ansis.gray(`  ${i18n.t("cli:help.nonInteractiveMode")}`),
+      `  ${ansis.green("--skip-prompt, -s")}         ${i18n.t("cli:help.optionDescriptions.skipAllPrompts")}`,
+      `  ${ansis.green("--frontend, -F")} <models>   ${i18n.t("cli:help.optionDescriptions.frontendModels")}`,
+      `  ${ansis.green("--backend, -B")} <models>    ${i18n.t("cli:help.optionDescriptions.backendModels")}`,
+      `  ${ansis.green("--mode, -m")} <mode>         ${i18n.t("cli:help.optionDescriptions.collaborationMode")}`,
+      `  ${ansis.green("--workflows, -w")} <list>    ${i18n.t("cli:help.optionDescriptions.workflows")}`,
+      `  ${ansis.green("--install-dir, -d")} <path>  ${i18n.t("cli:help.optionDescriptions.installDir")}`
+    ].join("\n")
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.examples")),
+    body: [
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.showInteractiveMenu")}`),
+      `  ${ansis.cyan("npx ccg")}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.runFullInitialization")}`),
+      `  ${ansis.cyan("npx ccg init")}`,
+      `  ${ansis.cyan("npx ccg i")}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.customModels")}`),
+      `  ${ansis.cyan("npx ccg i --frontend gemini,codex --backend codex,gemini")}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.parallelMode")}`),
+      `  ${ansis.cyan("npx ccg i --mode parallel")}`,
+      ""
+    ].join("\n")
+  });
+  return sections;
+}
+async function setupCommands(cli) {
+  try {
+    const config = await readCcgConfig();
+    const defaultLang = config?.general?.language || "zh-CN";
+    await initI18n(defaultLang);
+  } catch {
+    await initI18n("zh-CN");
+  }
+  cli.command("", "\u663E\u793A\u4EA4\u4E92\u5F0F\u83DC\u5355\uFF08\u9ED8\u8BA4\uFF09").option("--lang, -l <lang>", "\u663E\u793A\u8BED\u8A00 (zh-CN, en)").action(async (options) => {
+    if (options.lang) {
+      await initI18n(options.lang);
+    }
+    await showMainMenu();
+  });
+  cli.command("init", "\u521D\u59CB\u5316 CCG-ROS2 \u591A\u6A21\u578B\u534F\u4F5C\u7CFB\u7EDF").alias("i").option("--lang, -l <lang>", "\u663E\u793A\u8BED\u8A00 (zh-CN, en)").option("--force, -f", "\u5F3A\u5236\u8986\u76D6\u73B0\u6709\u914D\u7F6E").option("--skip-prompt, -s", "\u8DF3\u8FC7\u6240\u6709\u4EA4\u4E92\u5F0F\u63D0\u793A\uFF08\u975E\u4EA4\u4E92\u6A21\u5F0F\uFF09").option("--skip-mcp", "\u8DF3\u8FC7 MCP \u914D\u7F6E\uFF08\u66F4\u65B0\u65F6\u4F7F\u7528\uFF09").option("--frontend, -F <models>", "\u4E0A\u5C42\u5E94\u7528\u6A21\u578B\uFF08\u9017\u53F7\u5206\u9694: gemini,codex,claude\uFF09").option("--backend, -B <models>", "\u5E95\u5C42\u63A7\u5236\u6A21\u578B\uFF08\u9017\u53F7\u5206\u9694: codex,gemini,claude\uFF09").option("--mode, -m <mode>", "\u534F\u4F5C\u6A21\u5F0F (parallel, smart, sequential)").option("--workflows, -w <workflows>", '\u8981\u5B89\u88C5\u7684\u5DE5\u4F5C\u6D41\uFF08\u9017\u53F7\u5206\u9694\u6216 "all"\uFF09').option("--install-dir, -d <path>", "\u5B89\u88C5\u76EE\u5F55\uFF08\u9ED8\u8BA4: ~/.claude\uFF09").action(async (options) => {
+    if (options.lang) {
+      await initI18n(options.lang);
+    }
+    await init(options);
+  });
+  cli.command("diagnose-mcp", "\u8BCA\u65AD MCP \u914D\u7F6E\u95EE\u9898").action(async () => {
+    await diagnoseMcp();
+  });
+  cli.command("fix-mcp", "\u4FEE\u590D Windows MCP \u914D\u7F6E\u95EE\u9898").action(async () => {
+    await fixMcp();
+  });
+  cli.command("config <subcommand>", "\u914D\u7F6E CCG \u8BBE\u7F6E").action(async (subcommand) => {
+    if (subcommand === "mcp") {
+      await configMcp();
+    } else {
+      console.log(ansis.red(`\u672A\u77E5\u5B50\u547D\u4EE4: ${subcommand}`));
+      console.log(ansis.gray("\u53EF\u7528\u5B50\u547D\u4EE4: mcp"));
+    }
+  });
+  cli.help((sections) => customizeHelp(sections));
+  cli.version(version);
+}
+
+async function main() {
+  const cli = cac("ccg");
+  await setupCommands(cli);
+  cli.parse();
+}
+main().catch(console.error);