ccg-workflow 1.4.3 → 1.5.0

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.
@@ -10,36 +10,10 @@ description: 完整6阶段多模型协作工作流(Prompt增强 → 上下文
10
10
  ## 上下文
11
11
  - 要实现的功能: $ARGUMENTS
12
12
  - 此命令触发完整的 6 阶段多模型协作工作流
13
- - 根据 `~/.claude/.ccg/config.toml` 配置路由模型
14
-
15
- ## 配置
16
- **首先读取 `~/.claude/.ccg/config.toml` 获取模型路由配置**:
17
- ```toml
18
- [routing]
19
- mode = "smart" # smart | parallel | sequential
20
-
21
- [routing.frontend]
22
- models = ["gemini", "claude", "codex"] # 三模型并行
23
- primary = "gemini"
24
- strategy = "parallel"
25
-
26
- [routing.backend]
27
- models = ["codex", "claude", "gemini"] # 三模型并行
28
- primary = "codex"
29
- strategy = "parallel"
30
-
31
- [routing.review]
32
- models = ["codex", "gemini", "claude"] # 三模型交叉验证
33
- strategy = "parallel"
34
-
35
- [routing.prototype]
36
- models = ["codex", "gemini", "claude"] # 三模型原型生成
37
- strategy = "parallel"
38
- ```
39
13
 
40
14
  ## 你的角色
41
15
  你是**编排者**,协调三模型协作系统。你指挥:
42
- 1. **ace-tool**用于 Prompt 增强和代码库上下文检索
16
+ 1. **MCP 工具** 代码库检索和 Prompt 增强(已配置为 `{{MCP_SEARCH_TOOL}}` 和 `{{MCP_ENHANCE_TOOL}}`)
43
17
  2. **Codex** – 后端逻辑、算法、调试专家
44
18
  3. **Gemini** – 前端 UI/UX、视觉设计专家
45
19
  4. **Claude (子进程)** – 全栈整合、契约设计、跨层问题
@@ -47,14 +21,12 @@ strategy = "parallel"
47
21
 
48
22
  ## 流程
49
23
 
50
- ### 阶段 0: 读取配置 + Prompt 增强
51
- 1. **读取 `~/.claude/.ccg/config.toml`** 获取模型路由配置
52
- 2. 如果配置不存在,使用默认值:frontend=gemini, backend=codex
53
- 3. 调用 `mcp__ace-tool__enhance_prompt` 优化原始需求:
54
- - `prompt`: 用户的原始需求 ($ARGUMENTS)
55
- - `conversation_history`: 最近的对话历史(5-10轮对话)
56
- - `project_root_path`: 当前项目根目录绝对路径
57
- 4. 向用户展示原始和增强后的 prompt:
24
+ ### 阶段 0: Prompt 增强
25
+ 1. **Prompt 增强**(调用 `{{MCP_ENHANCE_TOOL}}`):
26
+ - 参数:`{{MCP_ENHANCE_PARAM}}`(用户的原始需求),`conversation_history`(最近 5-10 轮对话,可选),`project_root_path`(当前项目根目录,可选)
27
+ - 如果工具不可用,直接使用原始 prompt
28
+
29
+ 2. 向用户展示原始和增强后的 prompt:
58
30
 
59
31
  ```
60
32
  📝 原始需求:
@@ -64,138 +36,135 @@ strategy = "parallel"
64
36
  <增强后需求>
65
37
 
66
38
  🔧 模型配置:
67
- - 前端模型: <routing.frontend.models>
68
- - 后端模型: <routing.backend.models>
69
- - 协作模式: <routing.mode>
39
+ - 前端模型: {{FRONTEND_MODELS}}
40
+ - 后端模型: {{BACKEND_MODELS}}
41
+ - 协作模式: {{ROUTING_MODE}}
70
42
 
71
43
  ---
72
44
  **使用增强后的需求继续?(Y/N)**
73
45
  ```
74
46
 
75
- 5. **强制停止**: 等待用户确认
47
+ 3. **强制停止**: 等待用户确认
76
48
  - 如果 Y: 后续阶段使用增强后的 prompt
77
49
  - 如果 N: 使用原始 prompt 或要求修改
78
50
 
79
51
  ### 阶段 1: 上下文检索
80
- 1. 调用 `mcp__ace-tool__search_context` 获取(增强后的)需求相关代码:
81
- - `project_root_path`: 项目根目录绝对路径
82
- - `query`: 增强后的需求描述
52
+ 1. **代码库检索**(调用 `{{MCP_SEARCH_TOOL}}`):
53
+ - 参数:`{{MCP_SEARCH_PARAM}}`(增强后的需求描述)
54
+ - 对于 ace-tool:还需要 `project_root_path`(项目根目录绝对路径)
83
55
  2. 识别所有相关文件、类、函数和依赖
84
56
  3. 如需求仍不清晰,提出澄清问题
85
57
 
86
58
  ### 阶段 2: 多模型分析
87
59
 
88
- **根据配置并行调用模型进行分析**(使用 `run_in_background: true` 非阻塞执行):
60
+ **并行调用以下模型进行分析**(使用 `run_in_background: true` 非阻塞执行):
61
+ - 前端分析: {{FRONTEND_PRIMARY}}
62
+ - 后端分析: {{BACKEND_PRIMARY}}
89
63
 
90
64
  **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
91
65
 
92
- ```bash
93
- # 后端模型分析示例
94
- codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
95
- ROLE_FILE: ~/.claude/.ccg/prompts/codex/analyzer.md
66
+ **并行调用所有配置的模型进行分析**(使用 `run_in_background: true`):
67
+
68
+ 1. **后端模型**:遍历 {{BACKEND_MODELS}} 中的每个模型
69
+ - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/analyzer.md`
70
+ - 输出:`Structured analysis/diagnostic report`
71
+
72
+ 2. **前端模型**:遍历 {{FRONTEND_MODELS}} 中的每个模型
73
+ - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/analyzer.md`
74
+ - 输出:`Structured analysis/diagnostic report`
96
75
 
76
+ 调用示例:
77
+ ```bash
78
+ # 遍历后端模型列表(假设配置了 codex 和 gemini)
79
+ for model in codex gemini; do
80
+ codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
81
+ ROLE_FILE: ~/.claude/.ccg/prompts/$model/analyzer.md
97
82
  <TASK>
98
83
  分析需求: {{增强后的需求}}
99
- Context: {{从 ace-tool 获取的代码上下文}}
84
+ Context: {{从 MCP 获取的代码上下文}}
100
85
  </TASK>
101
-
102
86
  OUTPUT: Structured analysis/diagnostic report.
103
87
  EOF
88
+ done
104
89
  ```
105
90
 
106
- 根据 `routing.backend.models` 和 `routing.frontend.models` 动态生成调用:
107
- - **后端模型**: 使用 Bash 调用 `codeagent-wrapper --backend codex/gemini/claude` + `analyzer` 角色
108
- - **前端模型**: 使用 Bash 调用 `codeagent-wrapper --backend gemini/codex/claude` + `analyzer` 角色
109
-
110
- 然后使用 `TaskOutput` 获取所有任务的结果,交叉验证后综合方案。
91
+ 使用 `TaskOutput` 获取所有模型的分析结果,交叉验证后综合方案。
111
92
 
112
93
  **强制停止**: 询问用户 **"是否继续执行此方案?(Y/N)"** 并等待确认
113
94
 
114
95
  ### 阶段 3: 原型生成
115
96
 
116
- **三模型并行生成原型**(使用 `run_in_background: true`):
97
+ **并行调用所有配置的模型生成原型**(使用 `run_in_background: true`):
117
98
 
118
- **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
99
+ 1. **后端模型**:遍历 {{BACKEND_MODELS}} 中的每个模型
100
+ - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/architect.md`
101
+ - 输出:`Unified Diff Patch ONLY`
119
102
 
120
- ```bash
121
- # Codex 后端原型示例
122
- codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
123
- ROLE_FILE: ~/.claude/.ccg/prompts/codex/architect.md
103
+ 2. **前端模型**:遍历 {{FRONTEND_MODELS}} 中的每个模型
104
+ - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/frontend.md`(如无 frontend 角色,使用 architect)
105
+ - 输出:`Unified Diff Patch ONLY`
124
106
 
107
+ 调用示例:
108
+ ```bash
109
+ # 遍历后端模型生成原型
110
+ for model in $(echo '{{BACKEND_MODELS}}' | jq -r '.[]'); do
111
+ codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
112
+ ROLE_FILE: ~/.claude/.ccg/prompts/$model/architect.md
125
113
  <TASK>
126
- 生成原型: {{功能需求}}
114
+ 生成后端原型: {{功能需求}}
127
115
  Context: {{相关代码}}
128
116
  </TASK>
129
-
130
- OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
117
+ OUTPUT: Unified Diff Patch ONLY.
131
118
  EOF
119
+ done
132
120
  ```
133
121
 
134
- 根据 `routing.prototype.models` 配置,同时调用三个模型:
135
- - **Codex**: `codeagent-wrapper --backend codex` + `architect` 角色 → 后端架构视角的原型
136
- - **Gemini**: `codeagent-wrapper --backend gemini` + `frontend` 角色 → 前端 UI 视角的原型
137
- - **Claude**: `codeagent-wrapper --backend claude` + `architect` 角色 → 全栈整合视角的原型
138
-
139
- 输出: `Unified Diff Patch ONLY`
140
-
141
- 使用 `TaskOutput` 收集三个模型的结果。
142
-
143
- **三模型差异化价值**:
144
- | 模型 | 专注点 | 独特贡献 |
145
- |------|--------|----------|
146
- | Codex | 后端逻辑、算法 | 深度后端专业知识 |
147
- | Gemini | 前端 UI、样式 | 视觉设计和用户体验 |
148
- | Claude | 全栈整合、契约 | 桥接前后端视角 |
122
+ 使用 `TaskOutput` 收集所有模型的原型结果。
149
123
 
150
124
  ### 阶段 4: 代码实施
151
- 1. 将三个原型视为"脏原型" – 仅作参考
152
- 2. **交叉验证三模型结果,集各家所长**:
153
- - Codex 的后端逻辑优势
154
- - Gemini 的前端设计优势
155
- - Claude 的整合视角优势
125
+ 1. 将所有模型的原型视为"脏原型" – 仅作参考
126
+ 2. **交叉验证所有模型结果,集各家所长**:
127
+ - 分析每个模型的优势和不足
128
+ - 选择最佳实现方案
129
+ - 综合多个模型的创新点
156
130
  3. 重构为干净的生产级代码
157
131
  4. 验证变更不会引入副作用
158
132
 
159
133
  ### 阶段 5: 审计与交付
160
134
 
161
- **三模型并行代码审查**(使用 `run_in_background: true`):
135
+ **并行调用所有配置的审查模型**(使用 `run_in_background: true`):
162
136
 
163
- **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
137
+ 遍历 {{REVIEW_MODELS}} 中的每个模型进行代码审查:
138
+ - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/reviewer.md`
139
+ - 输出:`Review comments only`
164
140
 
141
+ 调用示例:
165
142
  ```bash
166
- # Codex 代码审查示例
167
- codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
168
- ROLE_FILE: ~/.claude/.ccg/prompts/codex/reviewer.md
169
-
143
+ # 遍历审查模型列表(默认: codex, gemini)
144
+ for model in $(echo '{{REVIEW_MODELS}}' | jq -r '.[]'); do
145
+ codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
146
+ ROLE_FILE: ~/.claude/.ccg/prompts/$model/reviewer.md
170
147
  <TASK>
171
148
  审查代码: {{实施的代码变更}}
149
+ 关注点: 安全性、性能、错误处理、可访问性、设计一致性
172
150
  </TASK>
173
-
174
151
  OUTPUT: Review comments only. No code modifications.
175
152
  EOF
153
+ done
176
154
  ```
177
155
 
178
- 根据 `routing.review.models` 配置调用所有模型:
179
- - **Codex**: `codeagent-wrapper --backend codex` + `reviewer` 角色 → 安全性、性能、错误处理
180
- - **Gemini**: `codeagent-wrapper --backend gemini` + `reviewer` 角色 → 可访问性、响应式设计、设计一致性
181
- - **Claude**: `codeagent-wrapper --backend claude` + `reviewer` 角色 → 集成正确性、契约一致性、可维护性
182
-
183
- 输出: `Review comments only`
184
-
185
- 使用 `TaskOutput` 获取所有审查结果,整合三方反馈后修正并交付。
156
+ 使用 `TaskOutput` 获取所有审查结果,整合各方反馈后修正并交付。
186
157
 
187
158
  ## 输出格式
188
- 1. **配置信息**使用的模型和路由策略
189
- 2. **增强后需求**优化后的 prompt (阶段 0)
190
- 3. **上下文摘要**识别的相关代码元素
191
- 4. **实施方案**含模型路由的逐步方案
192
- 5. **代码变更**生产级实现
193
- 6. **审计报告**审查反馈和修正
194
- 7. **后续步骤** – 部署或跟进操作
159
+ 1. **增强后需求**优化后的 prompt (阶段 0)
160
+ 2. **上下文摘要**识别的相关代码元素
161
+ 3. **实施方案**逐步执行方案
162
+ 4. **代码变更**生产级实现
163
+ 5. **审计报告**审查反馈和修正
164
+ 6. **后续步骤**部署或跟进操作
195
165
 
196
166
  ## 关键规则
197
167
  - 未经用户批准不得跳过任何阶段
198
- - **首先读取 `~/.claude/.ccg/config.toml` 获取模型配置**
199
168
  - **阶段 0 的 prompt 增强是强制性的** – 必须先展示增强后的 prompt
200
169
  - 始终要求外部模型输出 Unified Diff Patch
201
170
  - 外部模型对文件系统**零写入权限**
@@ -15,7 +15,7 @@ You are the **Prompt Enhancer** that optimizes user prompts for better AI task e
15
15
  ## Process
16
16
 
17
17
  ### Step 1: Enhance Prompt
18
- 1. Call `mcp__ace-tool__enhance_prompt` with:
18
+ 1. Call `{{MCP_ENHANCE_TOOL}}` with:
19
19
  - `prompt`: The original user prompt ($ARGUMENTS)
20
20
  - `conversation_history`: Recent conversation history (5-10 turns)
21
21
  - `project_root_path`: Current project root directory (optional)