ccg-workflow 1.6.0 → 1.7.1
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 +175 -408
- package/bin/codeagent-wrapper-linux-arm64 +0 -0
- package/bin/codeagent-wrapper-windows-arm64.exe +0 -0
- package/dist/cli.mjs +1 -1
- package/dist/index.d.mts +3 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.mjs +1 -1
- package/dist/shared/{ccg-workflow.CjatSnB0.mjs → ccg-workflow._fNXxrRQ.mjs} +194 -286
- package/package.json +1 -1
- package/templates/commands/analyze.md +130 -57
- package/templates/commands/backend.md +92 -152
- package/templates/commands/clean-branches.md +81 -66
- package/templates/commands/commit.md +81 -117
- package/templates/commands/debug.md +117 -90
- package/templates/commands/feat.md +68 -282
- package/templates/commands/frontend.md +92 -154
- package/templates/commands/init.md +100 -36
- package/templates/commands/optimize.md +137 -70
- package/templates/commands/review.md +123 -63
- package/templates/commands/rollback.md +86 -60
- package/templates/commands/test.md +143 -54
- package/templates/commands/workflow.md +244 -0
- package/templates/commands/worktree.md +78 -226
- package/templates/commands/bugfix.md +0 -114
- package/templates/commands/code.md +0 -255
- package/templates/commands/dev.md +0 -179
- package/templates/commands/think.md +0 -102
package/README.md
CHANGED
|
@@ -7,10 +7,6 @@
|
|
|
7
7
|
[](https://www.npmjs.com/package/ccg-workflow)
|
|
8
8
|
[](https://opensource.org/licenses/MIT)
|
|
9
9
|
[](https://claude.ai/code)
|
|
10
|
-
[](https://github.com/openai/openai-python)
|
|
11
|
-
[](https://ai.google.dev/)
|
|
12
|
-
|
|
13
|
-
> 🎉 **Windows MCP 自动修复** - 彻底解决 Windows 用户 MCP 安装问题!
|
|
14
10
|
|
|
15
11
|
[快速开始](#-快速开始) • [命令参考](#-命令参考) • [常见问题](#-常见问题) • [更新日志](CHANGELOG.md)
|
|
16
12
|
|
|
@@ -18,116 +14,23 @@
|
|
|
18
14
|
|
|
19
15
|
---
|
|
20
16
|
|
|
21
|
-
##
|
|
22
|
-
|
|
23
|
-
### ✨ 多模型并行增强
|
|
24
|
-
|
|
25
|
-
**backend/frontend 命令现已支持多模型并行分析和审计**
|
|
26
|
-
|
|
27
|
-
- ✅ `/ccg:backend` - 后端专家也能享受多模型交叉验证(Codex + Gemini 并行)
|
|
28
|
-
- ✅ `/ccg:frontend` - 前端专家也能享受多模型交叉验证(Gemini + Claude 并行)
|
|
29
|
-
- ✅ **5阶段工作流** - 上下文检索 → 多模型分析 → 原型生成 → 重构实施 → 多模型审计
|
|
30
|
-
|
|
31
|
-
### 配置简化
|
|
32
|
-
|
|
33
|
-
**MCP 安装流程优化**
|
|
34
|
-
|
|
35
|
-
- ✅ **只保留 ace-tool** - 移除 auggie 安装选项,简化选择流程
|
|
36
|
-
- ✅ **中转服务支持** - 添加 linux.do 社区中转服务(无需注册)
|
|
37
|
-
- ✅ **Workflow 预设** - 新增最小化/标准/完整三种安装模式
|
|
38
|
-
- ✅ **Token 跳过** - 支持跳过 Token 配置,稍后再设置
|
|
39
|
-
|
|
40
|
-
### 代码清理
|
|
41
|
-
|
|
42
|
-
**移除冗余配置**
|
|
43
|
-
|
|
44
|
-
- ✅ 删除所有命令模板中的 `_config.md` 死链接引用
|
|
45
|
-
- ✅ 删除 `shared-config.md` 及相关逻辑(减少 128 行代码)
|
|
46
|
-
- ✅ 构建大小优化(94.2 kB → 92.6 kB)
|
|
47
|
-
|
|
48
|
-
---
|
|
49
|
-
|
|
50
|
-
## 📖 目录
|
|
17
|
+
## 💡 这是什么?
|
|
51
18
|
|
|
52
|
-
|
|
53
|
-
- [架构说明](#-架构说明)
|
|
54
|
-
- [核心特性](#-核心特性)
|
|
55
|
-
- [快速开始](#-快速开始)
|
|
56
|
-
- [命令参考](#-命令参考)
|
|
57
|
-
- [专家角色系统](#-专家角色系统)
|
|
58
|
-
- [配置文件](#-配置文件)
|
|
59
|
-
- [常见问题](#-常见问题)
|
|
60
|
-
- [致谢](#-致谢)
|
|
19
|
+
**CCG** = **Claude Code** (编排) + **Codex CLI** (后端) + **Gemini CLI** (前端)
|
|
61
20
|
|
|
62
|
-
|
|
21
|
+
一个让 Claude Code 专注于编排决策,把具体代码生成交给专业模型的多模型协作系统:
|
|
63
22
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
CCG = **Claude Code** (主导编排) + **Codex CLI** (后端原型) + **Gemini CLI** (前端原型)
|
|
67
|
-
|
|
68
|
-
### 设计哲学
|
|
69
|
-
|
|
70
|
-
让 Claude Code 专注于编排决策和代码实施,把具体的代码生成交给专业模型:
|
|
71
|
-
- **前端任务** → Gemini(视觉设计、组件原型)
|
|
72
|
-
- **后端任务** → Codex(逻辑运算、算法调试)
|
|
23
|
+
- **前端任务** → Gemini(擅长 UI/CSS/组件)
|
|
24
|
+
- **后端任务** → Codex(擅长逻辑/算法/调试)
|
|
73
25
|
- **全栈整合** → Claude(工作流控制、代码主权)
|
|
74
26
|
|
|
75
27
|
### 核心优势
|
|
76
28
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
| **跨平台支持** | macOS、Linux、**Windows 自动修复** ✨ |
|
|
83
|
-
| **Token 优化** | ROLE_FILE 动态注入,专家提示词零 token 消耗 |
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
87
|
-
## 🏗️ 架构说明
|
|
88
|
-
|
|
89
|
-
```
|
|
90
|
-
┌─────────────────────────────────────────────────┐
|
|
91
|
-
│ Claude Code CLI (主导编排) │
|
|
92
|
-
│ 决策、编排、代码实施、质量把控 │
|
|
93
|
-
└──────────────┬──────────────────────────────────┘
|
|
94
|
-
│
|
|
95
|
-
┌───────┴────────┐
|
|
96
|
-
│ │
|
|
97
|
-
↓ ↓
|
|
98
|
-
┌─────────────┐ ┌─────────────┐
|
|
99
|
-
│ Codex CLI │ │ Gemini CLI │
|
|
100
|
-
│ 后端原型 │ │ 前端原型 │
|
|
101
|
-
│ 逻辑算法 │ │ UI 组件 │
|
|
102
|
-
└─────────────┘ └─────────────┘
|
|
103
|
-
│ │
|
|
104
|
-
└────────┬───────┘
|
|
105
|
-
↓
|
|
106
|
-
Unified Diff Patch
|
|
107
|
-
(只读,不能直接修改文件)
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
### 安全机制
|
|
111
|
-
|
|
112
|
-
- **零写入权限**:Codex/Gemini 对文件系统无写入权限
|
|
113
|
-
- **Unified Diff**:所有外部模型输出必须为 Patch 格式
|
|
114
|
-
- **脏原型处理**:外部模型输出视为"脏原型",需经 Claude 重构
|
|
115
|
-
|
|
116
|
-
---
|
|
117
|
-
|
|
118
|
-
## ✨ 核心特性
|
|
119
|
-
|
|
120
|
-
| 特性 | 描述 |
|
|
121
|
-
|------|------|
|
|
122
|
-
| **智能路由** | 前端任务→Gemini,后端任务→Codex,全栈整合→Claude |
|
|
123
|
-
| **多模型并行** | Codex ∥ Gemini 同时调用,交叉验证结果(支持 dev/backend/frontend) |
|
|
124
|
-
| **MCP 自动配置** | **Windows 自动修复** + ace-tool 一键安装(支持官方/中转服务)|
|
|
125
|
-
| **6阶段工作流** | Prompt增强 → 代码检索 → 分析 → 原型 → 实施 → 审计(/ccg:dev)|
|
|
126
|
-
| **12个专家提示词** | Codex 6个 + Gemini 6个,ROLE_FILE 零 token 动态注入 |
|
|
127
|
-
| **17个斜杠命令** | 开发工作流 14个 + Git 工具 3个 |
|
|
128
|
-
| **Workflow 预设** | 最小化(3命令)/ 标准(12命令)/ 完整(17命令)|
|
|
129
|
-
| **Git 自动化** | 智能 commit、交互式回滚、分支清理、Worktree 管理 |
|
|
130
|
-
| **npx 一键安装** | 无需全局安装,交互式配置菜单 |
|
|
29
|
+
- ✅ **智能路由** - 前端 → Gemini,后端 → Codex,自动选择
|
|
30
|
+
- ✅ **多模型并行** - Codex ∥ Gemini 同时分析,交叉验证减少错误
|
|
31
|
+
- ✅ **零写入权限** - 外部模型只返回 Patch,Claude 保持代码主权
|
|
32
|
+
- ✅ **Token 优化** - ROLE_FILE 动态注入,专家提示词零消耗
|
|
33
|
+
- ✅ **一键安装** - npx 运行,自动安装全部 14 个命令
|
|
131
34
|
|
|
132
35
|
---
|
|
133
36
|
|
|
@@ -135,276 +38,224 @@ CCG = **Claude Code** (主导编排) + **Codex CLI** (后端原型) + **Gemini C
|
|
|
135
38
|
|
|
136
39
|
### 前置要求
|
|
137
40
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
41
|
+
**必需**:
|
|
42
|
+
- [Claude Code CLI](https://claude.ai/code)
|
|
43
|
+
- Node.js 18+
|
|
141
44
|
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
45
|
+
**可选**(根据需求安装):
|
|
46
|
+
- Codex CLI - 用于后端任务
|
|
47
|
+
- Gemini CLI - 用于前端任务
|
|
48
|
+
|
|
49
|
+
> 💡 **只装 Claude Code 也能用!** 系统会自动降级为纯 Claude 工作流
|
|
145
50
|
|
|
146
51
|
### 一键安装
|
|
147
52
|
|
|
148
53
|
```bash
|
|
149
|
-
# 交互式安装
|
|
150
54
|
npx ccg-workflow
|
|
151
|
-
|
|
152
|
-
# 安装流程:
|
|
153
|
-
# 1. 选择 "初始化工作流"
|
|
154
|
-
# 2. 选择语言(中文 / English)
|
|
155
|
-
# 3. 选择命令安装模式:
|
|
156
|
-
# - 最小化(3命令):dev, code, commit - 推荐新手
|
|
157
|
-
# - 标准(12命令):常用开发 + Git 工具 - 推荐
|
|
158
|
-
# - 完整(17命令):全部功能
|
|
159
|
-
# - 自定义:手动勾选
|
|
160
|
-
# 4. 选择 MCP 工具:
|
|
161
|
-
# - 安装 ace-tool(推荐)- 支持官方服务和中转服务
|
|
162
|
-
# - 跳过 MCP 安装 - 稍后配置
|
|
163
|
-
# 5. 等待安装完成(约 1-2 分钟)
|
|
164
|
-
# 6. 重启终端
|
|
165
55
|
```
|
|
166
56
|
|
|
167
|
-
|
|
57
|
+
**安装流程**:
|
|
58
|
+
1. 选择是否配置 ace-tool MCP(可跳过)
|
|
59
|
+
2. 确认安装
|
|
60
|
+
3. 自动安装全部 14 个命令
|
|
61
|
+
4. 配置 PATH(如需要)
|
|
168
62
|
|
|
169
|
-
|
|
170
|
-
|------|--------|---------|---------|
|
|
171
|
-
| **最小化** | 3 | dev, code, commit | 新手入门,快速体验 |
|
|
172
|
-
| **标准** | 12 | dev, code, frontend, backend, review, analyze, debug, test, commit, rollback, clean-branches, feat | 日常开发,覆盖 90% 需求 |
|
|
173
|
-
| **完整** | 17 | 全部命令 | 高级用户,全功能使用 |
|
|
174
|
-
| **自定义** | 按需 | 手动勾选 | 定制化需求 |
|
|
63
|
+
就这么简单!无需选择语言、模型、命令预设。
|
|
175
64
|
|
|
176
|
-
###
|
|
65
|
+
### 固定配置
|
|
177
66
|
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
# 诊断 MCP 配置(v1.4.2 新增)
|
|
186
|
-
npx ccg diagnose-mcp
|
|
187
|
-
```
|
|
67
|
+
| 项目 | 配置 |
|
|
68
|
+
|------|------|
|
|
69
|
+
| 前端模型 | **Gemini** |
|
|
70
|
+
| 后端模型 | **Codex** |
|
|
71
|
+
| 协作模式 | **smart** |
|
|
72
|
+
| 命令数量 | **14 个**(全部安装) |
|
|
188
73
|
|
|
189
74
|
### 第一个命令
|
|
190
75
|
|
|
191
76
|
```bash
|
|
192
77
|
# 在 Claude Code 中执行
|
|
193
|
-
/ccg:
|
|
194
|
-
|
|
195
|
-
#
|
|
196
|
-
#
|
|
197
|
-
#
|
|
198
|
-
#
|
|
199
|
-
#
|
|
200
|
-
#
|
|
201
|
-
#
|
|
78
|
+
/ccg:workflow 实现用户登录功能
|
|
79
|
+
|
|
80
|
+
# 自动执行 6 阶段工作流:
|
|
81
|
+
# 阶段 1: 研究 - Prompt 增强 + 上下文检索
|
|
82
|
+
# 阶段 2: 构思 - 多模型分析 (Codex ∥ Gemini)
|
|
83
|
+
# 阶段 3: 计划 - 多模型规划 + 用户确认
|
|
84
|
+
# 阶段 4: 执行 - 代码实施
|
|
85
|
+
# 阶段 5: 优化 - 多模型审查
|
|
86
|
+
# 阶段 6: 评审 - 质量检查
|
|
202
87
|
```
|
|
203
88
|
|
|
204
89
|
---
|
|
205
90
|
|
|
206
91
|
## 📚 命令参考
|
|
207
92
|
|
|
208
|
-
###
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
|
222
|
-
|
|
223
|
-
| `/ccg:
|
|
224
|
-
| `/ccg:
|
|
225
|
-
|
|
226
|
-
|
|
93
|
+
### 核心命令(记住这 3 个就够了)
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
/ccg:workflow # 完整任务(6 阶段工作流)
|
|
97
|
+
/ccg:feat # 新功能开发(自动规划)
|
|
98
|
+
/ccg:frontend # 纯前端任务(Gemini 主导,更快)
|
|
99
|
+
/ccg:backend # 纯后端任务(Codex 主导,更快)
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### 完整命令列表(14 个)
|
|
103
|
+
|
|
104
|
+
#### 开发工作流
|
|
105
|
+
|
|
106
|
+
| 命令 | 用途 | 模型 |
|
|
107
|
+
|-----|------|------|
|
|
108
|
+
| `/ccg:workflow` | 完整 6 阶段开发工作流 | Codex ∥ Gemini |
|
|
109
|
+
| `/ccg:frontend` | 前端专项(快速模式) | Gemini |
|
|
110
|
+
| `/ccg:backend` | 后端专项(快速模式) | Codex |
|
|
111
|
+
| `/ccg:feat` | 智能功能开发 | 规划 → 实施 |
|
|
112
|
+
| `/ccg:analyze` | 技术分析(仅分析不改代码) | Codex ∥ Gemini |
|
|
113
|
+
| `/ccg:debug` | 问题诊断 + 修复 | Codex ∥ Gemini |
|
|
114
|
+
| `/ccg:optimize` | 性能优化 | Codex ∥ Gemini |
|
|
115
|
+
| `/ccg:test` | 测试生成 | 智能路由 |
|
|
116
|
+
| `/ccg:review` | 代码审查(无参数自动审查 git diff) | Codex ∥ Gemini |
|
|
117
|
+
|
|
118
|
+
#### Git 工具
|
|
227
119
|
|
|
228
120
|
| 命令 | 用途 |
|
|
229
121
|
|-----|------|
|
|
230
|
-
| `/ccg:commit` |
|
|
231
|
-
| `/ccg:rollback` |
|
|
232
|
-
| `/ccg:clean-branches` |
|
|
233
|
-
| `/ccg:worktree` | Worktree
|
|
122
|
+
| `/ccg:commit` | 智能提交(自动生成 conventional commit)|
|
|
123
|
+
| `/ccg:rollback` | 交互式回滚 |
|
|
124
|
+
| `/ccg:clean-branches` | 清理已合并分支 |
|
|
125
|
+
| `/ccg:worktree` | Worktree 管理 |
|
|
234
126
|
|
|
235
|
-
|
|
127
|
+
#### 项目工具
|
|
236
128
|
|
|
237
129
|
| 命令 | 用途 |
|
|
238
130
|
|-----|------|
|
|
239
|
-
|
|
|
240
|
-
| `npx ccg fix-mcp` | 修复 Windows MCP 配置(Windows 用户)|
|
|
131
|
+
| `/ccg:init` | 初始化项目 CLAUDE.md |
|
|
241
132
|
|
|
242
133
|
---
|
|
243
134
|
|
|
244
135
|
## 🎭 专家角色系统
|
|
245
136
|
|
|
246
|
-
###
|
|
247
|
-
|
|
248
|
-
12个专家提示词(Codex 6个 + Gemini 6个),采用 **零 token 消耗** 的 ROLE_FILE 动态注入机制:
|
|
137
|
+
### ROLE_FILE 动态注入机制
|
|
249
138
|
|
|
250
|
-
|
|
251
|
-
- ✅ 不占用主会话 token(通过 `codeagent-wrapper` 子进程读取)
|
|
252
|
-
- ✅ 无需手动配置全局提示词
|
|
253
|
-
- ✅ 支持用户自定义修改提示词内容
|
|
139
|
+
12 个专家提示词(Codex 6 + Gemini 6),**零 token 消耗**:
|
|
254
140
|
|
|
255
|
-
|
|
141
|
+
**Codex 专家**(后端):
|
|
142
|
+
- `architect.md` - 后端架构师
|
|
143
|
+
- `analyzer.md` - 技术分析师
|
|
144
|
+
- `debugger.md` - 调试专家
|
|
145
|
+
- `optimizer.md` - 性能优化师
|
|
146
|
+
- `reviewer.md` - 代码审查员
|
|
147
|
+
- `tester.md` - 测试工程师
|
|
256
148
|
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
| `/ccg:review`, `/ccg:bugfix` | reviewer.md | reviewer.md |
|
|
265
|
-
| `/ccg:optimize` | optimizer.md | optimizer.md |
|
|
149
|
+
**Gemini 专家**(前端):
|
|
150
|
+
- `frontend.md` - 前端架构师
|
|
151
|
+
- `analyzer.md` - UI/UX 分析师
|
|
152
|
+
- `debugger.md` - 前端调试专家
|
|
153
|
+
- `optimizer.md` - 前端性能优化
|
|
154
|
+
- `reviewer.md` - 代码审查员
|
|
155
|
+
- `tester.md` - 前端测试工程师
|
|
266
156
|
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
│ ├── architect.md # 后端架构师(API、数据库、逻辑)
|
|
273
|
-
│ ├── analyzer.md # 后端分析师(性能、安全、架构)
|
|
274
|
-
│ ├── debugger.md # 后端调试专家(逻辑错误、算法问题)
|
|
275
|
-
│ ├── optimizer.md # 后端优化专家(算法、查询、缓存)
|
|
276
|
-
│ ├── reviewer.md # 后端审查专家(代码质量、安全审计)
|
|
277
|
-
│ └── tester.md # 后端测试专家(单元测试、集成测试)
|
|
278
|
-
└── gemini/ # Gemini CLI 前端专家(6个)
|
|
279
|
-
├── frontend.md # 前端架构师(组件、UI、交互)
|
|
280
|
-
├── analyzer.md # 前端分析师(UX、可访问性、性能)
|
|
281
|
-
├── debugger.md # 前端调试专家(UI 问题、渲染错误)
|
|
282
|
-
├── optimizer.md # 前端优化专家(渲染、懒加载、打包)
|
|
283
|
-
├── reviewer.md # 前端审查专家(代码规范、设计一致性)
|
|
284
|
-
└── tester.md # 前端测试专家(E2E、组件测试)
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
**注意**:Claude Code 本身作为主控编排,不需要额外的提示词文件。
|
|
157
|
+
**工作原理**:
|
|
158
|
+
1. 每个命令自动注入对应角色提示词
|
|
159
|
+
2. 通过 `codeagent-wrapper` 子进程读取
|
|
160
|
+
3. 不占用主会话 token
|
|
161
|
+
4. 用户可自定义修改(路径:`~/.claude/.ccg/prompts/`)
|
|
288
162
|
|
|
289
163
|
---
|
|
290
164
|
|
|
291
|
-
##
|
|
292
|
-
|
|
293
|
-
配置文件位于 `~/.claude/.ccg/config.toml`:
|
|
294
|
-
|
|
295
|
-
```toml
|
|
296
|
-
[general]
|
|
297
|
-
version = "1.6.0"
|
|
298
|
-
language = "zh-CN"
|
|
299
|
-
createdAt = "2026-01-07T12:00:00.000Z"
|
|
300
|
-
|
|
301
|
-
[mcp]
|
|
302
|
-
provider = "ace-tool" # ace-tool | skip (v1.6.0 移除 auggie 安装选项)
|
|
303
|
-
|
|
304
|
-
[routing]
|
|
305
|
-
mode = "smart" # smart | parallel | sequential
|
|
306
|
-
|
|
307
|
-
[routing.frontend]
|
|
308
|
-
models = ["gemini"]
|
|
309
|
-
primary = "gemini"
|
|
310
|
-
strategy = "fallback"
|
|
165
|
+
## 🗂️ 安装目录结构
|
|
311
166
|
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
167
|
+
```
|
|
168
|
+
~/.claude/
|
|
169
|
+
├── commands/ccg/ # 14 个斜杠命令
|
|
170
|
+
├── agents/ccg/ # 4 个子智能体
|
|
171
|
+
├── skills/ # 1 个 skill
|
|
172
|
+
├── bin/
|
|
173
|
+
│ └── codeagent-wrapper # Go 多后端调用工具
|
|
174
|
+
└── .ccg/
|
|
175
|
+
├── config.toml # 主配置
|
|
176
|
+
└── prompts/ # 12 个专家提示词
|
|
177
|
+
├── codex/
|
|
178
|
+
└── gemini/
|
|
316
179
|
```
|
|
317
180
|
|
|
318
181
|
---
|
|
319
182
|
|
|
320
|
-
##
|
|
183
|
+
## 🏗️ 架构说明
|
|
321
184
|
|
|
322
185
|
```
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
│
|
|
326
|
-
|
|
327
|
-
│
|
|
328
|
-
|
|
329
|
-
│
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
│
|
|
333
|
-
|
|
334
|
-
│
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
186
|
+
┌─────────────────────────────────────────────────┐
|
|
187
|
+
│ Claude Code CLI (主导编排) │
|
|
188
|
+
│ 决策、编排、代码实施、质量把控 │
|
|
189
|
+
└──────────────┬──────────────────────────────────┘
|
|
190
|
+
│
|
|
191
|
+
┌───────┴────────┐
|
|
192
|
+
│ │
|
|
193
|
+
↓ ↓
|
|
194
|
+
┌─────────────┐ ┌─────────────┐
|
|
195
|
+
│ Codex CLI │ │ Gemini CLI │
|
|
196
|
+
│ 后端专家 │ │ 前端专家 │
|
|
197
|
+
│ 逻辑算法 │ │ UI 组件 │
|
|
198
|
+
└─────────────┘ └─────────────┘
|
|
199
|
+
│ │
|
|
200
|
+
└────────┬───────┘
|
|
201
|
+
↓
|
|
202
|
+
Unified Diff Patch
|
|
203
|
+
(零写入权限,仅返回补丁)
|
|
340
204
|
```
|
|
341
205
|
|
|
206
|
+
**信任规则**:
|
|
207
|
+
- 后端问题 → **以 Codex 意见为准**
|
|
208
|
+
- 前端问题 → **以 Gemini 意见为准**
|
|
209
|
+
- 冲突时 → Claude 综合判断,向用户说明分歧
|
|
210
|
+
|
|
342
211
|
---
|
|
343
212
|
|
|
344
213
|
## ❓ 常见问题
|
|
345
214
|
|
|
346
215
|
<details>
|
|
347
|
-
<summary><strong>Q1:
|
|
216
|
+
<summary><strong>Q1: 只装了 Claude Code,没装 Codex/Gemini 能用吗?</strong></summary>
|
|
348
217
|
|
|
349
|
-
|
|
350
|
-
- ✅ `/ccg:backend` 和 `/ccg:frontend` 现支持多模型并行工作流
|
|
351
|
-
- ✅ 后端专家/前端专家也能享受交叉验证能力
|
|
352
|
-
- ✅ 5阶段完整工作流:检索 → 分析 → 原型 → 实施 → 审计
|
|
218
|
+
✅ **可以!** 系统会自动降级为纯 Claude 工作流。
|
|
353
219
|
|
|
354
|
-
|
|
355
|
-
-
|
|
356
|
-
-
|
|
357
|
-
-
|
|
358
|
-
- ✅ Token 配置支持跳过,稍后再设置
|
|
220
|
+
但会失去:
|
|
221
|
+
- 智能路由(前端/后端自动分配)
|
|
222
|
+
- 多模型并行(交叉验证)
|
|
223
|
+
- 专家角色系统(ROLE_FILE 注入)
|
|
359
224
|
|
|
360
|
-
|
|
361
|
-
- ✅ 删除 `_config.md` 死链接引用(11 个文件)
|
|
362
|
-
- ✅ 删除 `shared-config.md` 冗余配置(128 行代码)
|
|
363
|
-
- ✅ 构建大小优化:94.2 kB → 92.6 kB
|
|
364
|
-
|
|
365
|
-
**升级方法**:
|
|
366
|
-
```bash
|
|
367
|
-
npx ccg-workflow@latest
|
|
368
|
-
# 选择 "更新工作流"
|
|
369
|
-
# 自动应用所有改进
|
|
370
|
-
```
|
|
225
|
+
建议至少安装 Codex 或 Gemini 其中一个以获得完整体验。
|
|
371
226
|
|
|
372
227
|
</details>
|
|
373
228
|
|
|
374
229
|
<details>
|
|
375
|
-
<summary><strong>Q2:
|
|
230
|
+
<summary><strong>Q2: MCP 工具如何配置?</strong></summary>
|
|
376
231
|
|
|
377
|
-
|
|
232
|
+
**安装时配置**(推荐):
|
|
378
233
|
|
|
379
|
-
新用户:
|
|
380
234
|
```bash
|
|
381
|
-
npx ccg-workflow
|
|
382
|
-
#
|
|
235
|
+
npx ccg-workflow
|
|
236
|
+
# 选择 "安装 ace-tool"
|
|
383
237
|
```
|
|
384
238
|
|
|
385
|
-
|
|
386
|
-
```bash
|
|
387
|
-
# 诊断问题
|
|
388
|
-
npx ccg diagnose-mcp
|
|
239
|
+
**ace-tool 两种方式**:
|
|
389
240
|
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
241
|
+
1. **官方服务**:
|
|
242
|
+
- 注册地址:https://augmentcode.com/
|
|
243
|
+
- 获取 Token 后填写即可
|
|
393
244
|
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
245
|
+
2. **中转服务**(无需注册)⭐:
|
|
246
|
+
- 免费使用:https://linux.do/t/topic/1291730
|
|
247
|
+
- linux.do 社区提供
|
|
248
|
+
- 需填写 Base URL 和 Token
|
|
398
249
|
|
|
399
|
-
|
|
400
|
-
|
|
250
|
+
**跳过 MCP**:
|
|
251
|
+
|
|
252
|
+
跳过 MCP 后,命令中涉及 ace-tool 的步骤(代码检索、Prompt 增强)会失效,但其他功能正常工作。
|
|
401
253
|
|
|
402
254
|
</details>
|
|
403
255
|
|
|
404
256
|
<details>
|
|
405
257
|
<summary><strong>Q3: 如何更新到最新版本?</strong></summary>
|
|
406
258
|
|
|
407
|
-
一键更新,无需卸载:
|
|
408
259
|
```bash
|
|
409
260
|
npx ccg-workflow@latest
|
|
410
261
|
# 选择 "更新工作流"
|
|
@@ -412,115 +263,33 @@ npx ccg-workflow@latest
|
|
|
412
263
|
|
|
413
264
|
更新会自动:
|
|
414
265
|
- 检测 npm 最新版本
|
|
415
|
-
-
|
|
416
|
-
-
|
|
417
|
-
- 自动迁移旧版本目录结构(v1.3.x → v1.4.x → v1.6.0)
|
|
418
|
-
- **v1.6.0 新增**:应用多模型并行工作流(backend/frontend)
|
|
266
|
+
- 增量更新命令和提示词
|
|
267
|
+
- 保留 MCP 配置
|
|
419
268
|
|
|
420
269
|
</details>
|
|
421
270
|
|
|
422
271
|
<details>
|
|
423
|
-
<summary><strong>Q4:
|
|
272
|
+
<summary><strong>Q4: `/ccg:workflow` 和 `/ccg:frontend`/`/ccg:backend` 有什么区别?</strong></summary>
|
|
424
273
|
|
|
425
|
-
|
|
274
|
+
- **`/ccg:workflow`** - 完整 6 阶段工作流
|
|
275
|
+
- 每阶段都并行调用 Codex + Gemini
|
|
276
|
+
- 适合全栈任务、复杂任务
|
|
426
277
|
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
~/.claude/prompts/ccg/ → ~/.claude/.ccg/prompts/
|
|
431
|
-
~/.claude/commands/ccg/ → 保持不变
|
|
432
|
-
```
|
|
433
|
-
|
|
434
|
-
安装/更新时会自动:
|
|
435
|
-
1. 检测旧版本目录
|
|
436
|
-
2. 迁移所有文件到新位置
|
|
437
|
-
3. 清理旧目录(安全检查后)
|
|
438
|
-
4. 显示迁移报告
|
|
439
|
-
|
|
440
|
-
</details>
|
|
441
|
-
|
|
442
|
-
<details>
|
|
443
|
-
<summary><strong>Q5: MCP 工具如何配置?</strong></summary>
|
|
444
|
-
|
|
445
|
-
**v1.6.0 简化配置流程**:
|
|
446
|
-
|
|
447
|
-
安装时提供两个选项:
|
|
448
|
-
1. **安装 ace-tool** - 一键配置代码检索和 Prompt 增强
|
|
449
|
-
2. **跳过 MCP 安装** - 稍后手动配置任何 MCP 服务
|
|
450
|
-
|
|
451
|
-
**ace-tool 访问方式**:
|
|
452
|
-
|
|
453
|
-
1. **官方服务**(推荐):
|
|
454
|
-
- 注册地址: https://augmentcode.com/
|
|
455
|
-
- 注册后获取 Token
|
|
456
|
-
- 安装时填写 Token 即可(Base URL 留空)
|
|
457
|
-
|
|
458
|
-
2. **中转服务**(无需注册)⭐:
|
|
459
|
-
- 免费使用: https://linux.do/t/topic/1291730
|
|
460
|
-
- linux.do 社区提供的免费中转服务
|
|
461
|
-
- 安装时需填写 Base URL 和 Token
|
|
462
|
-
|
|
463
|
-
**安装时 Token 配置**:
|
|
464
|
-
|
|
465
|
-
```bash
|
|
466
|
-
npx ccg-workflow
|
|
467
|
-
# 选择 "初始化工作流"
|
|
468
|
-
# 选择 "安装 ace-tool"
|
|
469
|
-
|
|
470
|
-
# 提示:是否跳过 Token 配置?(默认:是)
|
|
471
|
-
# - 选择"否",立即配置 Token
|
|
472
|
-
# - 选择"是",稍后运行 `npx ccg config mcp` 配置
|
|
473
|
-
```
|
|
474
|
-
|
|
475
|
-
**其他 MCP 选项**(手动配置):
|
|
476
|
-
|
|
477
|
-
安装时选择"跳过 MCP",稍后可手动配置任何 MCP 服务:
|
|
478
|
-
|
|
479
|
-
1. **auggie**(Augment 官方 MCP):
|
|
480
|
-
- 配置教程: https://linux.do/t/topic/1280612
|
|
481
|
-
- 注意:auggie 不包含 Prompt 增强功能
|
|
482
|
-
|
|
483
|
-
2. **更多 MCP 服务**:
|
|
484
|
-
- Claude Code MCP 列表: https://github.com/anthropics/claude-code#mcp-servers
|
|
485
|
-
|
|
486
|
-
**手动配置 ace-tool**:
|
|
487
|
-
```bash
|
|
488
|
-
# 稍后配置
|
|
489
|
-
npx ccg config mcp
|
|
490
|
-
|
|
491
|
-
# 或编辑 ~/.claude.json 手动添加配置
|
|
492
|
-
```
|
|
493
|
-
|
|
494
|
-
</details>
|
|
495
|
-
|
|
496
|
-
<details>
|
|
497
|
-
<summary><strong>Q6: codeagent-wrapper 是什么?</strong></summary>
|
|
498
|
-
|
|
499
|
-
来自 [cexll/myclaude](https://github.com/cexll/myclaude) 的 Go 工具,封装了多 CLI 调用:
|
|
500
|
-
- 支持 `--backend codex/gemini/claude` 切换
|
|
501
|
-
- 会话管理(SESSION_ID)
|
|
502
|
-
- ROLE_FILE 动态注入
|
|
503
|
-
- **v1.4.2 新增**:Windows 命令自动包装
|
|
504
|
-
|
|
505
|
-
调用语法:
|
|
506
|
-
```bash
|
|
507
|
-
codeagent-wrapper --backend <codex|gemini|claude> - [工作目录] <<'EOF'
|
|
508
|
-
<任务内容>
|
|
509
|
-
EOF
|
|
510
|
-
```
|
|
278
|
+
- **`/ccg:frontend`** / **`/ccg:backend`** - 专项快速模式
|
|
279
|
+
- 只调用对应主导模型(更快)
|
|
280
|
+
- 适合明确的纯前端/纯后端任务
|
|
511
281
|
|
|
512
282
|
</details>
|
|
513
283
|
|
|
514
284
|
<details>
|
|
515
|
-
<summary><strong>
|
|
285
|
+
<summary><strong>Q5: 安装后提示 "codeagent-wrapper: command not found"?</strong></summary>
|
|
516
286
|
|
|
517
|
-
**原因**:PATH
|
|
287
|
+
**原因**:PATH 未生效
|
|
518
288
|
|
|
519
289
|
**解决方案**:
|
|
520
290
|
|
|
521
291
|
Mac/Linux:
|
|
522
292
|
```bash
|
|
523
|
-
# 重启终端或执行
|
|
524
293
|
source ~/.zshrc
|
|
525
294
|
# 或
|
|
526
295
|
source ~/.bashrc
|
|
@@ -529,25 +298,24 @@ source ~/.bashrc
|
|
|
529
298
|
Windows:
|
|
530
299
|
```powershell
|
|
531
300
|
# 重新打开 PowerShell
|
|
532
|
-
# 或手动验证环境变量:
|
|
533
|
-
# %USERPROFILE%\.claude\bin
|
|
534
301
|
```
|
|
535
302
|
|
|
536
303
|
</details>
|
|
537
304
|
|
|
538
305
|
<details>
|
|
539
|
-
<summary><strong>
|
|
306
|
+
<summary><strong>Q6: 如何卸载?</strong></summary>
|
|
540
307
|
|
|
541
308
|
```bash
|
|
542
309
|
npx ccg-workflow
|
|
543
310
|
# 选择 "卸载工作流"
|
|
544
311
|
```
|
|
545
312
|
|
|
546
|
-
|
|
547
|
-
-
|
|
548
|
-
-
|
|
549
|
-
-
|
|
550
|
-
-
|
|
313
|
+
会删除:
|
|
314
|
+
- `~/.claude/commands/ccg/` - 命令文件
|
|
315
|
+
- `~/.claude/agents/ccg/` - 子智能体
|
|
316
|
+
- `~/.claude/skills/` - skills
|
|
317
|
+
- `~/.claude/bin/codeagent-wrapper` - 二进制文件
|
|
318
|
+
- `~/.claude/.ccg/` - 配置目录(可选保留)
|
|
551
319
|
|
|
552
320
|
</details>
|
|
553
321
|
|
|
@@ -557,11 +325,11 @@ npx ccg-workflow
|
|
|
557
325
|
|
|
558
326
|
感谢以下开源项目的贡献:
|
|
559
327
|
|
|
560
|
-
- **[cexll/myclaude](https://github.com/cexll/myclaude)** -
|
|
561
|
-
- **[UfoMiao/zcf](https://github.com/UfoMiao/zcf)** - Git
|
|
328
|
+
- **[cexll/myclaude](https://github.com/cexll/myclaude)** - codeagent-wrapper 多后端调用工具
|
|
329
|
+
- **[UfoMiao/zcf](https://github.com/UfoMiao/zcf)** - Git 工具与 MCP 配置逻辑
|
|
562
330
|
- **[GudaStudio/skills](https://github.com/GuDaStudio/skills)** - 智能路由设计理念
|
|
563
|
-
- **[ace-tool MCP](https://linux.do/t/topic/1344562)** - 轻量级代码检索和 Prompt
|
|
564
|
-
- **[linux.do 社区](https://linux.do/)** - 活跃的 Vibe Coding
|
|
331
|
+
- **[ace-tool MCP](https://linux.do/t/topic/1344562)** - 轻量级代码检索和 Prompt 增强
|
|
332
|
+
- **[linux.do 社区](https://linux.do/)** - 活跃的 Vibe Coding 技术交流社区
|
|
565
333
|
|
|
566
334
|
---
|
|
567
335
|
|
|
@@ -569,7 +337,6 @@ npx ccg-workflow
|
|
|
569
337
|
|
|
570
338
|
- **GitHub Issues**: [提交问题](https://github.com/fengshao1227/ccg-workflow/issues)
|
|
571
339
|
- **讨论社区**: [linux.do - CCG 讨论帖](https://linux.do/t/topic/1405588)
|
|
572
|
-
- **完整文档**: [README.md](https://github.com/fengshao1227/ccg-workflow)
|
|
573
340
|
|
|
574
341
|
---
|
|
575
342
|
|
|
@@ -583,7 +350,7 @@ Copyright (c) 2025 fengshao1227
|
|
|
583
350
|
|
|
584
351
|
<div align="center">
|
|
585
352
|
|
|
586
|
-
**最后更新**: 2026-01-
|
|
353
|
+
**版本**: v1.7.0 | **最后更新**: 2026-01-08
|
|
587
354
|
|
|
588
355
|
Made with ❤️ by the CCG Community
|
|
589
356
|
|