ccg-ros2-workflow 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +87 -13
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -7,6 +7,7 @@ ROS2 多模型协作开发工具 - 基于 Claude Code CLI
|
|
|
7
7
|
- **多模型协作**: Codex (底层控制) + Gemini (上层集成) + Claude (编排)
|
|
8
8
|
- **ROS2 Humble**: 专为物理机器人开发优化
|
|
9
9
|
- **简洁原则**: 信任模型能力，上下文由 MCP 检索
|
|
10
|
+
- **ace-tool MCP**: 自动理解项目结构和代码上下文
|
|
10
11
|
- **跨平台**: macOS / Ubuntu 支持
|
|
11
12
|
|
|
12
13
|
## 安装
|
|
@@ -22,6 +23,12 @@ npm install -g ccg-ros2-workflow
|
|
|
22
23
|
ccg-ros2-workflow
|
|
23
24
|
```
|
|
24
25
|
|
|
26
|
+
安装程序提供以下选项：
|
|
27
|
+
1. 安装工作流
|
|
28
|
+
2. 配置 API 密钥
|
|
29
|
+
3. 配置 ace-tool MCP
|
|
30
|
+
4. 卸载工作流
|
|
31
|
+
|
|
25
32
|
## 前置依赖
|
|
26
33
|
|
|
27
34
|
需要先安装：
|
|
@@ -29,6 +36,7 @@ ccg-ros2-workflow
|
|
|
29
36
|
- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
|
|
30
37
|
- [Codex CLI](https://github.com/openai/codex) (可选)
|
|
31
38
|
- [Gemini CLI](https://github.com/google/gemini-cli) (可选)
|
|
39
|
+
- [ace-tool](https://augmentcode.com/) (推荐，提供代码上下文)
|
|
32
40
|
|
|
33
41
|
```bash
|
|
34
42
|
# Gemini CLI
|
|
@@ -43,6 +51,9 @@ npm install -g @google/gemini-cli
|
|
|
43
51
|
# 完整工作流
|
|
44
52
|
/ccg:workflow 为移动机器人添加速度限制器
|
|
45
53
|
|
|
54
|
+
# 智能功能开发
|
|
55
|
+
/ccg:feat 实现 PID 控制器
|
|
56
|
+
|
|
46
57
|
# 分析任务
|
|
47
58
|
/ccg:analyze 分析控制器实现
|
|
48
59
|
|
|
@@ -55,17 +66,42 @@ npm install -g @google/gemini-cli
|
|
|
55
66
|
|
|
56
67
|
## 命令列表
|
|
57
68
|
|
|
69
|
+
### 核心工作流
|
|
70
|
+
|
|
71
|
+
| 命令 | 说明 |
|
|
72
|
+
|------|------|
|
|
73
|
+
| `/ccg:workflow` | 🚀 主工作流 - 6阶段完整开发流程（研究→构思→计划→执行→优化→评审） |
|
|
74
|
+
| `/ccg:plan` | 📋 多模型协作规划 - Codex + Gemini 双模型生成实施计划 |
|
|
75
|
+
| `/ccg:execute` | ⚡ 多模型协作执行 - 根据计划获取原型 → Claude 重构实施 |
|
|
76
|
+
| `/ccg:feat` | ✨ 智能功能开发 - 自动识别输入类型，规划/讨论/实施全流程 |
|
|
77
|
+
|
|
78
|
+
### 专项开发
|
|
79
|
+
|
|
58
80
|
| 命令 | 说明 |
|
|
59
81
|
|------|------|
|
|
60
|
-
| `/ccg:
|
|
61
|
-
| `/ccg:
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
|
66
|
-
|
|
67
|
-
| `/ccg:
|
|
68
|
-
| `/ccg:
|
|
82
|
+
| `/ccg:frontend` | 🎨 前端专项开发 - Gemini 主导（Python 节点、配置、诊断） |
|
|
83
|
+
| `/ccg:backend` | 🔧 后端专项开发 - Codex 主导（C++ 节点、控制、驱动） |
|
|
84
|
+
|
|
85
|
+
### 分析与优化
|
|
86
|
+
|
|
87
|
+
| 命令 | 说明 |
|
|
88
|
+
|------|------|
|
|
89
|
+
| `/ccg:analyze` | 🔍 多模型技术分析 - Codex 底层视角 + Gemini 上层视角交叉验证 |
|
|
90
|
+
| `/ccg:review` | 👀 多模型代码审查 - 双模型交叉验证 git diff |
|
|
91
|
+
| `/ccg:test` | 🧪 多模型测试生成 - Codex 后端测试 / Gemini 前端测试 |
|
|
92
|
+
| `/ccg:debug` | 🐛 多模型调试 - Codex 后端诊断 + Gemini 前端诊断 |
|
|
93
|
+
| `/ccg:optimize` | ⚡ 多模型性能优化 - Codex 后端优化 + Gemini 前端优化 |
|
|
94
|
+
|
|
95
|
+
### 辅助工具
|
|
96
|
+
|
|
97
|
+
| 命令 | 说明 |
|
|
98
|
+
|------|------|
|
|
99
|
+
| `/ccg:init` | 🏗️ 初始化项目 AI 上下文 - 生成 CLAUDE.md 索引 |
|
|
100
|
+
| `/ccg:enhance` | 📝 Prompt 优化 - 使用 ace-tool 增强用户提示词 |
|
|
101
|
+
| `/ccg:commit` | 💾 智能 Git 提交 - 分析改动生成 Conventional Commit |
|
|
102
|
+
| `/ccg:rollback` | ⏪ 交互式 Git 回滚 - 安全回滚到历史版本 |
|
|
103
|
+
| `/ccg:clean-branches` | 🧹 清理 Git 分支 - 安全清理已合并/过期分支 |
|
|
104
|
+
| `/ccg:worktree` | 🌲 Git Worktree 管理 - 创建工作树支持 IDE 集成 |
|
|
69
105
|
|
|
70
106
|
## 架构
|
|
71
107
|
|
|
@@ -84,6 +120,14 @@ npm install -g @google/gemini-cli
|
|
|
84
120
|
└───────────────┘ └───────────────┘
|
|
85
121
|
```
|
|
86
122
|
|
|
123
|
+
### 模型分工
|
|
124
|
+
|
|
125
|
+
| 模型 | 职责 | 关键词 |
|
|
126
|
+
|------|------|--------|
|
|
127
|
+
| **Codex** | 底层系统 | 控制算法、运动学/动力学、实时性能、硬件驱动、C++ 节点、安全系统 |
|
|
128
|
+
| **Gemini** | 上层集成 | Launch 文件、YAML 配置、Python 节点、系统诊断、参数管理 |
|
|
129
|
+
| **Claude** | 编排执行 | 综合两个模型输出、执行代码修改、协调工作流 |
|
|
130
|
+
|
|
87
131
|
## 配置
|
|
88
132
|
|
|
89
133
|
安装后配置文件位于：
|
|
@@ -93,14 +137,36 @@ npm install -g @google/gemini-cli
|
|
|
93
137
|
├── .ccg/
|
|
94
138
|
│ ├── config.toml # 主配置
|
|
95
139
|
│ └── prompts/ # 提示词
|
|
96
|
-
│ ├── codex/
|
|
97
|
-
│ ├── gemini/
|
|
98
|
-
│ └── claude/
|
|
99
|
-
├── commands/ccg/ #
|
|
140
|
+
│ ├── codex/ # 底层分析/架构/审查/调试/优化/测试
|
|
141
|
+
│ ├── gemini/ # 上层分析/架构/审查/调试/优化/测试/前端
|
|
142
|
+
│ └── claude/ # 编排分析/架构/审查/调试/优化/测试
|
|
143
|
+
├── commands/ccg/ # 17 个命令文件
|
|
144
|
+
├── mcp_servers.json # MCP 配置 (ace-tool)
|
|
100
145
|
└── bin/
|
|
101
146
|
└── codeagent-wrapper # 模型调用脚本
|
|
102
147
|
```
|
|
103
148
|
|
|
149
|
+
## MCP 配置 (ace-tool)
|
|
150
|
+
|
|
151
|
+
ace-tool 是 Augment Code 的代码上下文引擎，让 AI 自动理解项目结构。
|
|
152
|
+
|
|
153
|
+
安装时选择「配置 ace-tool MCP」会自动添加到 `~/.claude/mcp_servers.json`：
|
|
154
|
+
|
|
155
|
+
```json
|
|
156
|
+
{
|
|
157
|
+
"ace-tool": {
|
|
158
|
+
"command": "ace-tool",
|
|
159
|
+
"args": ["mcp"],
|
|
160
|
+
"env": {}
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
使用前需要：
|
|
166
|
+
1. 安装 ace-tool CLI（访问 https://augmentcode.com/）
|
|
167
|
+
2. 运行 `ace-tool login` 登录
|
|
168
|
+
3. 重启 Claude Code
|
|
169
|
+
|
|
104
170
|
## 语言配置
|
|
105
171
|
|
|
106
172
|
| 场景 | 语言 |
|
|
@@ -109,6 +175,14 @@ npm install -g @google/gemini-cli
|
|
|
109
175
|
| 交互 | 中文 |
|
|
110
176
|
| 代码注释 | 中文 |
|
|
111
177
|
|
|
178
|
+
## ROS2 配置
|
|
179
|
+
|
|
180
|
+
| 项目 | 值 |
|
|
181
|
+
|------|-----|
|
|
182
|
+
| 发行版 | Humble |
|
|
183
|
+
| 目标 | 物理机器人 |
|
|
184
|
+
| 路由模式 | 智能路由 |
|
|
185
|
+
|
|
112
186
|
## 卸载
|
|
113
187
|
|
|
114
188
|
```bash
|
package/package.json
CHANGED