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 CHANGED
@@ -7,10 +7,6 @@
7
7
  [![npm version](https://img.shields.io/npm/v/ccg-workflow.svg)](https://www.npmjs.com/package/ccg-workflow)
8
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
9
9
  [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-green.svg)](https://claude.ai/code)
10
- [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-Supported-orange.svg)](https://github.com/openai/openai-python)
11
- [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Supported-purple.svg)](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
- ## 🎯 v1.4.2 重大改进
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** (主导编排) + **Codex CLI** (后端原型) + **Gemini CLI** (前端原型)
19
+ **CCG** = **Claude Code** (编排) + **Codex CLI** (后端) + **Gemini CLI** (前端)
75
20
 
76
- ### 设计哲学
21
+ 一个让 Claude Code 专注于编排决策,把具体代码生成交给专业模型的多模型协作系统:
77
22
 
78
- Claude Code 专注于编排决策和代码实施,把具体的代码生成交给专业模型:
79
- - **前端任务**Gemini(视觉设计、组件原型)
80
- - **后端任务** → Codex(逻辑运算、算法调试)
23
+ - **前端任务** Gemini(擅长 UI/CSS/组件)
24
+ - **后端任务**Codex(擅长逻辑/算法/调试)
81
25
  - **全栈整合** → Claude(工作流控制、代码主权)
82
26
 
83
27
  ### 核心优势
84
28
 
85
- | 优势 | 说明 |
86
- |-----|------|
87
- | **智能路由** | 根据任务类型自动选择最合适的模型 |
88
- | **交叉验证** | 双模型并行生成,相互验证减少错误 |
89
- | **零写入权限** | 外部模型只能返回 Patch,Claude 保持代码主权 |
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
- 1. **必需**:
146
- - [Claude Code CLI](https://claude.ai/code) - 主导编排
147
- - Node.js 18+
41
+ **必需**:
42
+ - [Claude Code CLI](https://claude.ai/code)
43
+ - Node.js 18+
148
44
 
149
- 2. **可选**(根据需求):
150
- - [Codex CLI](https://github.com/openai/openai-codeinterpreter) - 后端任务
151
- - [Gemini CLI](https://github.com/google/generative-ai-cli) - 前端任务
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
- ```bash
169
- # 检查 codeagent-wrapper
170
- codeagent-wrapper --version
63
+ 就这么简单!无需选择语言、模型、命令预设。
171
64
 
172
- # 检查配置文件
173
- cat ~/.claude/.ccg/config.toml
65
+ ### 固定配置
174
66
 
175
- # 诊断 MCP 配置(v1.4.2 新增)
176
- npx ccg diagnose-mcp
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:dev 实现用户登录功能
184
-
185
- # 系统会自动执行 6 阶段工作流:
186
- # Phase 0: Prompt 增强 (MCP)
187
- # Phase 1: 代码检索 (MCP)
188
- # Phase 2: 多模型分析 (Codex Gemini 并行)
189
- # Phase 3: 原型生成 (前端→Gemini / 后端→Codex)
190
- # Phase 4: 代码实施 (Claude 重构为生产级)
191
- # Phase 5: 审计交付 (Codex ∥ Gemini 交叉验证)
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
- | `/ccg:dev` | 完整6阶段开发工作流 | MCP + Codex + Gemini |
203
- | `/ccg:code` | 智能代码生成(自动路由)| 前端→Gemini / 后端→Codex |
204
- | `/ccg:frontend` | 前端/UI/样式任务 | Gemini |
205
- | `/ccg:backend` | 后端/逻辑/算法任务 | Codex |
206
- | `/ccg:debug` | UltraThink 多模型调试 | Codex + Gemini 并行 |
207
- | `/ccg:test` | 多模型测试生成 | Codex + Gemini 并行 |
208
- | `/ccg:bugfix` | 质量门控修复(90%+ 通过)| Codex + Gemini 交叉验证 |
209
- | `/ccg:optimize` | 性能优化 | Codex + Gemini 并行 |
210
- | `/ccg:review` | 代码审查(无参数自动审查 git diff)| Codex + Gemini 并行 |
211
- | `/ccg:analyze` | 技术分析 | Codex + Gemini 并行 |
212
- | `/ccg:think` | 深度分析 | Codex + Gemini 并行 |
213
- | `/ccg:enhance` | Prompt 增强 | ace-tool MCP |
214
- | `/ccg:scan` | 智能仓库扫描 | 分析项目结构 |
215
- | `/ccg:feat` | 智能功能开发(规划→实施→审查)| 多模型协作 |
216
-
217
- ### Git 工具命令
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` | 智能 commit:分析改动,生成 conventional commit 信息 |
222
- | `/ccg:rollback` | 交互式回滚:列分支、列版本、二次确认 |
223
- | `/ccg:clean-branches` | 分支清理:安全查找并清理已合并分支 |
224
- | `/ccg:worktree` | Worktree 管理:在 `../.ccg/项目名/` 下创建 |
122
+ | `/ccg:commit` | 智能提交(自动生成 conventional commit)|
123
+ | `/ccg:rollback` | 交互式回滚 |
124
+ | `/ccg:clean-branches` | 清理已合并分支 |
125
+ | `/ccg:worktree` | Worktree 管理 |
225
126
 
226
- ### CLI 诊断工具(v1.4.2 新增)
127
+ #### 项目工具
227
128
 
228
129
  | 命令 | 用途 |
229
130
  |-----|------|
230
- | `npx ccg diagnose-mcp` | 诊断 MCP 配置问题 |
231
- | `npx ccg fix-mcp` | 修复 Windows MCP 配置(Windows 用户)|
131
+ | `/ccg:init` | 初始化项目 CLAUDE.md |
232
132
 
233
133
  ---
234
134
 
235
135
  ## 🎭 专家角色系统
236
136
 
237
- ### 核心机制:ROLE_FILE 动态注入
137
+ ### ROLE_FILE 动态注入机制
238
138
 
239
- 18个专家提示词(Codex 6 + Gemini 6 + Claude 6个),采用 **零 token 消耗** 的 ROLE_FILE 动态注入机制:
139
+ 12 个专家提示词(Codex 6 + Gemini 6),**零 token 消耗**:
240
140
 
241
- - ✅ 每个命令自动注入对应角色提示词
242
- - 不占用主会话 token
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
- | 命令 | Codex 角色 | Gemini 角色 |
248
- |------|-----------|------------|
249
- | `/ccg:code`, `/ccg:backend` | architect.md(后端架构师)| - |
250
- | `/ccg:frontend` | - | frontend.md(前端架构师)|
251
- | `/ccg:analyze`, `/ccg:think` | analyzer.md | analyzer.md |
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
- [routing.backend]
307
- models = ["codex"]
308
- primary = "codex"
309
- strategy = "fallback"
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
- ~/.claude/
318
- ├── commands/ccg/ # ✅ Claude Code 读取的 slash commands
319
- ├── dev.md, code.md, frontend.md, backend.md
320
- │ ├── debug.md, test.md, bugfix.md, review.md
321
- ├── optimize.md, analyze.md, think.md, enhance.md
322
- │ ├── scan.md, feat.md, commit.md, rollback.md
323
- ├── clean-branches.md, worktree.md, init.md
324
- ├── agents/ccg/ # ✅ Claude Code 读取的 subagents
325
- │ ├── planner.md, ui-ux-designer.md
326
- ├── init-architect.md, get-current-datetime.md
327
- ├── bin/ # ✅ 二进制文件
328
- └── codeagent-wrapper # (Windows 自动包装 MCP 命令)
329
- └── .ccg/ # ✅ CCG 配置目录(v1.4.0+)
330
- ├── config.toml # 主配置文件
331
- ├── shared-config.md # 共享配置
332
- ├── backup/ # ✨ v1.4.2 新增:自动备份
333
- └── prompts/ # 专家提示词
334
- ├── codex/, gemini/, claude/
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: Windows 用户 MCP 安装后不工作怎么办?</strong></summary>
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
- ```bash
354
- # 诊断问题
355
- npx ccg diagnose-mcp
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: 如何更新到 v1.4.2?</strong></summary>
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
- </details>
241
+ 1. **官方服务**:
242
+ - 注册地址:https://augmentcode.com/
243
+ - 获取 Token 后填写即可
388
244
 
389
- <details>
390
- <summary><strong>Q3: v1.4.0 目录迁移会影响我吗?</strong></summary>
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>Q4: MCP 工具如何选择?</strong></summary>
411
-
412
- **ace-tool**(推荐):
413
- - ✅ 开箱即用
414
- - Prompt 增强 + 代码检索
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>Q5: codeagent-wrapper 是什么?</strong></summary>
272
+ <summary><strong>Q4: `/ccg:workflow` 和 `/ccg:frontend`/`/ccg:backend` 有什么区别?</strong></summary>
434
273
 
435
- 来自 [cexll/myclaude](https://github.com/cexll/myclaude) Go 工具,封装了多 CLI 调用:
436
- - 支持 `--backend codex/gemini/claude` 切换
437
- - 会话管理(SESSION_ID)
438
- - ROLE_FILE 动态注入
439
- - **v1.4.2 新增**:Windows 命令自动包装
274
+ - **`/ccg:workflow`** - 完整 6 阶段工作流
275
+ - 每阶段都并行调用 Codex + Gemini
276
+ - 适合全栈任务、复杂任务
440
277
 
441
- 调用语法:
442
- ```bash
443
- codeagent-wrapper --backend <codex|gemini|claude> - [工作目录] <<'EOF'
444
- <任务内容>
445
- EOF
446
- ```
278
+ - **`/ccg:frontend`** / **`/ccg:backend`** - 专项快速模式
279
+ - 只调用对应主导模型(更快)
280
+ - 适合明确的纯前端/纯后端任务
447
281
 
448
282
  </details>
449
283
 
450
284
  <details>
451
- <summary><strong>Q6: 安装后提示 "codeagent-wrapper: command not found"?</strong></summary>
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>Q7: 如何卸载 CCG 系统?</strong></summary>
306
+ <summary><strong>Q6: 如何卸载?</strong></summary>
476
307
 
477
308
  ```bash
478
309
  npx ccg-workflow
479
310
  # 选择 "卸载工作流"
480
311
  ```
481
312
 
482
- 卸载会:
483
- - 删除 `~/.claude/commands/ccg/` 命令文件
484
- - 删除 `~/.claude/agents/ccg/` 子智能体
485
- - 删除 `~/.claude/bin/codeagent-wrapper` 二进制
486
- - 删除 `~/.claude/.ccg/` 配置目录(可选保留)
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)** - `codeagent-wrapper` 多后端调用工具
497
- - **[UfoMiao/zcf](https://github.com/UfoMiao/zcf)** - Git 工具 + **MCP 跨平台配置逻辑**(v1.4.2)
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-06 | **版本**: v1.4.2
353
+ **版本**: v1.7.0 | **最后更新**: 2026-01-08
523
354
 
524
355
  Made with ❤️ by the CCG Community
525
356