ccg-workflow 1.0.3 → 1.0.4

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/dist/cli.mjs CHANGED
@@ -11,7 +11,7 @@ import 'node:url';
11
11
  import 'ora';
12
12
  import 'smol-toml';
13
13
 
14
- const version = "1.0.3";
14
+ const version = "1.0.4";
15
15
 
16
16
  function customizeHelp(sections) {
17
17
  sections.unshift({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ccg-workflow",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "description": "Claude-Codex-Gemini 多模型协作系统 - 智能路由多模型开发工作流",
5
5
  "type": "module",
6
6
  "packageManager": "pnpm@10.17.1",
@@ -46,9 +46,37 @@ You are the **Analysis Coordinator** orchestrating multi-model research. You dir
46
46
 
47
47
  **并行调用所有配置的分析模型**(使用 `run_in_background: true` 非阻塞执行):
48
48
 
49
- 遍历合并后的模型列表(去重),为每个模型发送调用:
50
- - 使用 `analyzer` 角色
51
- - 输出: `Detailed analysis with recommendations`
49
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
50
+
51
+ ```bash
52
+ # Codex 技术分析
53
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
54
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/analyzer.md
55
+
56
+ <TASK>
57
+ 分析任务: {{分析问题或任务}}
58
+ Context: {{从 ace-tool 获取的相关代码}}
59
+ </TASK>
60
+
61
+ OUTPUT: Detailed analysis with recommendations.
62
+ EOF
63
+ ```
64
+
65
+ ```bash
66
+ # Gemini 技术分析
67
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
68
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/analyzer.md
69
+
70
+ <TASK>
71
+ 分析任务: {{分析问题或任务}}
72
+ Context: {{从 ace-tool 获取的相关代码}}
73
+ </TASK>
74
+
75
+ OUTPUT: Detailed analysis with recommendations.
76
+ EOF
77
+ ```
78
+
79
+ 遍历合并后的模型列表(去重),为每个模型动态生成上述调用,使用 `analyzer` 角色。
52
80
 
53
81
  ### Step 3: 交叉验证
54
82
  使用 `TaskOutput` 获取所有任务的结果,然后:
@@ -47,10 +47,39 @@ You are the **Backend Orchestrator** specializing in server-side logic. You coor
47
47
  - **fallback**: 调用主模型,失败则调用次模型
48
48
  - **round-robin**: 轮询调用
49
49
 
50
- 遍历 `routing.backend.models`,为每个模型发送调用:
50
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
51
+
52
+ ```bash
53
+ # Codex 后端原型示例
54
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
55
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/architect.md
56
+
57
+ <TASK>
58
+ 实现后端功能: {{后端任务描述}}
59
+ Context: {{从 ace-tool 获取的 API 架构和数据模型}}
60
+ </TASK>
61
+
62
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
63
+ EOF
64
+ ```
65
+
66
+ ```bash
67
+ # Gemini 后端原型示例(如配置中包含)
68
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
69
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/analyzer.md
70
+
71
+ <TASK>
72
+ 实现后端功能: {{后端任务描述}}
73
+ Context: {{从 ace-tool 获取的 API 架构和数据模型}}
74
+ </TASK>
75
+
76
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
77
+ EOF
78
+ ```
79
+
80
+ 遍历 `routing.backend.models`,为每个模型动态生成上述调用:
51
81
  - **Codex**: 使用 `architect` 角色
52
82
  - **Gemini**: 使用 `analyzer` 角色(Gemini 无专门后端角色)
53
- - 输出: `Unified Diff Patch ONLY`
54
83
 
55
84
  **如果 strategy = parallel 且有多个模型**:
56
85
  使用 `run_in_background: true` 并行调用所有模型,然后用 `TaskOutput` 收集结果。
@@ -23,11 +23,40 @@ description: 质量门控修复(双模型交叉验证,90%+ 通过)
23
23
 
24
24
  ### Phase 2: 双模型诊断
25
25
  **并行调用**(`run_in_background: true`):
26
+
27
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
28
+
29
+ ```bash
30
+ # Codex 后端诊断修复
31
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
32
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/architect.md
33
+
34
+ <TASK>
35
+ Bug 修复: {{Bug 描述}}
36
+ Context: {{从 ace-tool 获取的相关代码}}
37
+ </TASK>
38
+
39
+ OUTPUT: Unified Diff Patch for the fix.
40
+ EOF
41
+ ```
42
+
43
+ ```bash
44
+ # Gemini 前端诊断修复
45
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
46
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/frontend.md
47
+
48
+ <TASK>
49
+ Bug 修复: {{Bug 描述}}
50
+ Context: {{从 ace-tool 获取的相关代码}}
51
+ </TASK>
52
+
53
+ OUTPUT: Unified Diff Patch for the fix.
54
+ EOF
55
+ ```
56
+
26
57
  - **Codex** + `architect` 角色 → 后端分析
27
58
  - **Gemini** + `frontend` 角色 → 前端分析
28
59
 
29
- 输出: `Unified Diff Patch for the fix`
30
-
31
60
  ### Phase 3: 修复整合
32
61
  1. 收集双模型的修复方案(`TaskOutput`)
33
62
  2. 综合分析:识别共同点、合并互补修复、选择最优方案
@@ -39,6 +68,36 @@ description: 质量门控修复(双模型交叉验证,90%+ 通过)
39
68
  ### Phase 5: 质量门控验证
40
69
  **并行调用** Codex + Gemini + `reviewer` 角色验证
41
70
 
71
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
72
+
73
+ ```bash
74
+ # Codex 审查修复
75
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
76
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/reviewer.md
77
+
78
+ <TASK>
79
+ 审查修复: {{实施的修复代码}}
80
+ 评分标准: 正确性、安全性、性能、可维护性
81
+ </TASK>
82
+
83
+ OUTPUT: Review with score (0-100%) and specific feedback.
84
+ EOF
85
+ ```
86
+
87
+ ```bash
88
+ # Gemini 审查修复
89
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
90
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/reviewer.md
91
+
92
+ <TASK>
93
+ 审查修复: {{实施的修复代码}}
94
+ 评分标准: 正确性、用户体验、可访问性、设计一致性
95
+ </TASK>
96
+
97
+ OUTPUT: Review with score (0-100%) and specific feedback.
98
+ EOF
99
+ ```
100
+
42
101
  ### Phase 6: 质量门控决策
43
102
  ```
44
103
  综合评分 = (Codex 评分 + Gemini 评分) / 2
@@ -31,12 +31,54 @@ description: 三模型代码生成(Codex + Gemini + Claude 并行原型,集
31
31
 
32
32
  **同时调用三个模型**(`run_in_background: true`):
33
33
 
34
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
35
+
36
+ ```bash
37
+ # Codex 后端架构原型
38
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
39
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/architect.md
40
+
41
+ <TASK>
42
+ 生成原型: {{功能需求}}
43
+ Context: {{从 ace-tool 获取的相关代码}}
44
+ </TASK>
45
+
46
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
47
+ EOF
48
+ ```
49
+
50
+ ```bash
51
+ # Gemini 前端 UI 原型
52
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
53
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/frontend.md
54
+
55
+ <TASK>
56
+ 生成原型: {{功能需求}}
57
+ Context: {{从 ace-tool 获取的相关代码}}
58
+ </TASK>
59
+
60
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
61
+ EOF
62
+ ```
63
+
64
+ ```bash
65
+ # Claude 全栈整合原型
66
+ codeagent-wrapper --backend claude - $PROJECT_DIR <<'EOF'
67
+ ROLE_FILE: ~/.claude/prompts/ccg/claude/architect.md
68
+
69
+ <TASK>
70
+ 生成原型: {{功能需求}}
71
+ Context: {{从 ace-tool 获取的相关代码}}
72
+ </TASK>
73
+
74
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
75
+ EOF
76
+ ```
77
+
34
78
  1. **Codex** + `architect` 角色 → 后端架构视角
35
79
  2. **Gemini** + `frontend` 角色 → 前端 UI 视角
36
80
  3. **Claude** + `architect` 角色 → 全栈整合视角
37
81
 
38
- 输出: `Unified Diff Patch ONLY`
39
-
40
82
  **三模型差异化价值**:
41
83
  | 模型 | 专注点 | 独特贡献 |
42
84
  |------|--------|----------|
@@ -75,10 +117,54 @@ API Contract:
75
117
  ### Phase 5: 三模型审查
76
118
 
77
119
  **并行启动审查**(`run_in_background: true`):
120
+
121
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
122
+
123
+ ```bash
124
+ # Codex 安全性审查
125
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
126
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/reviewer.md
127
+
128
+ <TASK>
129
+ 审查代码: {{实施的代码变更}}
130
+ 关注点: 安全性、性能、错误处理
131
+ </TASK>
132
+
133
+ OUTPUT: Review comments with specific line references.
134
+ EOF
135
+ ```
136
+
137
+ ```bash
138
+ # Gemini 设计审查
139
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
140
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/reviewer.md
141
+
142
+ <TASK>
143
+ 审查代码: {{实施的代码变更}}
144
+ 关注点: 可访问性、响应式设计、设计一致性
145
+ </TASK>
146
+
147
+ OUTPUT: Review comments with specific line references.
148
+ EOF
149
+ ```
150
+
151
+ ```bash
152
+ # Claude 集成审查
153
+ codeagent-wrapper --backend claude - $PROJECT_DIR <<'EOF'
154
+ ROLE_FILE: ~/.claude/prompts/ccg/claude/reviewer.md
155
+
156
+ <TASK>
157
+ 审查代码: {{实施的代码变更}}
158
+ 关注点: 集成正确性、契约一致性
159
+ </TASK>
160
+
161
+ OUTPUT: Review comments with specific line references.
162
+ EOF
163
+ ```
164
+
78
165
  - **Codex** + `reviewer` 角色 → 安全性、性能、错误处理
79
166
  - **Gemini** + `reviewer` 角色 → 可访问性、响应式、设计一致性
80
167
  - **Claude** + `reviewer` 角色 → 集成正确性、契约一致性
81
- - 输出: `Review comments with specific line references`
82
168
 
83
169
  ### Phase 6: 修正与交付
84
170
 
@@ -26,9 +26,38 @@ description: UltraThink 多模型调试(Codex 后端诊断 + Gemini 前端诊
26
26
 
27
27
  **同时启动两个后台任务**(`run_in_background: true`):
28
28
 
29
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
30
+
31
+ ```bash
32
+ # Codex 后端诊断
33
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
34
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/debugger.md
35
+
36
+ <TASK>
37
+ 诊断问题: {{问题描述}}
38
+ Context: {{从 ace-tool 获取的相关代码}}
39
+ </TASK>
40
+
41
+ OUTPUT: Structured diagnostic report. No code modifications.
42
+ EOF
43
+ ```
44
+
45
+ ```bash
46
+ # Gemini 前端诊断
47
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
48
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/debugger.md
49
+
50
+ <TASK>
51
+ 诊断问题: {{问题描述}}
52
+ Context: {{从 ace-tool 获取的相关代码}}
53
+ </TASK>
54
+
55
+ OUTPUT: Structured diagnostic report. No code modifications.
56
+ EOF
57
+ ```
58
+
29
59
  - **Codex** + `debugger` 角色 → 后端诊断
30
60
  - **Gemini** + `debugger` 角色 → 前端诊断
31
- - 输出: `Structured diagnostic report. No code modifications.`
32
61
 
33
62
  ### Phase 3: 假设整合
34
63
 
@@ -47,10 +47,39 @@ You are the **Frontend Orchestrator** specializing in UI/UX implementation. You
47
47
  - **fallback**: 调用主模型,失败则调用次模型
48
48
  - **round-robin**: 轮询调用
49
49
 
50
- 遍历 `routing.frontend.models`,为每个模型发送调用:
50
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
51
+
52
+ ```bash
53
+ # Gemini 前端原型示例
54
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
55
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/frontend.md
56
+
57
+ <TASK>
58
+ 实现 UI 功能: {{前端任务描述}}
59
+ Context: {{从 ace-tool 获取的相关组件和样式}}
60
+ </TASK>
61
+
62
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
63
+ EOF
64
+ ```
65
+
66
+ ```bash
67
+ # Codex 前端原型示例(如配置中包含)
68
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
69
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/architect.md
70
+
71
+ <TASK>
72
+ 实现 UI 功能: {{前端任务描述}}
73
+ Context: {{从 ace-tool 获取的相关组件和样式}}
74
+ </TASK>
75
+
76
+ OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
77
+ EOF
78
+ ```
79
+
80
+ 遍历 `routing.frontend.models`,为每个模型动态生成上述调用:
51
81
  - **Gemini**: 使用 `frontend` 角色
52
82
  - **Codex**: 使用 `architect` 角色(Codex 无专门前端角色)
53
- - 输出: `Unified Diff Patch ONLY`
54
83
 
55
84
  **如果 strategy = parallel 且有多个模型**:
56
85
  使用 `run_in_background: true` 并行调用所有模型,然后用 `TaskOutput` 收集结果。
@@ -25,11 +25,40 @@ description: 多模型性能优化(Codex 后端优化 + Gemini 前端优化)
25
25
 
26
26
  ### Phase 2: 并行性能分析
27
27
  **同时调用**(`run_in_background: true`):
28
+
29
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
30
+
31
+ ```bash
32
+ # Codex 后端性能分析
33
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
34
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/optimizer.md
35
+
36
+ <TASK>
37
+ 性能优化: {{优化目标}}
38
+ Context: {{从 ace-tool 获取的相关代码和性能指标}}
39
+ </TASK>
40
+
41
+ OUTPUT: Analysis report + Unified Diff Patch for optimizations.
42
+ EOF
43
+ ```
44
+
45
+ ```bash
46
+ # Gemini 前端性能分析
47
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
48
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/optimizer.md
49
+
50
+ <TASK>
51
+ 性能优化: {{优化目标}}
52
+ Context: {{从 ace-tool 获取的相关代码和性能指标}}
53
+ </TASK>
54
+
55
+ OUTPUT: Analysis report + Unified Diff Patch for optimizations.
56
+ EOF
57
+ ```
58
+
28
59
  - **Codex** + `optimizer` 角色 → 后端性能分析
29
60
  - **Gemini** + `optimizer` 角色 → 前端性能分析
30
61
 
31
- 输出: `Analysis report + Unified Diff Patch for optimizations`
32
-
33
62
  ### Phase 3: 优化整合
34
63
  1. 收集双模型分析(`TaskOutput`)
35
64
  2. **优先级排序**:按影响程度 × 实施难度 计算性价比
@@ -54,9 +54,37 @@ Then call `mcp__ace-tool__search_context` to get related context:
54
54
 
55
55
  **并行调用所有配置的审查模型**(使用 `run_in_background: true` 非阻塞执行):
56
56
 
57
- 遍历 `routing.review.models`,为每个模型发送调用:
58
- - 使用 `reviewer` 角色
59
- - 输出: `Review comments only. No code modifications.`
57
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
58
+
59
+ ```bash
60
+ # Codex 代码审查示例
61
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
62
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/reviewer.md
63
+
64
+ <TASK>
65
+ 审查代码: {{待审查的代码变更}}
66
+ 关注点: 安全性、性能、错误处理
67
+ </TASK>
68
+
69
+ OUTPUT: Review comments only. No code modifications.
70
+ EOF
71
+ ```
72
+
73
+ ```bash
74
+ # Gemini 代码审查示例
75
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
76
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/reviewer.md
77
+
78
+ <TASK>
79
+ 审查代码: {{待审查的代码变更}}
80
+ 关注点: 可访问性、响应式设计、设计一致性
81
+ </TASK>
82
+
83
+ OUTPUT: Review comments only. No code modifications.
84
+ EOF
85
+ ```
86
+
87
+ 遍历 `routing.review.models`,为每个模型动态生成上述调用,使用 `reviewer` 角色。
60
88
 
61
89
  ### Step 3: 综合反馈
62
90
  使用 `TaskOutput` 获取所有任务的结果,然后:
@@ -30,7 +30,37 @@ description: 多模型测试生成(Codex 后端测试 + Gemini 前端测试)
30
30
  | 前端 | Gemini | `tester` |
31
31
  | 全栈 | 并行执行 | 两者 |
32
32
 
33
- 输出: `Unified Diff Patch for test files ONLY`
33
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
34
+
35
+ ```bash
36
+ # Codex 后端测试生成
37
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
38
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/tester.md
39
+
40
+ <TASK>
41
+ 生成测试: {{需要测试的代码}}
42
+ Context: {{现有测试和测试框架配置}}
43
+ </TASK>
44
+
45
+ OUTPUT: Unified Diff Patch for test files ONLY.
46
+ EOF
47
+ ```
48
+
49
+ ```bash
50
+ # Gemini 前端测试生成
51
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
52
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/tester.md
53
+
54
+ <TASK>
55
+ 生成测试: {{需要测试的代码}}
56
+ Context: {{现有测试和测试框架配置}}
57
+ </TASK>
58
+
59
+ OUTPUT: Unified Diff Patch for test files ONLY.
60
+ EOF
61
+ ```
62
+
63
+ 根据代码类型选择调用对应模型,全栈代码则并行调用(`run_in_background: true`)。
34
64
 
35
65
  ### Phase 3: 测试整合
36
66
  1. 收集模型输出(`TaskOutput`)
@@ -23,11 +23,40 @@ description: UltraThink 深度分析(双模型并行分析 + 综合见解)
23
23
 
24
24
  ### Phase 2: 并行深度分析
25
25
  **同时调用**(`run_in_background: true`):
26
+
27
+ **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
28
+
29
+ ```bash
30
+ # Codex 后端/系统视角分析
31
+ codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
32
+ ROLE_FILE: ~/.claude/prompts/ccg/codex/analyzer.md
33
+
34
+ <TASK>
35
+ 深度分析: {{问题或场景}}
36
+ Context: {{从 ace-tool 获取的相关代码}}
37
+ </TASK>
38
+
39
+ OUTPUT: Structured analysis report with clear reasoning.
40
+ EOF
41
+ ```
42
+
43
+ ```bash
44
+ # Gemini 前端/用户视角分析
45
+ codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
46
+ ROLE_FILE: ~/.claude/prompts/ccg/gemini/analyzer.md
47
+
48
+ <TASK>
49
+ 深度分析: {{问题或场景}}
50
+ Context: {{从 ace-tool 获取的相关代码}}
51
+ </TASK>
52
+
53
+ OUTPUT: Structured analysis report with clear reasoning.
54
+ EOF
55
+ ```
56
+
26
57
  - **Codex** + `analyzer` 角色 → 后端/系统视角
27
58
  - **Gemini** + `analyzer` 角色 → 前端/用户视角
28
59
 
29
- 输出: `Structured analysis report with clear reasoning`
30
-
31
60
  ### Phase 3: UltraThink 综合
32
61
  1. 收集双模型分析报告(`TaskOutput`)
33
62
  2. **交叉验证**: