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 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
- > 🎉 **Windows MCP 自动修复** - 彻底解决 Windows 用户 MCP 安装问题!
14
10
 
15
11
  [快速开始](#-快速开始) • [命令参考](#-命令参考) • [常见问题](#-常见问题) • [更新日志](CHANGELOG.md)
16
12
 
@@ -18,116 +14,23 @@
18
14
 
19
15
  ---
20
16
 
21
- ## 🎯 v1.6.0 重大改进
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
- | **零写入权限** | 外部模型只能返回 Patch,Claude 保持代码主权 |
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
- 1. **必需**:
139
- - [Claude Code CLI](https://claude.ai/code) - 主导编排
140
- - Node.js 18+
41
+ **必需**:
42
+ - [Claude Code CLI](https://claude.ai/code)
43
+ - Node.js 18+
141
44
 
142
- 2. **可选**(根据需求):
143
- - [Codex CLI](https://github.com/openai/openai-codeinterpreter) - 后端任务
144
- - [Gemini CLI](https://github.com/google/generative-ai-cli) - 前端任务
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
- **Workflow 预设说明**:
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
- ```bash
179
- # 检查 codeagent-wrapper
180
- codeagent-wrapper --version
181
-
182
- # 检查配置文件
183
- cat ~/.claude/.ccg/config.toml
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:dev 实现用户登录功能
194
-
195
- # 系统会自动执行 6 阶段工作流:
196
- # Phase 0: Prompt 增强 (MCP)
197
- # Phase 1: 代码检索 (MCP)
198
- # Phase 2: 多模型分析 (Codex Gemini 并行)
199
- # Phase 3: 原型生成 (前端→Gemini / 后端→Codex)
200
- # Phase 4: 代码实施 (Claude 重构为生产级)
201
- # 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: 评审 - 质量检查
202
87
  ```
203
88
 
204
89
  ---
205
90
 
206
91
  ## 📚 命令参考
207
92
 
208
- ### 开发工作流命令
209
-
210
- | 命令 | 用途 | 模型路由 | 工作流 |
211
- |-----|------|---------|--------|
212
- | `/ccg:dev` | 完整6阶段开发工作流 | MCP + Codex + Gemini | Prompt增强 → 检索 → 分析 → 原型 → 实施 → 审计 |
213
- | `/ccg:code` | 智能代码生成(自动路由)| 前端→Gemini / 后端→Codex | 检索 → 原型 → 实施 |
214
- | `/ccg:frontend` | 前端/UI/样式任务 | **多模型并行**(Gemini + Claude)| 检索 → 分析 → 原型 → 实施 → 审计 |
215
- | `/ccg:backend` | 后端/逻辑/算法任务 | **多模型并行**(Codex + Gemini)| 检索 → 分析 → 原型 → 实施 → 审计 |
216
- | `/ccg:debug` | UltraThink 多模型调试 | Codex + Gemini 并行 | 分析 → 诊断 |
217
- | `/ccg:test` | 多模型测试生成 | Codex + Gemini 并行 | 分析 → 生成 |
218
- | `/ccg:bugfix` | 质量门控修复(90%+ 通过)| Codex + Gemini 交叉验证 | 分析 → 修复 → 验证 |
219
- | `/ccg:optimize` | 性能优化 | Codex + Gemini 并行 | 分析 → 优化 |
220
- | `/ccg:review` | 代码审查(无参数自动审查 git diff)| Codex + Gemini 并行 | 审查 → 反馈 |
221
- | `/ccg:analyze` | 技术分析 | Codex + Gemini 并行 | 深度分析 |
222
- | `/ccg:think` | 深度分析 | Codex + Gemini 并行 | UltraThink 分析 |
223
- | `/ccg:scan` | 智能仓库扫描 | 分析项目结构 | 扫描报告 |
224
- | `/ccg:feat` | 智能功能开发(规划→实施→审查)| 多模型协作 | 规划 → 实施 → 审查 |
225
-
226
- ### 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 工具
227
119
 
228
120
  | 命令 | 用途 |
229
121
  |-----|------|
230
- | `/ccg:commit` | 智能 commit:分析改动,生成 conventional commit 信息 |
231
- | `/ccg:rollback` | 交互式回滚:列分支、列版本、二次确认 |
232
- | `/ccg:clean-branches` | 分支清理:安全查找并清理已合并分支 |
233
- | `/ccg:worktree` | Worktree 管理:在 `../.ccg/项目名/` 下创建 |
122
+ | `/ccg:commit` | 智能提交(自动生成 conventional commit)|
123
+ | `/ccg:rollback` | 交互式回滚 |
124
+ | `/ccg:clean-branches` | 清理已合并分支 |
125
+ | `/ccg:worktree` | Worktree 管理 |
234
126
 
235
- ### CLI 诊断工具(v1.4.2 新增)
127
+ #### 项目工具
236
128
 
237
129
  | 命令 | 用途 |
238
130
  |-----|------|
239
- | `npx ccg diagnose-mcp` | 诊断 MCP 配置问题 |
240
- | `npx ccg fix-mcp` | 修复 Windows MCP 配置(Windows 用户)|
131
+ | `/ccg:init` | 初始化项目 CLAUDE.md |
241
132
 
242
133
  ---
243
134
 
244
135
  ## 🎭 专家角色系统
245
136
 
246
- ### 核心机制:ROLE_FILE 动态注入
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
- | 命令 | Codex 角色 | Gemini 角色 |
258
- |------|-----------|------------|
259
- | `/ccg:code`, `/ccg:backend` | architect.md(后端架构师)| - |
260
- | `/ccg:frontend` | - | frontend.md(前端架构师)|
261
- | `/ccg:analyze`, `/ccg:think` | analyzer.md | analyzer.md |
262
- | `/ccg:debug` | debugger.md | debugger.md |
263
- | `/ccg:test` | tester.md | tester.md |
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
- ~/.claude/.ccg/prompts/ # v1.4.0+ 新位置
271
- ├── codex/ # Codex CLI 后端专家(6个)
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
- [routing.backend]
313
- models = ["codex"]
314
- primary = "codex"
315
- 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/
316
179
  ```
317
180
 
318
181
  ---
319
182
 
320
- ## 🗂️ 安装目录结构
183
+ ## 🏗️ 架构说明
321
184
 
322
185
  ```
323
- ~/.claude/
324
- ├── commands/ccg/ # ✅ Claude Code 读取的 slash commands
325
- ├── dev.md, code.md, frontend.md, backend.md
326
- │ ├── debug.md, test.md, bugfix.md, review.md
327
- ├── optimize.md, analyze.md, think.md, enhance.md
328
- │ ├── scan.md, feat.md, commit.md, rollback.md
329
- ├── clean-branches.md, worktree.md, init.md
330
- ├── agents/ccg/ # ✅ Claude Code 读取的 subagents
331
- │ ├── planner.md, ui-ux-designer.md
332
- ├── init-architect.md, get-current-datetime.md
333
- ├── bin/ # ✅ 二进制文件
334
- └── codeagent-wrapper # (Windows 自动包装 MCP 命令)
335
- └── .ccg/ # ✅ CCG 配置目录(v1.4.0+)
336
- ├── config.toml # 主配置文件
337
- ├── backup/ # ✨ v1.4.2 新增:自动备份
338
- └── prompts/ # 专家提示词
339
- ├── 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
+ (零写入权限,仅返回补丁)
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: v1.6.0 有哪些重要更新?</strong></summary>
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
- - ✅ MCP 安装简化为 2 个选项(ace-tool / 跳过)
356
- - ✅ 添加 linux.do 中转服务支持(无需注册)
357
- - Workflow 预设:最小化(3) / 标准(12) / 完整(17)
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: Windows 用户 MCP 安装后不工作怎么办?</strong></summary>
230
+ <summary><strong>Q2: MCP 工具如何配置?</strong></summary>
376
231
 
377
- **v1.4.2 已自动修复!**
232
+ **安装时配置**(推荐):
378
233
 
379
- 新用户:
380
234
  ```bash
381
- npx ccg-workflow@latest init
382
- # 安装时自动应用 Windows 修复
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
- npx ccg fix-mcp
392
- ```
241
+ 1. **官方服务**:
242
+ - 注册地址:https://augmentcode.com/
243
+ - 获取 Token 后填写即可
393
244
 
394
- 手动验证:
395
- ```bash
396
- # 检查配置是否正确
397
- cat ~/.claude.json
245
+ 2. **中转服务**(无需注册)⭐:
246
+ - 免费使用:https://linux.do/t/topic/1291730
247
+ - linux.do 社区提供
248
+ - 需填写 Base URL 和 Token
398
249
 
399
- # 应该看到 "command": "cmd", "args": ["/c", "npx", ...]
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
- - 保留用户配置和 MCP 设置
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: v1.4.0 目录迁移会影响我吗?</strong></summary>
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
- ~/.ccg/ → ~/.claude/.ccg/
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>Q7: 安装后提示 "codeagent-wrapper: command not found"?</strong></summary>
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>Q8: 如何卸载 CCG 系统?</strong></summary>
306
+ <summary><strong>Q6: 如何卸载?</strong></summary>
540
307
 
541
308
  ```bash
542
309
  npx ccg-workflow
543
310
  # 选择 "卸载工作流"
544
311
  ```
545
312
 
546
- 卸载会:
547
- - 删除 `~/.claude/commands/ccg/` 命令文件
548
- - 删除 `~/.claude/agents/ccg/` 子智能体
549
- - 删除 `~/.claude/bin/codeagent-wrapper` 二进制
550
- - 删除 `~/.claude/.ccg/` 配置目录(可选保留)
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)** - `codeagent-wrapper` 多后端调用工具
561
- - **[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 配置逻辑
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-07 | **版本**: v1.6.0
353
+ **版本**: v1.7.0 | **最后更新**: 2026-01-08
587
354
 
588
355
  Made with ❤️ by the CCG Community
589
356