ccg-ros2-workflow 1.0.6 → 1.0.7
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/package.json +1 -1
- package/src/commands/ccg/analyze.md +12 -12
- package/src/commands/ccg/backend.md +17 -17
- package/src/commands/ccg/debug.md +8 -8
- package/src/commands/ccg/execute.md +17 -17
- package/src/commands/ccg/feat.md +15 -15
- package/src/commands/ccg/frontend.md +17 -17
- package/src/commands/ccg/optimize.md +16 -16
- package/src/commands/ccg/plan.md +12 -12
- package/src/commands/ccg/review.md +4 -4
- package/src/commands/ccg/test.md +10 -10
package/package.json
CHANGED
|
@@ -16,8 +16,8 @@ description: '多模型技术分析(并行执行):Codex 底层控制分析
|
|
|
16
16
|
|
|
17
17
|
你是**分析协调者**,编排多模型分析流程:
|
|
18
18
|
- **ace-tool** – 代码上下文检索
|
|
19
|
-
- **Codex** –
|
|
20
|
-
- **Gemini** –
|
|
19
|
+
- **Codex** – 底层控制视角(**C++/实时/硬件权威**)
|
|
20
|
+
- **Gemini** – 上层应用视角(**Python/Launch/集成权威**)
|
|
21
21
|
- **Claude (自己)** – 综合见解
|
|
22
22
|
|
|
23
23
|
---
|
|
@@ -86,13 +86,13 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
86
86
|
|
|
87
87
|
**⚠️ 必须发起两个并行 Bash 调用**(参照上方调用规范):
|
|
88
88
|
|
|
89
|
-
1. **Codex
|
|
89
|
+
1. **Codex 底层控制分析**:`Bash({ command: "...--backend codex...", run_in_background: true })`
|
|
90
90
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/analyzer.md`
|
|
91
|
-
- OUTPUT
|
|
91
|
+
- OUTPUT:控制算法可行性、实时性影响、硬件兼容性
|
|
92
92
|
|
|
93
|
-
2. **Gemini
|
|
93
|
+
2. **Gemini 上层应用分析**:`Bash({ command: "...--backend gemini...", run_in_background: true })`
|
|
94
94
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/analyzer.md`
|
|
95
|
-
- OUTPUT
|
|
95
|
+
- OUTPUT:系统集成影响、节点通信设计、配置管理考量
|
|
96
96
|
|
|
97
97
|
用 `TaskOutput` 等待两个模型的完整结果。**必须等所有模型返回后才能进入下一阶段**。
|
|
98
98
|
|
|
@@ -107,7 +107,7 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
107
107
|
- **一致观点**(强信号)
|
|
108
108
|
- **分歧点**(需权衡)
|
|
109
109
|
- **互补见解**(各自领域洞察)
|
|
110
|
-
3.
|
|
110
|
+
3. 按信任规则权衡:底层控制以 Codex 为准,上层应用以 Gemini 为准
|
|
111
111
|
|
|
112
112
|
### 📊 阶段 4:综合输出
|
|
113
113
|
|
|
@@ -140,13 +140,13 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
140
140
|
|
|
141
141
|
| 场景 | 示例 |
|
|
142
142
|
|------|------|
|
|
143
|
-
|
|
|
144
|
-
| 架构评估 | "
|
|
145
|
-
| 性能分析 | "
|
|
146
|
-
| 安全审计 | "
|
|
143
|
+
| 控制方案 | "比较 PID vs MPC 控制器" |
|
|
144
|
+
| 架构评估 | "评估节点拆分方案" |
|
|
145
|
+
| 性能分析 | "分析控制循环延迟原因" |
|
|
146
|
+
| 安全审计 | "评估急停模块安全性" |
|
|
147
147
|
|
|
148
148
|
## 关键规则
|
|
149
149
|
|
|
150
150
|
1. **仅分析不修改** – 本命令不执行任何代码变更
|
|
151
|
-
2. **信任规则** –
|
|
151
|
+
2. **信任规则** – 底层控制以 Codex 为准,上层应用以 Gemini 为准
|
|
152
152
|
3. 外部模型对文件系统**零写入权限**
|
|
@@ -2,27 +2,27 @@
|
|
|
2
2
|
description: '底层控制专项工作流(研究→构思→计划→执行→优化→评审),Codex 主导控制算法、C++节点、驱动'
|
|
3
3
|
---
|
|
4
4
|
|
|
5
|
-
# Backend -
|
|
5
|
+
# Backend - 底层控制专项开发
|
|
6
6
|
|
|
7
7
|
## 使用方法
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
/backend
|
|
10
|
+
/backend <底层控制任务描述>
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
## 上下文
|
|
14
14
|
|
|
15
|
-
-
|
|
15
|
+
- 底层控制任务:$ARGUMENTS
|
|
16
16
|
- Codex 主导,Gemini 辅助参考
|
|
17
|
-
-
|
|
17
|
+
- 适用:控制算法设计、C++ 节点开发、硬件驱动实现、实时性能优化
|
|
18
18
|
|
|
19
19
|
## 你的角色
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
你是**控制层编排者**,协调多模型完成底层控制任务(研究 → 构思 → 计划 → 执行 → 优化 → 评审),用中文协助用户。
|
|
22
22
|
|
|
23
23
|
**协作模型**:
|
|
24
|
-
- **Codex** –
|
|
25
|
-
- **Gemini** –
|
|
24
|
+
- **Codex** – 底层控制与算法(**C++/实时/硬件权威,可信赖**)
|
|
25
|
+
- **Gemini** – 上层应用视角(**底层控制意见仅供参考**)
|
|
26
26
|
- **Claude (自己)** – 编排、计划、执行、交付
|
|
27
27
|
|
|
28
28
|
---
|
|
@@ -93,7 +93,7 @@ EOF",
|
|
|
93
93
|
|
|
94
94
|
`[模式:研究]` - 理解需求并收集上下文
|
|
95
95
|
|
|
96
|
-
1. **代码检索**(如 ace-tool MCP 可用):调用 `mcp__ace-tool__search_context`
|
|
96
|
+
1. **代码检索**(如 ace-tool MCP 可用):调用 `mcp__ace-tool__search_context` 检索现有控制器、驱动程序、硬件接口
|
|
97
97
|
2. 需求完整性评分(0-10 分):≥7 继续,<7 停止补充
|
|
98
98
|
|
|
99
99
|
### 💡 阶段 2:构思
|
|
@@ -104,7 +104,7 @@ EOF",
|
|
|
104
104
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/analyzer.md`
|
|
105
105
|
- 需求:增强后的需求(如未增强则用 $ARGUMENTS)
|
|
106
106
|
- 上下文:阶段 1 收集的项目上下文
|
|
107
|
-
- OUTPUT:
|
|
107
|
+
- OUTPUT: 控制算法可行性分析、推荐方案(至少 2 个)、实时性风险评估
|
|
108
108
|
|
|
109
109
|
**📌 保存 SESSION_ID**(`CODEX_SESSION`)用于后续阶段复用。
|
|
110
110
|
|
|
@@ -118,7 +118,7 @@ EOF",
|
|
|
118
118
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/architect.md`
|
|
119
119
|
- 需求:用户选择的方案
|
|
120
120
|
- 上下文:阶段 2 的分析结果
|
|
121
|
-
- OUTPUT:
|
|
121
|
+
- OUTPUT: 节点架构、控制器设计、硬件接口定义
|
|
122
122
|
|
|
123
123
|
Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
124
124
|
|
|
@@ -127,8 +127,8 @@ Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
|
127
127
|
`[模式:执行]` - 代码开发
|
|
128
128
|
|
|
129
129
|
- 严格按批准的计划实施
|
|
130
|
-
-
|
|
131
|
-
-
|
|
130
|
+
- 遵循 ROS2 C++ 代码规范
|
|
131
|
+
- 确保实时性、内存安全、硬件兼容性
|
|
132
132
|
|
|
133
133
|
### 🚀 阶段 5:优化
|
|
134
134
|
|
|
@@ -136,9 +136,9 @@ Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
|
136
136
|
|
|
137
137
|
**⚠️ 必须调用 Codex**(参照上方调用规范):
|
|
138
138
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/reviewer.md`
|
|
139
|
-
-
|
|
139
|
+
- 需求:审查以下底层控制代码变更
|
|
140
140
|
- 上下文:git diff 或代码内容
|
|
141
|
-
- OUTPUT:
|
|
141
|
+
- OUTPUT: 实时性、内存安全、硬件兼容性、控制精度问题列表
|
|
142
142
|
|
|
143
143
|
整合审查意见,用户确认后执行优化。
|
|
144
144
|
|
|
@@ -147,14 +147,14 @@ Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
|
147
147
|
`[模式:评审]` - 最终评估
|
|
148
148
|
|
|
149
149
|
- 对照计划检查完成情况
|
|
150
|
-
-
|
|
150
|
+
- 运行测试验证控制功能
|
|
151
151
|
- 报告问题与建议
|
|
152
152
|
|
|
153
153
|
---
|
|
154
154
|
|
|
155
155
|
## 关键规则
|
|
156
156
|
|
|
157
|
-
1. **Codex
|
|
158
|
-
2. **Gemini
|
|
157
|
+
1. **Codex 底层控制(C++/实时/硬件)意见可信赖**
|
|
158
|
+
2. **Gemini 底层控制意见仅供参考**
|
|
159
159
|
3. 外部模型对文件系统**零写入权限**
|
|
160
160
|
4. Claude 负责所有代码写入和文件操作
|
|
@@ -15,8 +15,8 @@ description: '多模型调试:Codex 底层控制诊断 + Gemini 上层应用
|
|
|
15
15
|
## 你的角色
|
|
16
16
|
|
|
17
17
|
你是**调试协调者**,编排多模型诊断流程:
|
|
18
|
-
- **Codex** –
|
|
19
|
-
- **Gemini** –
|
|
18
|
+
- **Codex** – 底层控制诊断(**底层控制问题权威**)
|
|
19
|
+
- **Gemini** – 上层应用诊断(**上层应用问题权威**)
|
|
20
20
|
- **Claude (自己)** – 综合诊断、执行修复
|
|
21
21
|
|
|
22
22
|
---
|
|
@@ -77,7 +77,7 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
77
77
|
|
|
78
78
|
1. 调用 `mcp__ace-tool__search_context` 检索相关代码(如可用)
|
|
79
79
|
2. 收集错误日志、堆栈信息、复现步骤
|
|
80
|
-
3. 识别问题类型:[
|
|
80
|
+
3. 识别问题类型:[底层控制/上层应用/全栈]
|
|
81
81
|
|
|
82
82
|
### 🔬 阶段 2:并行诊断
|
|
83
83
|
|
|
@@ -85,11 +85,11 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
85
85
|
|
|
86
86
|
**⚠️ 必须发起两个并行 Bash 调用**(参照上方调用规范):
|
|
87
87
|
|
|
88
|
-
1. **Codex
|
|
88
|
+
1. **Codex 底层控制诊断**:`Bash({ command: "...--backend codex...", run_in_background: true })`
|
|
89
89
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/debugger.md`
|
|
90
90
|
- OUTPUT:诊断假设(按可能性排序),每个假设包含原因、证据、修复建议
|
|
91
91
|
|
|
92
|
-
2. **Gemini
|
|
92
|
+
2. **Gemini 上层应用诊断**:`Bash({ command: "...--backend gemini...", run_in_background: true })`
|
|
93
93
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/debugger.md`
|
|
94
94
|
- OUTPUT:诊断假设(按可能性排序),每个假设包含原因、证据、修复建议
|
|
95
95
|
|
|
@@ -112,10 +112,10 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
112
112
|
```markdown
|
|
113
113
|
## 🔍 诊断结果
|
|
114
114
|
|
|
115
|
-
### Codex
|
|
115
|
+
### Codex 分析(底层控制视角)
|
|
116
116
|
<诊断摘要>
|
|
117
117
|
|
|
118
|
-
### Gemini
|
|
118
|
+
### Gemini 分析(上层应用视角)
|
|
119
119
|
<诊断摘要>
|
|
120
120
|
|
|
121
121
|
### 综合诊断
|
|
@@ -141,5 +141,5 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
141
141
|
## 关键规则
|
|
142
142
|
|
|
143
143
|
1. **用户确认** – 修复前必须获得确认
|
|
144
|
-
2. **信任规则** –
|
|
144
|
+
2. **信任规则** – 底层控制问题以 Codex 为准,上层应用问题以 Gemini 为准
|
|
145
145
|
3. 外部模型对文件系统**零写入权限**
|
|
@@ -125,9 +125,9 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
125
125
|
|
|
126
126
|
| 任务类型 | 判断依据 | 路由 |
|
|
127
127
|
|----------|----------|------|
|
|
128
|
-
|
|
|
129
|
-
|
|
|
130
|
-
| **全栈** |
|
|
128
|
+
| **上层应用** | Python 节点、Launch、配置、可视化 | Gemini |
|
|
129
|
+
| **底层控制** | C++ 节点、控制算法、硬件驱动 | Codex |
|
|
130
|
+
| **全栈** | 同时包含上层和底层 | Codex ∥ Gemini 并行 |
|
|
131
131
|
|
|
132
132
|
---
|
|
133
133
|
|
|
@@ -165,30 +165,30 @@ mcp__ace-tool__search_context({
|
|
|
165
165
|
|
|
166
166
|
**根据任务类型路由**:
|
|
167
167
|
|
|
168
|
-
#### Route A:
|
|
168
|
+
#### Route A: 上层应用/Python/Launch → Gemini
|
|
169
169
|
|
|
170
170
|
**限制**:上下文 < 32k tokens
|
|
171
171
|
|
|
172
172
|
1. 调用 Gemini(使用 `$HOME/.claude/.ccg/prompts/gemini/frontend.md`)
|
|
173
173
|
2. 输入:计划内容 + 检索到的上下文 + 目标文件
|
|
174
174
|
3. OUTPUT: `Unified Diff Patch ONLY. Strictly prohibit any actual modifications.`
|
|
175
|
-
4. **Gemini
|
|
176
|
-
5. ⚠️ **警告**:忽略 Gemini
|
|
175
|
+
4. **Gemini 是上层应用的权威,其 Python/Launch/配置原型为最终基准**
|
|
176
|
+
5. ⚠️ **警告**:忽略 Gemini 对底层控制逻辑的建议
|
|
177
177
|
6. 若计划包含 `GEMINI_SESSION`:优先 `resume <GEMINI_SESSION>`
|
|
178
178
|
|
|
179
|
-
#### Route B:
|
|
179
|
+
#### Route B: 底层控制/C++/算法 → Codex
|
|
180
180
|
|
|
181
181
|
1. 调用 Codex(使用 `$HOME/.claude/.ccg/prompts/codex/architect.md`)
|
|
182
182
|
2. 输入:计划内容 + 检索到的上下文 + 目标文件
|
|
183
183
|
3. OUTPUT: `Unified Diff Patch ONLY. Strictly prohibit any actual modifications.`
|
|
184
|
-
4. **Codex
|
|
184
|
+
4. **Codex 是底层控制的权威,利用其实时性与算法能力**
|
|
185
185
|
5. 若计划包含 `CODEX_SESSION`:优先 `resume <CODEX_SESSION>`
|
|
186
186
|
|
|
187
187
|
#### Route C: 全栈 → 并行调用
|
|
188
188
|
|
|
189
189
|
1. **并行调用**(`run_in_background: true`):
|
|
190
|
-
- Gemini
|
|
191
|
-
- Codex
|
|
190
|
+
- Gemini:处理上层应用部分
|
|
191
|
+
- Codex:处理底层控制部分
|
|
192
192
|
2. 用 `TaskOutput` 等待两个模型的完整结果
|
|
193
193
|
3. 各自使用计划中对应的 `SESSION_ID` 进行 `resume`(若缺失则创建新会话)
|
|
194
194
|
|
|
@@ -210,7 +210,7 @@ mcp__ace-tool__search_context({
|
|
|
210
210
|
- 识别潜在冲突或副作用
|
|
211
211
|
|
|
212
212
|
3. **重构清理**:
|
|
213
|
-
- 将"脏原型"
|
|
213
|
+
- 将"脏原型"重构为**高可读、高可维护性、生产级代码**
|
|
214
214
|
- 去除冗余代码
|
|
215
215
|
- 确保符合项目现有代码规范
|
|
216
216
|
- **非必要不生成注释与文档**,代码自解释
|
|
@@ -240,19 +240,19 @@ mcp__ace-tool__search_context({
|
|
|
240
240
|
1. **Codex 审查**(`run_in_background: true`):
|
|
241
241
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/reviewer.md`
|
|
242
242
|
- 输入:变更的 Diff + 目标文件
|
|
243
|
-
-
|
|
243
|
+
- 关注:实时性、内存安全、算法正确性
|
|
244
244
|
|
|
245
245
|
2. **Gemini 审查**(`run_in_background: true`):
|
|
246
246
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/reviewer.md`
|
|
247
247
|
- 输入:变更的 Diff + 目标文件
|
|
248
|
-
-
|
|
248
|
+
- 关注:节点通信、配置完整性、系统集成
|
|
249
249
|
|
|
250
250
|
用 `TaskOutput` 等待两个模型的完整审查结果。优先复用 Phase 3 的会话(`resume <SESSION_ID>`)以保持上下文一致。
|
|
251
251
|
|
|
252
252
|
#### 5.2 整合修复
|
|
253
253
|
|
|
254
254
|
1. 综合 Codex + Gemini 的审查意见
|
|
255
|
-
2.
|
|
255
|
+
2. 按信任规则权衡:底层控制以 Codex 为准,上层应用以 Gemini 为准
|
|
256
256
|
3. 执行必要的修复
|
|
257
257
|
4. 修复后按需重复 Phase 5.1(直到风险可接受)
|
|
258
258
|
|
|
@@ -266,7 +266,7 @@ mcp__ace-tool__search_context({
|
|
|
266
266
|
### 变更摘要
|
|
267
267
|
| 文件 | 操作 | 说明 |
|
|
268
268
|
|------|------|------|
|
|
269
|
-
| path/to/file.
|
|
269
|
+
| path/to/file.cpp | 修改 | 描述 |
|
|
270
270
|
|
|
271
271
|
### 审计结果
|
|
272
272
|
- Codex:<通过/发现 N 个问题>
|
|
@@ -283,7 +283,7 @@ mcp__ace-tool__search_context({
|
|
|
283
283
|
|
|
284
284
|
1. **代码主权** – 所有文件修改由 Claude 执行,外部模型零写入权限
|
|
285
285
|
2. **脏原型重构** – Codex/Gemini 的输出视为草稿,必须重构
|
|
286
|
-
3. **信任规则** –
|
|
286
|
+
3. **信任规则** – 底层控制以 Codex 为准,上层应用以 Gemini 为准
|
|
287
287
|
4. **最小变更** – 仅修改必要的代码,不引入副作用
|
|
288
288
|
5. **强制审计** – 变更后必须进行多模型 Code Review
|
|
289
289
|
|
|
@@ -296,7 +296,7 @@ mcp__ace-tool__search_context({
|
|
|
296
296
|
/ccg:execute .claude/plan/功能名.md
|
|
297
297
|
|
|
298
298
|
# 直接执行任务(适用于已在上下文中讨论过的计划)
|
|
299
|
-
/ccg:execute
|
|
299
|
+
/ccg:execute 根据之前的计划实施控制器功能
|
|
300
300
|
```
|
|
301
301
|
|
|
302
302
|
---
|
package/src/commands/ccg/feat.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: '智能功能开发 -
|
|
2
|
+
description: '智能功能开发 - 自动识别输入类型,规划/讨论/实施全流程(ROS2 Humble 物理机器人)'
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# Feat - 智能功能开发
|
|
@@ -98,29 +98,29 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
98
98
|
|
|
99
99
|
#### 2.1 上下文检索
|
|
100
100
|
|
|
101
|
-
调用 `mcp__ace-tool__search_context`
|
|
101
|
+
调用 `mcp__ace-tool__search_context` 检索相关代码、节点、技术栈。
|
|
102
102
|
|
|
103
103
|
#### 2.2 任务类型判断
|
|
104
104
|
|
|
105
105
|
| 任务类型 | 判断依据 | 调用流程 |
|
|
106
106
|
|----------|----------|----------|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
107
|
+
| **上层应用** | Launch、RViz、参数、配置、Python 节点 | ui-ux-designer → planner |
|
|
108
|
+
| **底层控制** | 控制算法、C++ 节点、硬件驱动、实时性能 | planner |
|
|
109
|
+
| **系统集成** | 同时包含上层应用与底层控制 | ui-ux-designer → planner |
|
|
110
110
|
|
|
111
111
|
#### 2.3 调用 Agents
|
|
112
112
|
|
|
113
|
-
|
|
113
|
+
**上层应用/系统集成任务**:先调用 `ui-ux-designer` agent
|
|
114
114
|
```
|
|
115
115
|
执行 agent: $HOME/.claude/agents/ccg/ui-ux-designer.md
|
|
116
116
|
输入: 项目上下文 + 用户需求 + 技术栈
|
|
117
|
-
输出:
|
|
117
|
+
输出: 系统集成设计方案
|
|
118
118
|
```
|
|
119
119
|
|
|
120
120
|
**所有任务**:调用 `planner` agent
|
|
121
121
|
```
|
|
122
122
|
执行 agent: $HOME/.claude/agents/ccg/planner.md
|
|
123
|
-
输入: 项目上下文 +
|
|
123
|
+
输入: 项目上下文 + 上层应用方案(如有) + 用户需求
|
|
124
124
|
输出: 功能规划文档
|
|
125
125
|
```
|
|
126
126
|
|
|
@@ -148,15 +148,15 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
148
148
|
|
|
149
149
|
#### 3.2 任务类型分析
|
|
150
150
|
|
|
151
|
-
|
|
151
|
+
从计划提取任务分类:上层应用 / 底层控制 / 系统集成
|
|
152
152
|
|
|
153
153
|
#### 3.3 多模型路由实施
|
|
154
154
|
|
|
155
155
|
按上方调用规范调用外部模型:
|
|
156
156
|
|
|
157
|
-
-
|
|
158
|
-
-
|
|
159
|
-
-
|
|
157
|
+
- **上层应用任务**:调用 Gemini,使用实施提示词
|
|
158
|
+
- **底层控制任务**:调用 Codex,使用实施提示词
|
|
159
|
+
- **系统集成任务**:并行调用 Codex + Gemini(`run_in_background: true`),用 `TaskOutput` 等待结果
|
|
160
160
|
|
|
161
161
|
**⚠️ 强制规则:必须等待 TaskOutput 返回所有模型的完整结果后才能进入下一阶段**
|
|
162
162
|
|
|
@@ -177,10 +177,10 @@ git diff --name-status
|
|
|
177
177
|
|
|
178
178
|
1. **强制响应要求**:每次交互必须首先说明判断的操作类型
|
|
179
179
|
2. **文档一致性**:规划文档与实际执行保持同步
|
|
180
|
-
3.
|
|
180
|
+
3. **依赖关系管理**:上层应用任务必须确保 Launch/RViz 配置完整性
|
|
181
181
|
4. **多模型信任规则**:
|
|
182
|
-
-
|
|
183
|
-
-
|
|
182
|
+
- 上层应用以 Gemini 为准
|
|
183
|
+
- 底层控制以 Codex 为准
|
|
184
184
|
5. **用户沟通透明**:所有判断和动作都要明确告知用户
|
|
185
185
|
|
|
186
186
|
---
|
|
@@ -2,27 +2,27 @@
|
|
|
2
2
|
description: '上层应用专项工作流(研究→构思→计划→执行→优化→评审),Gemini 主导集成、可视化、Launch、Python节点'
|
|
3
3
|
---
|
|
4
4
|
|
|
5
|
-
# Frontend -
|
|
5
|
+
# Frontend - 上层应用专项开发
|
|
6
6
|
|
|
7
7
|
## 使用方法
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
/frontend
|
|
10
|
+
/frontend <应用集成任务描述>
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
## 上下文
|
|
14
14
|
|
|
15
|
-
-
|
|
15
|
+
- 上层应用任务:$ARGUMENTS
|
|
16
16
|
- Gemini 主导,Codex 辅助参考
|
|
17
|
-
-
|
|
17
|
+
- 适用:Python 节点开发、Launch 启动编排、RViz 可视化配置、参数与配置管理
|
|
18
18
|
|
|
19
19
|
## 你的角色
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
你是**应用层编排者**,协调多模型完成应用集成任务(研究 → 构思 → 计划 → 执行 → 优化 → 评审),用中文协助用户。
|
|
22
22
|
|
|
23
23
|
**协作模型**:
|
|
24
|
-
- **Gemini** –
|
|
25
|
-
- **Codex** –
|
|
24
|
+
- **Gemini** – 上层应用与集成(**Python/Launch/可视化权威,可信赖**)
|
|
25
|
+
- **Codex** – 底层系统视角(**上层应用意见仅供参考**)
|
|
26
26
|
- **Claude (自己)** – 编排、计划、执行、交付
|
|
27
27
|
|
|
28
28
|
---
|
|
@@ -93,7 +93,7 @@ EOF",
|
|
|
93
93
|
|
|
94
94
|
`[模式:研究]` - 理解需求并收集上下文
|
|
95
95
|
|
|
96
|
-
1. **代码检索**(如 ace-tool MCP 可用):调用 `mcp__ace-tool__search_context`
|
|
96
|
+
1. **代码检索**(如 ace-tool MCP 可用):调用 `mcp__ace-tool__search_context` 检索现有 Python 节点、Launch 文件、可视化配置
|
|
97
97
|
2. 需求完整性评分(0-10 分):≥7 继续,<7 停止补充
|
|
98
98
|
|
|
99
99
|
### 💡 阶段 2:构思
|
|
@@ -104,7 +104,7 @@ EOF",
|
|
|
104
104
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/analyzer.md`
|
|
105
105
|
- 需求:增强后的需求(如未增强则用 $ARGUMENTS)
|
|
106
106
|
- 上下文:阶段 1 收集的项目上下文
|
|
107
|
-
- OUTPUT:
|
|
107
|
+
- OUTPUT: 应用集成可行性分析、推荐方案(至少 2 个)、系统集成评估
|
|
108
108
|
|
|
109
109
|
**📌 保存 SESSION_ID**(`GEMINI_SESSION`)用于后续阶段复用。
|
|
110
110
|
|
|
@@ -118,7 +118,7 @@ EOF",
|
|
|
118
118
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/architect.md`
|
|
119
119
|
- 需求:用户选择的方案
|
|
120
120
|
- 上下文:阶段 2 的分析结果
|
|
121
|
-
- OUTPUT:
|
|
121
|
+
- OUTPUT: 节点交互逻辑、Launch 启动树、参数配置方案
|
|
122
122
|
|
|
123
123
|
Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
124
124
|
|
|
@@ -127,8 +127,8 @@ Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
|
127
127
|
`[模式:执行]` - 代码开发
|
|
128
128
|
|
|
129
129
|
- 严格按批准的计划实施
|
|
130
|
-
-
|
|
131
|
-
-
|
|
130
|
+
- 遵循 ROS2 Python 代码规范
|
|
131
|
+
- 确保节点通信正确、参数配置完整
|
|
132
132
|
|
|
133
133
|
### 🚀 阶段 5:优化
|
|
134
134
|
|
|
@@ -136,9 +136,9 @@ Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
|
136
136
|
|
|
137
137
|
**⚠️ 必须调用 Gemini**(参照上方调用规范):
|
|
138
138
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/reviewer.md`
|
|
139
|
-
-
|
|
139
|
+
- 需求:审查以下上层应用代码变更
|
|
140
140
|
- 上下文:git diff 或代码内容
|
|
141
|
-
- OUTPUT:
|
|
141
|
+
- OUTPUT: 节点通信效率、启动稳定性、可视化清晰度、配置规范性问题列表
|
|
142
142
|
|
|
143
143
|
整合审查意见,用户确认后执行优化。
|
|
144
144
|
|
|
@@ -147,14 +147,14 @@ Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
|
147
147
|
`[模式:评审]` - 最终评估
|
|
148
148
|
|
|
149
149
|
- 对照计划检查完成情况
|
|
150
|
-
-
|
|
150
|
+
- 验证启动流程和可视化效果
|
|
151
151
|
- 报告问题与建议
|
|
152
152
|
|
|
153
153
|
---
|
|
154
154
|
|
|
155
155
|
## 关键规则
|
|
156
156
|
|
|
157
|
-
1. **Gemini
|
|
158
|
-
2. **Codex
|
|
157
|
+
1. **Gemini 上层应用(Python/Launch/可视化)意见可信赖**
|
|
158
|
+
2. **Codex 上层应用意见仅供参考**
|
|
159
159
|
3. 外部模型对文件系统**零写入权限**
|
|
160
160
|
4. Claude 负责所有代码写入和文件操作
|
|
@@ -15,14 +15,14 @@ description: '多模型性能优化:Codex 底层实时性优化 + Gemini 上
|
|
|
15
15
|
## 上下文
|
|
16
16
|
|
|
17
17
|
- 优化目标:$ARGUMENTS
|
|
18
|
-
- Codex
|
|
19
|
-
- Gemini
|
|
18
|
+
- Codex 专注底层控制性能(实时性、内存、算法效率)
|
|
19
|
+
- Gemini 专注上层应用性能(节点通信、启动时间、资源占用)
|
|
20
20
|
|
|
21
21
|
## 你的角色
|
|
22
22
|
|
|
23
23
|
你是**性能工程师**,编排多模型优化流程:
|
|
24
|
-
- **Codex** –
|
|
25
|
-
- **Gemini** –
|
|
24
|
+
- **Codex** – 底层控制性能优化(**C++/实时/硬件权威**)
|
|
25
|
+
- **Gemini** – 上层应用性能优化(**Python/Launch/集成权威**)
|
|
26
26
|
- **Claude (自己)** – 综合优化、实施变更
|
|
27
27
|
|
|
28
28
|
---
|
|
@@ -97,14 +97,14 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
97
97
|
|
|
98
98
|
**⚠️ 必须发起两个并行 Bash 调用**(参照上方调用规范):
|
|
99
99
|
|
|
100
|
-
1. **Codex
|
|
100
|
+
1. **Codex 底层控制分析**:`Bash({ command: "...--backend codex...", run_in_background: true })`
|
|
101
101
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/optimizer.md`
|
|
102
|
-
-
|
|
102
|
+
- 需求:分析底层控制性能问题($ARGUMENTS)
|
|
103
103
|
- OUTPUT:性能瓶颈列表、优化方案、预期收益
|
|
104
104
|
|
|
105
|
-
2. **Gemini
|
|
105
|
+
2. **Gemini 上层应用分析**:`Bash({ command: "...--backend gemini...", run_in_background: true })`
|
|
106
106
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/optimizer.md`
|
|
107
|
-
-
|
|
107
|
+
- 需求:分析上层应用性能问题(节点通信、启动时间)
|
|
108
108
|
- OUTPUT:性能瓶颈列表、优化方案、预期收益
|
|
109
109
|
|
|
110
110
|
用 `TaskOutput` 等待两个模型的完整结果。**必须等所有模型返回后才能进入下一阶段**。
|
|
@@ -137,17 +137,17 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
137
137
|
|
|
138
138
|
| 类型 | 指标 | 良好 | 需优化 |
|
|
139
139
|
|------|------|------|--------|
|
|
140
|
-
|
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
|
|
|
140
|
+
| 底层控制 | 控制周期 | <1ms | >10ms |
|
|
141
|
+
| 底层控制 | 实时抖动 | <100μs | >1ms |
|
|
142
|
+
| 上层应用 | 节点启动 | <2s | >5s |
|
|
143
|
+
| 上层应用 | 消息延迟 | <10ms | >100ms |
|
|
144
|
+
| 上层应用 | CPU 占用 | <50% | >80% |
|
|
145
145
|
|
|
146
146
|
## 常见优化模式
|
|
147
147
|
|
|
148
|
-
|
|
148
|
+
**底层控制**:锁竞争→无锁队列、频繁分配→内存池、阻塞调用→异步回调、低效算法→优化数据结构
|
|
149
149
|
|
|
150
|
-
|
|
150
|
+
**上层应用**:串行启动→并行Launch、频繁话题→QoS调优、大消息→压缩/分片、Python瓶颈→C++重写
|
|
151
151
|
|
|
152
152
|
---
|
|
153
153
|
|
|
@@ -156,4 +156,4 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
156
156
|
1. **先测量后优化** – 没有数据不盲目优化
|
|
157
157
|
2. **性价比优先** – 高影响 + 低难度优先
|
|
158
158
|
3. **不破坏功能** – 优化不能引入 bug
|
|
159
|
-
4. **信任规则** –
|
|
159
|
+
4. **信任规则** – 底层控制以 Codex 为准,上层应用以 Gemini 为准
|
package/src/commands/ccg/plan.md
CHANGED
|
@@ -118,14 +118,14 @@ mcp__ace-tool__search_context({
|
|
|
118
118
|
|
|
119
119
|
将**原始需求**(不带预设观点)分发给两个模型:
|
|
120
120
|
|
|
121
|
-
1. **Codex
|
|
121
|
+
1. **Codex 底层控制分析**:
|
|
122
122
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/analyzer.md`
|
|
123
|
-
-
|
|
123
|
+
- 关注:实时性能、算法正确性、内存安全、硬件接口
|
|
124
124
|
- OUTPUT: 多角度解决方案 + 优劣势分析
|
|
125
125
|
|
|
126
|
-
2. **Gemini
|
|
126
|
+
2. **Gemini 上层应用分析**:
|
|
127
127
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/analyzer.md`
|
|
128
|
-
-
|
|
128
|
+
- 关注:系统集成 影响、节点交互、可视化配置
|
|
129
129
|
- OUTPUT: 多角度解决方案 + 优劣势分析
|
|
130
130
|
|
|
131
131
|
用 `TaskOutput` 等待两个模型的完整结果。**📌 保存 SESSION_ID**(`CODEX_SESSION` 和 `GEMINI_SESSION`)。
|
|
@@ -136,20 +136,20 @@ mcp__ace-tool__search_context({
|
|
|
136
136
|
|
|
137
137
|
1. **识别一致观点**(强信号)
|
|
138
138
|
2. **识别分歧点**(需权衡)
|
|
139
|
-
3.
|
|
139
|
+
3. **互补优势**:底层控制逻辑以 Codex 为准,上层应用设计以 Gemini 为准
|
|
140
140
|
4. **逻辑推演**:消除方案中的逻辑漏洞
|
|
141
141
|
|
|
142
142
|
#### 2.3(可选但推荐)双模型产出“计划草案”
|
|
143
143
|
|
|
144
144
|
为降低 Claude 合成计划的遗漏风险,可并行让两个模型输出“计划草案”(仍然**不允许**修改文件):
|
|
145
145
|
|
|
146
|
-
1. **Codex
|
|
146
|
+
1. **Codex 计划草案**(C++/实时/硬件权威):
|
|
147
147
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/architect.md`
|
|
148
148
|
- OUTPUT: Step-by-step plan + pseudo-code(重点:数据流/边界条件/错误处理/测试策略)
|
|
149
149
|
|
|
150
|
-
2. **Gemini
|
|
150
|
+
2. **Gemini 计划草案**(Python/Launch/集成权威):
|
|
151
151
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/architect.md`
|
|
152
|
-
- OUTPUT: Step-by-step plan + pseudo-code
|
|
152
|
+
- OUTPUT: Step-by-step plan + pseudo-code(重点:节点通信/参数配置/Launch编排/可视化效果)
|
|
153
153
|
|
|
154
154
|
用 `TaskOutput` 等待两个模型的完整结果,并记录其建议的关键差异点。
|
|
155
155
|
|
|
@@ -161,8 +161,8 @@ mcp__ace-tool__search_context({
|
|
|
161
161
|
## 📋 实施计划:<任务名称>
|
|
162
162
|
|
|
163
163
|
### 任务类型
|
|
164
|
-
- [ ]
|
|
165
|
-
- [ ]
|
|
164
|
+
- [ ] 上层应用 (→ Gemini)
|
|
165
|
+
- [ ] 底层控制 (→ Codex)
|
|
166
166
|
- [ ] 全栈 (→ 并行)
|
|
167
167
|
|
|
168
168
|
### 技术方案
|
|
@@ -176,7 +176,7 @@ mcp__ace-tool__search_context({
|
|
|
176
176
|
### 关键文件
|
|
177
177
|
| 文件 | 操作 | 说明 |
|
|
178
178
|
|------|------|------|
|
|
179
|
-
| path/to/
|
|
179
|
+
| path/to/node.cpp:L10-L50 | 修改 | 描述 |
|
|
180
180
|
|
|
181
181
|
### 风险与缓解
|
|
182
182
|
| 风险 | 缓解措施 |
|
|
@@ -255,6 +255,6 @@ mcp__ace-tool__search_context({
|
|
|
255
255
|
|
|
256
256
|
1. **仅规划不实施** – 本命令不执行任何代码变更
|
|
257
257
|
2. **不问 Y/N** – 只展示计划,让用户决定下一步
|
|
258
|
-
3. **信任规则** –
|
|
258
|
+
3. **信任规则** – 底层控制以 Codex 为准,上层应用以 Gemini 为准
|
|
259
259
|
4. 外部模型对文件系统**零写入权限**
|
|
260
260
|
5. **SESSION_ID 交接** – 计划末尾必须包含 `CODEX_SESSION` / `GEMINI_SESSION`(供 `/ccg:execute resume <SESSION_ID>` 使用)
|
|
@@ -77,15 +77,15 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
77
77
|
|
|
78
78
|
**⚠️ 必须发起两个并行 Bash 调用**(参照上方调用规范):
|
|
79
79
|
|
|
80
|
-
1. **Codex
|
|
80
|
+
1. **Codex 底层控制审查**:`Bash({ command: "...--backend codex...", run_in_background: true })`
|
|
81
81
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/reviewer.md`
|
|
82
82
|
- 需求:审查代码变更(git diff 内容)
|
|
83
83
|
- OUTPUT:按 Critical/Major/Minor/Suggestion 分类列出安全性、性能、错误处理问题
|
|
84
84
|
|
|
85
|
-
2. **Gemini
|
|
85
|
+
2. **Gemini 上层应用审查**:`Bash({ command: "...--backend gemini...", run_in_background: true })`
|
|
86
86
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/reviewer.md`
|
|
87
87
|
- 需求:审查代码变更(git diff 内容)
|
|
88
|
-
- OUTPUT:按 Critical/Major/Minor/Suggestion
|
|
88
|
+
- OUTPUT:按 Critical/Major/Minor/Suggestion 分类列出Launch编排、可视化配置、参数一致性问题
|
|
89
89
|
|
|
90
90
|
用 `TaskOutput` 等待两个模型的审查结果。**必须等所有模型返回后才能进入下一阶段**。
|
|
91
91
|
|
|
@@ -126,5 +126,5 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
126
126
|
## 关键规则
|
|
127
127
|
|
|
128
128
|
1. **无参数 = 审查 git diff** – 自动获取当前变更
|
|
129
|
-
2. **双模型交叉验证** –
|
|
129
|
+
2. **双模型交叉验证** – 底层控制问题以 Codex 为准,上层应用问题以 Gemini 为准
|
|
130
130
|
3. 外部模型对文件系统**零写入权限**
|
package/src/commands/ccg/test.md
CHANGED
|
@@ -15,14 +15,14 @@ description: '多模型测试生成:智能路由 Codex 底层单元测试 / Ge
|
|
|
15
15
|
## 上下文
|
|
16
16
|
|
|
17
17
|
- 测试目标:$ARGUMENTS
|
|
18
|
-
-
|
|
18
|
+
- 智能路由:底层控制 → Codex,上层应用 → Gemini,全栈 → 并行
|
|
19
19
|
- 遵循项目现有测试框架和风格
|
|
20
20
|
|
|
21
21
|
## 你的角色
|
|
22
22
|
|
|
23
23
|
你是**测试工程师**,编排测试生成流程:
|
|
24
|
-
- **Codex** –
|
|
25
|
-
- **Gemini** –
|
|
24
|
+
- **Codex** – 底层控制测试生成(**C++/实时/硬件权威**)
|
|
25
|
+
- **Gemini** – 上层应用测试生成(**Python/Launch/集成权威**)
|
|
26
26
|
- **Claude (自己)** – 整合测试、验证运行
|
|
27
27
|
|
|
28
28
|
---
|
|
@@ -62,8 +62,8 @@ EOF",
|
|
|
62
62
|
|
|
63
63
|
| 代码类型 | 路由 |
|
|
64
64
|
|---------|------|
|
|
65
|
-
|
|
|
66
|
-
|
|
|
65
|
+
| 底层控制 | Codex |
|
|
66
|
+
| 上层应用 | Gemini |
|
|
67
67
|
| 全栈 | 并行执行两者 |
|
|
68
68
|
|
|
69
69
|
**并行调用**:使用 `run_in_background: true` 启动,用 `TaskOutput` 等待结果。**必须等所有模型返回后才能进入下一阶段**。
|
|
@@ -95,7 +95,7 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
95
95
|
|
|
96
96
|
1. 检索目标代码的完整实现
|
|
97
97
|
2. 查找现有测试文件和测试框架配置
|
|
98
|
-
3. 识别代码类型:[
|
|
98
|
+
3. 识别代码类型:[底层控制/上层应用/全栈]
|
|
99
99
|
4. 评估当前测试覆盖率和缺口
|
|
100
100
|
|
|
101
101
|
### 🔬 阶段 2:智能路由测试生成
|
|
@@ -104,9 +104,9 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
|
|
|
104
104
|
|
|
105
105
|
**⚠️ 根据代码类型必须调用对应模型**(参照上方调用规范):
|
|
106
106
|
|
|
107
|
-
-
|
|
107
|
+
- **底层控制代码** → `Bash({ command: "...--backend codex...", run_in_background: false })`
|
|
108
108
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/codex/tester.md`
|
|
109
|
-
-
|
|
109
|
+
- **上层应用代码** → `Bash({ command: "...--backend gemini...", run_in_background: false })`
|
|
110
110
|
- ROLE_FILE: `$HOME/.claude/.ccg/prompts/gemini/tester.md`
|
|
111
111
|
- **全栈代码** → 并行调用两者:
|
|
112
112
|
1. `Bash({ command: "...--backend codex...", run_in_background: true })`
|
|
@@ -144,7 +144,7 @@ OUTPUT:完整测试代码(使用项目现有测试框架,覆盖正常路
|
|
|
144
144
|
## 🧪 测试生成:<测试目标>
|
|
145
145
|
|
|
146
146
|
### 分析结果
|
|
147
|
-
- 代码类型:[
|
|
147
|
+
- 代码类型:[底层控制/上层应用/全栈]
|
|
148
148
|
- 测试框架:<检测到的框架>
|
|
149
149
|
|
|
150
150
|
### 生成的测试
|
|
@@ -169,6 +169,6 @@ OUTPUT:完整测试代码(使用项目现有测试框架,覆盖正常路
|
|
|
169
169
|
## 关键规则
|
|
170
170
|
|
|
171
171
|
1. **测试行为,不测试实现** – 关注输入输出
|
|
172
|
-
2. **智能路由** –
|
|
172
|
+
2. **智能路由** – 底层控制测试用 Codex,上层应用测试用 Gemini
|
|
173
173
|
3. **复用现有模式** – 遵循项目已有的测试风格
|
|
174
174
|
4. 外部模型对文件系统**零写入权限**
|