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