ccg-workflow 1.4.1 → 1.4.2
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 +500 -483
- package/dist/cli.mjs +67 -2
- package/dist/index.mjs +1 -1
- package/dist/shared/{ccg-workflow.DaI-Qubz.mjs → ccg-workflow.DrRf2eRd.mjs} +152 -42
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,157 +1,131 @@
|
|
|
1
|
-
#
|
|
1
|
+
# CCG - Claude + Codex + Gemini 多模型协作系统
|
|
2
2
|
|
|
3
3
|
<div align="center">
|
|
4
4
|
|
|
5
|
-
**Claude Code
|
|
5
|
+
**Claude Code 编排 Codex + Gemini 双模型协作的智能开发工作流系统**
|
|
6
6
|
|
|
7
|
-
[](https://www.npmjs.com/package/ccg-workflow)
|
|
7
|
+
[](https://www.npmjs.com/package/ccg-workflow)
|
|
8
|
+
[](https://opensource.org/licenses/MIT)
|
|
9
|
+
[](https://claude.ai/code)
|
|
10
|
+
[](https://github.com/openai/openai-python)
|
|
11
|
+
[](https://ai.google.dev/)
|
|
8
12
|
|
|
9
|
-
> **最新版本 v1.
|
|
13
|
+
> **最新版本 v1.4.2** - Windows MCP 配置自动修复 + 诊断工具
|
|
14
|
+
|
|
15
|
+
[快速开始](#-快速开始) • [命令参考](#-命令参考) • [常见问题](#-常见问题) • [更新日志](CHANGELOG.md)
|
|
10
16
|
|
|
11
17
|
</div>
|
|
12
18
|
|
|
13
19
|
---
|
|
14
20
|
|
|
15
|
-
##
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
|
|
30
|
-
### v1.3.4 - 默认语言修复 🌏
|
|
31
|
-
- ✅ **中文界面**:修复 `npx ccg-workflow` 默认显示英文的问题
|
|
32
|
-
- ✅ **默认设置**:将默认语言改为中文(zh-CN)
|
|
33
|
-
- ✅ **用户体验**:国内用户无需手动选择语言
|
|
34
|
-
|
|
35
|
-
<details>
|
|
36
|
-
<summary>v1.3.3 - Windows PATH 配置安全修复 (2026-01-05)</summary>
|
|
37
|
-
|
|
38
|
-
- ✅ **安全修复**:Windows PATH 配置改用安全追加方法,避免 `setx` 1024 字符限制
|
|
39
|
-
- ✅ **新方法**:使用 PowerShell `[System.Environment]::GetEnvironmentVariable` 先读取后追加
|
|
40
|
-
- ✅ **重复检测**:自动检查路径是否已存在,避免重复添加
|
|
41
|
-
- ✅ **无字符限制**:支持超长 PATH(最大 32767 字符)
|
|
42
|
-
- ✅ **向下兼容**:不影响现有用户配置
|
|
43
|
-
</details>
|
|
44
|
-
|
|
45
|
-
<details>
|
|
46
|
-
<summary>v1.3.2 - MCP 配置缺失修复 (2026-01-05)</summary>
|
|
47
|
-
|
|
48
|
-
- ✅ **关键修复**:安装后 `~/.ccg/config.toml` 现在包含完整的 `[mcp]` 配置部分
|
|
49
|
-
- ✅ **类型安全**:添加 `CcgConfig.mcp` TypeScript 接口定义
|
|
50
|
-
- ✅ **默认配置**:`createDefaultConfig` 自动生成完整 MCP 配置
|
|
51
|
-
- ✅ **配置版本**:配置文件版本号从 1.0.0 升级到 1.3.2
|
|
52
|
-
</details>
|
|
53
|
-
|
|
54
|
-
<details>
|
|
55
|
-
<summary>v1.3.1 - 命令模板修正 (2026-01-05)</summary>
|
|
56
|
-
|
|
57
|
-
- ✅ **说明修正**:澄清 auggie 也支持 Prompt 增强功能(需按教程配置)
|
|
58
|
-
- ✅ **模板更新**:修正 `/ccg:dev` 和 `/ccg:enhance` 命令的提示信息
|
|
59
|
-
- ✅ **配置说明**:`prompt_enhance_auggie = ""` 改为"留空表示未配置,按教程配置后填入工具名"
|
|
60
|
-
- ✅ **用户体验**:提供配置教程链接,不再误导用户认为 auggie 不支持 Prompt 增强
|
|
61
|
-
</details>
|
|
62
|
-
|
|
63
|
-
<details>
|
|
64
|
-
<summary>v1.3.0 - MCP 动态选择系统 (2026-01-05)</summary>
|
|
65
|
-
|
|
66
|
-
- ✅ **多 MCP 支持**:安装时可选 ace-tool(开箱即用Prompt增强+代码检索)或 auggie(官方原版,代码检索+可选Prompt增强)
|
|
67
|
-
- ✅ **交互式选择**:友好的 MCP 选择界面,对比功能差异,支持跳过安装
|
|
68
|
-
- ✅ **配置驱动**:生成 `~/.ccg/config.toml`,记录工具映射和参数名
|
|
69
|
-
- ✅ **自包含模板**:命令模板减少 50% 提示词长度,直接读取配置无需外部文档
|
|
70
|
-
- ✅ **完全兼容**:12个命令模板(dev, code, frontend, backend, review, analyze, enhance 等)支持动态 MCP 工具调用
|
|
71
|
-
- ✅ **灵活配置**:auggie 可通过配置支持 Prompt 增强(参考 [配置教程](https://linux.do/t/topic/1280612))
|
|
72
|
-
</details>
|
|
21
|
+
## 📖 目录
|
|
22
|
+
|
|
23
|
+
- [核心理念](#-核心理念)
|
|
24
|
+
- [架构说明](#-架构说明)
|
|
25
|
+
- [核心特性](#-核心特性)
|
|
26
|
+
- [快速开始](#-快速开始)
|
|
27
|
+
- [安装指南](#-安装指南)
|
|
28
|
+
- [命令参考](#-命令参考)
|
|
29
|
+
- [工作流详解](#-工作流详解)
|
|
30
|
+
- [专家角色系统](#-专家角色系统)
|
|
31
|
+
- [配置文件](#-配置文件)
|
|
32
|
+
- [常见问题](#-常见问题)
|
|
33
|
+
- [开发指南](#-开发指南)
|
|
34
|
+
- [致谢](#-致谢)
|
|
73
35
|
|
|
74
|
-
|
|
75
|
-
<summary>查看历史版本 (v1.0.0 - v1.2.3)</summary>
|
|
36
|
+
---
|
|
76
37
|
|
|
77
|
-
|
|
78
|
-
- 安装后自动验证 `codeagent-wrapper` 可用性
|
|
79
|
-
- 安装失败时显示详细错误信息和解决方案
|
|
38
|
+
## 💡 核心理念
|
|
80
39
|
|
|
81
|
-
|
|
82
|
-
- `codeagent-wrapper` 自动识别 `ROLE_FILE:` 指令
|
|
83
|
-
- 专家提示词零 token 消耗,不占用主会话
|
|
40
|
+
CCG = **Claude Code** (主导编排) + **Codex CLI** (后端原型) + **Gemini CLI** (前端原型)
|
|
84
41
|
|
|
85
|
-
###
|
|
86
|
-
- Mac/Linux 自动添加到 shell 配置文件
|
|
87
|
-
- Windows 提供 PowerShell 一键命令
|
|
42
|
+
### 设计哲学
|
|
88
43
|
|
|
89
|
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
44
|
+
让 Claude Code 专注于编排决策和代码实施,把具体的代码生成交给专业模型:
|
|
45
|
+
- **前端任务** → Gemini(视觉设计、组件原型)
|
|
46
|
+
- **后端任务** → Codex(逻辑运算、算法调试)
|
|
47
|
+
- **全栈整合** → Claude(工作流控制、代码主权)
|
|
92
48
|
|
|
93
|
-
###
|
|
94
|
-
- `npx ccg-workflow` 一键安装
|
|
95
|
-
- 三模型协作(Claude + Codex + Gemini)
|
|
96
|
-
- 18 个专家提示词
|
|
49
|
+
### 核心优势
|
|
97
50
|
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
51
|
+
| 优势 | 说明 |
|
|
52
|
+
|-----|------|
|
|
53
|
+
| **智能路由** | 根据任务类型自动选择最合适的模型 |
|
|
54
|
+
| **交叉验证** | 双模型并行生成,相互验证减少错误 |
|
|
55
|
+
| **零写入权限** | 外部模型只能返回 Patch,Claude 保持代码主权 |
|
|
56
|
+
| **Token 优化** | ROLE_FILE 动态注入,专家提示词零 token 消耗 |
|
|
101
57
|
|
|
102
58
|
---
|
|
103
59
|
|
|
104
|
-
## 架构说明
|
|
105
|
-
|
|
106
|
-
### Claude Code 主导的三 CLI 协作模式
|
|
60
|
+
## 🏗️ 架构说明
|
|
107
61
|
|
|
108
62
|
```
|
|
109
|
-
|
|
110
|
-
│
|
|
111
|
-
│
|
|
112
|
-
|
|
113
|
-
│
|
|
114
|
-
|
|
115
|
-
│
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
│
|
|
119
|
-
│
|
|
120
|
-
│
|
|
121
|
-
|
|
63
|
+
┌─────────────────────────────────────────────────┐
|
|
64
|
+
│ Claude Code CLI (主导编排) │
|
|
65
|
+
│ 决策、编排、代码实施、质量把控 │
|
|
66
|
+
└──────────────┬──────────────────────────────────┘
|
|
67
|
+
│
|
|
68
|
+
┌───────┴────────┐
|
|
69
|
+
│ │
|
|
70
|
+
↓ ↓
|
|
71
|
+
┌─────────────┐ ┌─────────────┐
|
|
72
|
+
│ Codex CLI │ │ Gemini CLI │
|
|
73
|
+
│ 后端原型 │ │ 前端原型 │
|
|
74
|
+
│ 逻辑算法 │ │ UI 组件 │
|
|
75
|
+
└─────────────┘ └─────────────┘
|
|
76
|
+
│ │
|
|
77
|
+
└────────┬───────┘
|
|
78
|
+
↓
|
|
79
|
+
Unified Diff Patch
|
|
80
|
+
(只读,不能直接修改文件)
|
|
122
81
|
```
|
|
123
82
|
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
-
|
|
127
|
-
-
|
|
128
|
-
-
|
|
83
|
+
### 安全机制
|
|
84
|
+
|
|
85
|
+
- **零写入权限**:Codex/Gemini 对文件系统无写入权限
|
|
86
|
+
- **Unified Diff**:所有外部模型输出必须为 Patch 格式
|
|
87
|
+
- **脏原型处理**:外部模型输出视为"脏原型",需经 Claude 重构
|
|
129
88
|
|
|
130
89
|
---
|
|
131
90
|
|
|
132
|
-
## 核心特性
|
|
91
|
+
## ✨ 核心特性
|
|
133
92
|
|
|
134
93
|
| 特性 | 描述 |
|
|
135
94
|
|------|------|
|
|
136
|
-
|
|
|
137
|
-
|
|
|
138
|
-
|
|
|
139
|
-
| **
|
|
140
|
-
| **
|
|
141
|
-
| **
|
|
142
|
-
|
|
|
143
|
-
|
|
|
95
|
+
| **智能路由** | 前端任务→Gemini,后端任务→Codex,全栈整合→Claude |
|
|
96
|
+
| **双模型并行** | Codex ∥ Gemini 同时调用,交叉验证结果 |
|
|
97
|
+
| **MCP 动态选择** | 安装时可选 ace-tool(开箱即用)/ auggie(官方版本)|
|
|
98
|
+
| **6阶段工作流** | Prompt增强 → 代码检索 → 分析 → 原型 → 实施 → 审计 |
|
|
99
|
+
| **18个专家提示词** | Codex 6个 + Gemini 6个 + Claude 6个 |
|
|
100
|
+
| **Git 自动化** | 智能 commit、交互式回滚、分支清理、Worktree 管理 |
|
|
101
|
+
| **npx 一键安装** | 无需全局安装,交互式配置菜单 |
|
|
102
|
+
| **跨平台支持** | macOS、Linux、Windows |
|
|
144
103
|
|
|
145
104
|
---
|
|
146
105
|
|
|
147
|
-
## 快速开始
|
|
106
|
+
## 🚀 快速开始
|
|
107
|
+
|
|
108
|
+
### 前置要求
|
|
109
|
+
|
|
110
|
+
1. **必需**:
|
|
111
|
+
- [Claude Code CLI](https://claude.ai/code) - 主导编排
|
|
112
|
+
- Node.js 18+
|
|
113
|
+
|
|
114
|
+
2. **可选**(根据需求):
|
|
115
|
+
- [Codex CLI](https://github.com/openai/openai-codeinterpreter) - 后端任务
|
|
116
|
+
- [Gemini CLI](https://github.com/google/generative-ai-cli) - 前端任务
|
|
148
117
|
|
|
149
118
|
### 方式一:npx 直接运行(推荐)
|
|
150
119
|
|
|
151
120
|
```bash
|
|
152
|
-
#
|
|
121
|
+
# 交互式安装
|
|
153
122
|
npx ccg-workflow
|
|
154
123
|
|
|
124
|
+
# 选择 "初始化工作流"
|
|
125
|
+
# 选择语言(中文 / English)
|
|
126
|
+
# 选择 MCP 工具(推荐 ace-tool)
|
|
127
|
+
# 等待安装完成(约 1-2 分钟)
|
|
128
|
+
# 重启终端
|
|
155
129
|
```
|
|
156
130
|
|
|
157
131
|
### 方式二:全局安装
|
|
@@ -170,15 +144,26 @@ pnpm install && pnpm build
|
|
|
170
144
|
pnpm start
|
|
171
145
|
```
|
|
172
146
|
|
|
173
|
-
###
|
|
147
|
+
### 验证安装
|
|
174
148
|
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
-
|
|
149
|
+
```bash
|
|
150
|
+
# 检查 codeagent-wrapper 是否可用
|
|
151
|
+
codeagent-wrapper --version
|
|
152
|
+
|
|
153
|
+
# 应该显示类似:codeagent-wrapper v5.4.0
|
|
154
|
+
|
|
155
|
+
# 检查配置文件
|
|
156
|
+
cat ~/.claude/.ccg/config.toml
|
|
157
|
+
|
|
158
|
+
# 检查命令是否安装
|
|
159
|
+
ls ~/.claude/commands/ccg/
|
|
160
|
+
```
|
|
178
161
|
|
|
179
162
|
---
|
|
180
163
|
|
|
181
|
-
##
|
|
164
|
+
## 📦 安装指南
|
|
165
|
+
|
|
166
|
+
### 交互式菜单
|
|
182
167
|
|
|
183
168
|
运行后会显示交互式菜单:
|
|
184
169
|
|
|
@@ -197,15 +182,15 @@ pnpm start
|
|
|
197
182
|
### 首次安装
|
|
198
183
|
|
|
199
184
|
选择 **"初始化 CCG 配置"** 进行首次安装,会引导你:
|
|
200
|
-
|
|
201
|
-
|
|
185
|
+
|
|
186
|
+
1. **选择语言**(中文/English)
|
|
187
|
+
2. **选择 MCP 工具**:
|
|
202
188
|
- **[1] ace-tool**(推荐新手):开箱即用,自动配置 Prompt 增强 + 代码检索
|
|
203
189
|
- **[2] auggie**(官方原版):代码检索 + 可选 Prompt 增强(需额外配置,[查看教程](https://linux.do/t/topic/1280612))
|
|
204
190
|
- **[0] 跳过**:稍后手动配置
|
|
205
|
-
3.
|
|
206
|
-
4.
|
|
207
|
-
5.
|
|
208
|
-
6. 选择要安装的工作流
|
|
191
|
+
3. **自动检测旧版本并迁移**(v1.3.x → v1.4.x)
|
|
192
|
+
4. **安装命令模板和提示词**
|
|
193
|
+
5. **配置 PATH 环境变量**
|
|
209
194
|
|
|
210
195
|
### 更新到最新版
|
|
211
196
|
|
|
@@ -214,6 +199,7 @@ pnpm start
|
|
|
214
199
|
2. 📊 显示当前版本 vs 最新版本对比
|
|
215
200
|
3. 📥 自动更新所有命令模板和提示词
|
|
216
201
|
4. ✅ 保留用户配置和自定义内容
|
|
202
|
+
5. 🔄 自动迁移旧版本目录结构
|
|
217
203
|
|
|
218
204
|
**特性**:
|
|
219
205
|
- ✅ 自动检测版本,有更新时提示
|
|
@@ -221,168 +207,190 @@ pnpm start
|
|
|
221
207
|
- ✅ 无需 sudo 权限
|
|
222
208
|
- ✅ 无需卸载重装
|
|
223
209
|
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
## 使用
|
|
210
|
+
### 卸载
|
|
227
211
|
|
|
228
212
|
```bash
|
|
229
|
-
#
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
/ccg:code "添加用户注册表单"
|
|
234
|
-
|
|
235
|
-
# UltraThink 调试
|
|
236
|
-
/ccg:debug "登录接口返回 500 错误"
|
|
237
|
-
|
|
238
|
-
# 多模型测试生成
|
|
239
|
-
/ccg:test "为用户服务添加单元测试"
|
|
213
|
+
# 交互式卸载
|
|
214
|
+
npx ccg-workflow
|
|
215
|
+
# 选择 "卸载 CCG"
|
|
216
|
+
```
|
|
240
217
|
|
|
241
|
-
|
|
242
|
-
/ccg
|
|
218
|
+
会删除:
|
|
219
|
+
- `~/.claude/commands/ccg/` 命令文件
|
|
220
|
+
- `~/.claude/agents/ccg/` 子智能体
|
|
221
|
+
- `~/.claude/bin/codeagent-wrapper` 二进制
|
|
222
|
+
- `~/.claude/.ccg/` 配置目录(可选保留)
|
|
243
223
|
|
|
244
|
-
|
|
245
|
-
/ccg:think "评估微服务拆分方案"
|
|
224
|
+
---
|
|
246
225
|
|
|
247
|
-
|
|
248
|
-
|
|
226
|
+
## 📚 命令参考
|
|
227
|
+
|
|
228
|
+
### 开发工作流命令
|
|
229
|
+
|
|
230
|
+
| 命令 | 用途 | 模型路由 |
|
|
231
|
+
|-----|------|---------|
|
|
232
|
+
| `/ccg:dev` | 完整6阶段开发工作流(Prompt增强+代码检索+分析+原型+实施+审计)| MCP + Codex + Gemini |
|
|
233
|
+
| `/ccg:code` | 智能代码生成(自动路由前端/后端)| 前端→Gemini / 后端→Codex |
|
|
234
|
+
| `/ccg:frontend` | 前端/UI/样式任务 | Gemini |
|
|
235
|
+
| `/ccg:backend` | 后端/逻辑/算法任务 | Codex |
|
|
236
|
+
| `/ccg:debug` | UltraThink 多模型调试(5阶段)| Codex + Gemini 并行 |
|
|
237
|
+
| `/ccg:test` | 多模型测试生成 | Codex + Gemini 并行 |
|
|
238
|
+
| `/ccg:bugfix` | 质量门控修复(90%+ 通过才算完成)| Codex + Gemini 交叉验证 |
|
|
239
|
+
| `/ccg:optimize` | 性能优化 | Codex + Gemini 并行 |
|
|
240
|
+
| `/ccg:review` | 代码审查(无参数自动审查 git diff)| Codex + Gemini 并行 |
|
|
241
|
+
| `/ccg:analyze` | 技术分析 | Codex + Gemini 并行 |
|
|
242
|
+
| `/ccg:think` | 深度分析 | Codex + Gemini 并行 |
|
|
243
|
+
| `/ccg:enhance` | Prompt 增强 | ace-tool MCP |
|
|
244
|
+
| `/ccg:scan` | 智能仓库扫描:生成项目上下文报告 | 分析项目结构 |
|
|
245
|
+
| `/ccg:feat` | 智能功能开发:规划 → 实施 → 审查全流程 | 多模型协作 |
|
|
249
246
|
|
|
250
|
-
|
|
251
|
-
/ccg:frontend "创建登录表单组件"
|
|
247
|
+
### Git 工具命令
|
|
252
248
|
|
|
253
|
-
|
|
254
|
-
|
|
249
|
+
| 命令 | 用途 |
|
|
250
|
+
|-----|------|
|
|
251
|
+
| `/ccg:commit` | 智能 commit:分析改动,生成 conventional commit 信息 |
|
|
252
|
+
| `/ccg:rollback` | 交互式回滚:列分支、列版本、二次确认 |
|
|
253
|
+
| `/ccg:clean-branches` | 分支清理:安全查找并清理已合并分支(支持 dry-run)|
|
|
254
|
+
| `/ccg:worktree` | Worktree 管理:在 `../.ccg/项目名/` 下创建 |
|
|
255
255
|
|
|
256
|
-
|
|
257
|
-
/ccg:review
|
|
256
|
+
### 项目初始化
|
|
258
257
|
|
|
259
|
-
|
|
260
|
-
|
|
258
|
+
| 命令 | 用途 |
|
|
259
|
+
|-----|------|
|
|
260
|
+
| `/ccg:init` | 初始化项目 AI 上下文,生成 CLAUDE.md 索引 |
|
|
261
261
|
|
|
262
|
-
|
|
263
|
-
/ccg:enhance "实现用户认证功能"
|
|
262
|
+
---
|
|
264
263
|
|
|
265
|
-
|
|
266
|
-
/ccg:commit --emoji
|
|
264
|
+
## 🔄 工作流详解
|
|
267
265
|
|
|
268
|
-
|
|
269
|
-
/ccg:rollback --branch main --target v1.0.0
|
|
266
|
+
### /ccg:dev - 完整6阶段开发工作流
|
|
270
267
|
|
|
271
|
-
|
|
272
|
-
|
|
268
|
+
```
|
|
269
|
+
┌─────────────────────────────────────────┐
|
|
270
|
+
│ Phase 0: Prompt 增强 (MCP) │
|
|
271
|
+
│ 优化用户输入,补充技术细节 │
|
|
272
|
+
└────────────────┬────────────────────────┘
|
|
273
|
+
↓
|
|
274
|
+
┌─────────────────────────────────────────┐
|
|
275
|
+
│ Phase 1: 代码检索 (MCP) │
|
|
276
|
+
│ 获取相关代码上下文 │
|
|
277
|
+
└────────────────┬────────────────────────┘
|
|
278
|
+
↓
|
|
279
|
+
┌─────────────────────────────────────────┐
|
|
280
|
+
│ Phase 2: 多模型分析 │
|
|
281
|
+
│ Codex (后端) ∥ Gemini (前端) 并行 │
|
|
282
|
+
│ 交叉验证技术方案 │
|
|
283
|
+
└────────────────┬────────────────────────┘
|
|
284
|
+
↓
|
|
285
|
+
┌─────────────────────────────────────────┐
|
|
286
|
+
│ Phase 3: 原型生成 │
|
|
287
|
+
│ 前端 → Gemini / 后端 → Codex │
|
|
288
|
+
│ 输出 Unified Diff Patch │
|
|
289
|
+
└────────────────┬────────────────────────┘
|
|
290
|
+
↓
|
|
291
|
+
┌─────────────────────────────────────────┐
|
|
292
|
+
│ Phase 4: 代码实施 (Claude 主导) │
|
|
293
|
+
│ 重构为生产级代码并应用 │
|
|
294
|
+
└────────────────┬────────────────────────┘
|
|
295
|
+
↓
|
|
296
|
+
┌─────────────────────────────────────────┐
|
|
297
|
+
│ Phase 5: 审计交付 │
|
|
298
|
+
│ Codex ∥ Gemini 交叉验证代码质量 │
|
|
299
|
+
└─────────────────────────────────────────┘
|
|
300
|
+
```
|
|
273
301
|
|
|
274
|
-
|
|
275
|
-
/ccg:worktree add feature-ui -o
|
|
302
|
+
### 使用示例
|
|
276
303
|
|
|
277
|
-
|
|
278
|
-
|
|
304
|
+
```bash
|
|
305
|
+
# 在 Claude Code 中执行
|
|
306
|
+
/ccg:dev 实现用户登录功能
|
|
307
|
+
|
|
308
|
+
# 系统会自动:
|
|
309
|
+
# 1. 增强 Prompt(补充技术细节、最佳实践)
|
|
310
|
+
# 2. 检索相关代码(认证模块、数据库模型)
|
|
311
|
+
# 3. 双模型分析(Codex 分析后端逻辑 ∥ Gemini 分析前端表单)
|
|
312
|
+
# 4. 生成原型(Codex 生成 API ∥ Gemini 生成登录表单)
|
|
313
|
+
# 5. Claude 重构并应用代码
|
|
314
|
+
# 6. 双模型审查(Codex 检查安全性 ∥ Gemini 检查 UI/UX)
|
|
279
315
|
```
|
|
280
316
|
|
|
281
317
|
---
|
|
282
318
|
|
|
283
|
-
##
|
|
284
|
-
|
|
285
|
-
### 开发工作流
|
|
286
|
-
|
|
287
|
-
| 命令 | 用途 | CLI 路由 |
|
|
288
|
-
|------|------|----------|
|
|
289
|
-
| `/ccg:dev` | 完整6阶段开发工作流(含Prompt增强) | ace-tool + Codex + Gemini + Claude |
|
|
290
|
-
| `/ccg:code` | 三 CLI 代码生成(智能路由) | 前端→Gemini / 后端→Codex / 整合→Claude |
|
|
291
|
-
| `/ccg:debug` | UltraThink 三 CLI 调试 | Codex + Gemini + Claude 并行诊断 |
|
|
292
|
-
| `/ccg:test` | 三 CLI 测试生成 | Codex 后端 + Gemini 前端 + Claude 集成 |
|
|
293
|
-
| `/ccg:bugfix` | 质量门控修复(90%+ 通过) | 三 CLI 交叉验证 |
|
|
294
|
-
| `/ccg:think` | 深度分析 | 三 CLI 并行分析 |
|
|
295
|
-
| `/ccg:optimize` | 性能优化 | Codex 后端 + Gemini 前端 + Claude 全栈 |
|
|
296
|
-
| `/ccg:frontend` | 前端/UI/样式任务 | Gemini + Claude 整合 |
|
|
297
|
-
| `/ccg:backend` | 后端/逻辑/算法任务 | Codex + Claude 整合 |
|
|
298
|
-
| `/ccg:review` | 代码审查(无参数自动审查 git diff) | Codex + Gemini + Claude |
|
|
299
|
-
| `/ccg:analyze` | 技术分析 | Codex + Gemini + Claude |
|
|
300
|
-
| `/ccg:enhance` | Prompt 增强 | ace-tool MCP |
|
|
319
|
+
## 🎭 专家角色系统
|
|
301
320
|
|
|
302
|
-
###
|
|
321
|
+
### 核心机制:ROLE_FILE 动态注入
|
|
303
322
|
|
|
304
|
-
|
|
305
|
-
|------|------|
|
|
306
|
-
| `/ccg:commit` | 智能 commit:分析改动、生成 conventional commit 信息、支持 emoji |
|
|
307
|
-
| `/ccg:rollback` | 交互式回滚:列分支、列版本、二次确认后执行 reset/revert |
|
|
308
|
-
| `/ccg:clean-branches` | 清理分支:安全查找并清理已合并或过期的分支 |
|
|
309
|
-
| `/ccg:worktree` | Worktree 管理:在 `../.ccg/项目名/` 下创建,支持 IDE 集成 |
|
|
323
|
+
18个专家提示词(Codex 6个 + Gemini 6个 + Claude 6个),采用 **零 token 消耗** 的 ROLE_FILE 动态注入机制:
|
|
310
324
|
|
|
311
|
-
|
|
325
|
+
- ✅ 每个命令自动注入对应角色提示词
|
|
326
|
+
- ✅ 不占用主会话 token
|
|
327
|
+
- ✅ 无需手动配置全局提示词
|
|
312
328
|
|
|
313
|
-
|
|
314
|
-
|------|------|
|
|
315
|
-
| `/ccg:init` | 初始化项目 AI 上下文,生成根级与模块级 CLAUDE.md 索引 |
|
|
329
|
+
### 角色映射表
|
|
316
330
|
|
|
317
|
-
|
|
331
|
+
| 命令 | Codex 角色 | Gemini 角色 | Claude 角色 |
|
|
332
|
+
|------|-----------|------------|------------|
|
|
333
|
+
| `/ccg:code`, `/ccg:backend` | architect.md(后端架构师)| - | - |
|
|
334
|
+
| `/ccg:frontend` | - | frontend.md(前端架构师)| - |
|
|
335
|
+
| `/ccg:analyze`, `/ccg:think` | analyzer.md | analyzer.md | analyzer.md |
|
|
336
|
+
| `/ccg:debug` | debugger.md | debugger.md | debugger.md |
|
|
337
|
+
| `/ccg:test` | tester.md | tester.md | tester.md |
|
|
338
|
+
| `/ccg:review`, `/ccg:bugfix` | reviewer.md | reviewer.md | reviewer.md |
|
|
339
|
+
| `/ccg:optimize` | optimizer.md | optimizer.md | optimizer.md |
|
|
340
|
+
|
|
341
|
+
### 提示词文件结构
|
|
318
342
|
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
│
|
|
324
|
-
|
|
325
|
-
│
|
|
326
|
-
│
|
|
327
|
-
│
|
|
328
|
-
|
|
329
|
-
│
|
|
330
|
-
│
|
|
331
|
-
│
|
|
332
|
-
│
|
|
333
|
-
│
|
|
334
|
-
│
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
343
|
+
```
|
|
344
|
+
~/.claude/.ccg/prompts/
|
|
345
|
+
├── codex/ # Codex CLI 后端专家(6个)
|
|
346
|
+
│ ├── architect.md # 后端架构师
|
|
347
|
+
│ ├── analyzer.md # 技术分析师
|
|
348
|
+
│ ├── debugger.md # 调试专家
|
|
349
|
+
│ ├── optimizer.md # 性能优化师
|
|
350
|
+
│ ├── reviewer.md # 代码审查员
|
|
351
|
+
│ └── tester.md # 测试工程师
|
|
352
|
+
├── gemini/ # Gemini CLI 前端专家(6个)
|
|
353
|
+
│ ├── frontend.md # 前端架构师
|
|
354
|
+
│ ├── analyzer.md # UI/UX 分析师
|
|
355
|
+
│ ├── debugger.md # 前端调试专家
|
|
356
|
+
│ ├── optimizer.md # 前端性能优化
|
|
357
|
+
│ ├── reviewer.md # 代码审查员
|
|
358
|
+
│ └── tester.md # 前端测试工程师
|
|
359
|
+
└── claude/ # Claude CLI 全栈专家(6个)
|
|
360
|
+
├── architect.md # 全栈架构师
|
|
361
|
+
├── analyzer.md # 系统分析师
|
|
362
|
+
├── debugger.md # 全栈调试专家
|
|
363
|
+
├── optimizer.md # 系统优化师
|
|
364
|
+
├── reviewer.md # 高级审查员
|
|
365
|
+
└── tester.md # 集成测试工程师
|
|
342
366
|
```
|
|
343
367
|
|
|
344
|
-
|
|
368
|
+
### 动态注入示例
|
|
345
369
|
|
|
346
|
-
|
|
370
|
+
```bash
|
|
371
|
+
codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
|
|
372
|
+
ROLE_FILE: ~/.claude/.ccg/prompts/codex/architect.md
|
|
347
373
|
|
|
348
|
-
|
|
374
|
+
<TASK>
|
|
375
|
+
实现后端逻辑: 用户登录 API
|
|
349
376
|
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
│ ├── frontend.md # /ccg:frontend 前端任务
|
|
357
|
-
│ ├── backend.md # /ccg:backend 后端任务
|
|
358
|
-
│ └── ... # 其他命令
|
|
359
|
-
└── prompts/ccg/ # 角色提示词
|
|
360
|
-
├── codex/
|
|
361
|
-
│ ├── architect.md # 后端架构师
|
|
362
|
-
│ ├── analyzer.md # 技术分析师
|
|
363
|
-
│ ├── debugger.md # 调试专家
|
|
364
|
-
│ ├── tester.md # 测试工程师
|
|
365
|
-
│ ├── reviewer.md # 代码审查员
|
|
366
|
-
│ └── optimizer.md # 性能优化专家
|
|
367
|
-
├── gemini/
|
|
368
|
-
│ ├── frontend.md # 前端开发专家
|
|
369
|
-
│ └── ...
|
|
370
|
-
└── claude/
|
|
371
|
-
└── ...
|
|
372
|
-
|
|
373
|
-
~/.ccg/
|
|
374
|
-
└── config.toml # CCG 配置文件
|
|
377
|
+
Context:
|
|
378
|
+
现有代码...
|
|
379
|
+
</TASK>
|
|
380
|
+
|
|
381
|
+
OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
|
|
382
|
+
EOF
|
|
375
383
|
```
|
|
376
384
|
|
|
377
385
|
---
|
|
378
386
|
|
|
379
|
-
## 配置文件
|
|
387
|
+
## ⚙️ 配置文件
|
|
380
388
|
|
|
381
|
-
配置文件位于 `~/.ccg/config.toml`:
|
|
389
|
+
配置文件位于 `~/.claude/.ccg/config.toml`:
|
|
382
390
|
|
|
383
391
|
```toml
|
|
384
392
|
[general]
|
|
385
|
-
version = "1.
|
|
393
|
+
version = "1.4.1"
|
|
386
394
|
language = "zh-CN"
|
|
387
395
|
|
|
388
396
|
[mcp]
|
|
@@ -394,7 +402,7 @@ setup_url = "https://linux.do/t/topic/1280612"
|
|
|
394
402
|
code_search_ace = "mcp__ace-tool__search_context"
|
|
395
403
|
code_search_auggie = "mcp__auggie-mcp__codebase-retrieval"
|
|
396
404
|
prompt_enhance_ace = "mcp__ace-tool__enhance_prompt"
|
|
397
|
-
prompt_enhance_auggie = "" #
|
|
405
|
+
prompt_enhance_auggie = "" # 留空表示未配置
|
|
398
406
|
|
|
399
407
|
# 参数名映射
|
|
400
408
|
query_param_ace = "query"
|
|
@@ -418,323 +426,331 @@ models = ["codex", "gemini", "claude"]
|
|
|
418
426
|
strategy = "parallel"
|
|
419
427
|
```
|
|
420
428
|
|
|
421
|
-
|
|
429
|
+
### 配置说明
|
|
430
|
+
|
|
431
|
+
| 配置项 | 说明 |
|
|
432
|
+
|-------|------|
|
|
433
|
+
| `mcp.provider` | MCP 工具提供商(ace-tool / auggie / none)|
|
|
434
|
+
| `routing.mode` | 路由模式(smart: 智能路由 / parallel: 并行 / sequential: 顺序)|
|
|
435
|
+
| `routing.frontend.models` | 前端任务使用的模型列表 |
|
|
436
|
+
| `routing.backend.models` | 后端任务使用的模型列表 |
|
|
437
|
+
| `routing.*.strategy` | 执行策略(parallel: 并行 / fallback: 回退)|
|
|
422
438
|
|
|
423
|
-
|
|
439
|
+
---
|
|
424
440
|
|
|
425
|
-
|
|
441
|
+
## 🗂️ 安装目录结构
|
|
426
442
|
|
|
427
|
-
|
|
428
|
-
# 运行 CCG 菜单
|
|
429
|
-
npx ccg-workflow
|
|
443
|
+
安装后的完整目录结构:
|
|
430
444
|
|
|
431
|
-
|
|
445
|
+
```
|
|
446
|
+
~/.claude/
|
|
447
|
+
├── commands/ccg/ # ✅ CC 读取的 slash commands
|
|
448
|
+
│ ├── dev.md
|
|
449
|
+
│ ├── code.md
|
|
450
|
+
│ ├── frontend.md
|
|
451
|
+
│ ├── backend.md
|
|
452
|
+
│ ├── debug.md
|
|
453
|
+
│ ├── test.md
|
|
454
|
+
│ ├── bugfix.md
|
|
455
|
+
│ ├── review.md
|
|
456
|
+
│ ├── optimize.md
|
|
457
|
+
│ ├── analyze.md
|
|
458
|
+
│ ├── think.md
|
|
459
|
+
│ ├── enhance.md
|
|
460
|
+
│ ├── scan.md
|
|
461
|
+
│ ├── feat.md
|
|
462
|
+
│ ├── commit.md
|
|
463
|
+
│ ├── rollback.md
|
|
464
|
+
│ ├── clean-branches.md
|
|
465
|
+
│ ├── worktree.md
|
|
466
|
+
│ └── init.md
|
|
467
|
+
├── agents/ccg/ # ✅ CC 读取的 subagents
|
|
468
|
+
│ ├── planner.md
|
|
469
|
+
│ ├── ui-ux-designer.md
|
|
470
|
+
│ ├── init-architect.md
|
|
471
|
+
│ └── get-current-datetime.md
|
|
472
|
+
├── bin/ # ✅ 二进制文件
|
|
473
|
+
│ └── codeagent-wrapper
|
|
474
|
+
└── .ccg/ # ✅ CCG 配置目录(CC 不读取)
|
|
475
|
+
├── config.toml # 主配置文件
|
|
476
|
+
├── shared-config.md # 共享配置
|
|
477
|
+
├── backup/ # 备份目录
|
|
478
|
+
└── prompts/ # 专家提示词
|
|
479
|
+
├── codex/
|
|
480
|
+
├── gemini/
|
|
481
|
+
└── claude/
|
|
432
482
|
```
|
|
433
483
|
|
|
434
|
-
|
|
435
|
-
1. 检查 npm 最新版本
|
|
436
|
-
2. 对比当前版本与最新版本
|
|
437
|
-
3. 更新所有命令模板(`~/.claude/commands/ccg/`)
|
|
438
|
-
4. 更新所有角色提示词(`~/.claude/prompts/ccg/`)
|
|
439
|
-
5. 保留用户配置(`~/.ccg/config.toml`)
|
|
484
|
+
---
|
|
440
485
|
|
|
441
|
-
|
|
486
|
+
## ❓ 常见问题
|
|
442
487
|
|
|
443
|
-
|
|
488
|
+
<details>
|
|
489
|
+
<summary><strong>Q1: 如何更新到最新版本?</strong></summary>
|
|
444
490
|
|
|
491
|
+
一键更新,无需卸载重装:
|
|
445
492
|
```bash
|
|
446
493
|
npx ccg-workflow
|
|
447
494
|
# 选择 "更新工作流"
|
|
448
|
-
# 当提示"已是最新版本"时
|
|
449
|
-
# 选择 Yes 进行强制重装
|
|
450
495
|
```
|
|
451
496
|
|
|
452
|
-
|
|
497
|
+
更新会自动:
|
|
498
|
+
- 检测 npm 最新版本
|
|
499
|
+
- 增量更新命令模板和提示词
|
|
500
|
+
- 保留用户配置和 MCP 设置
|
|
501
|
+
- 自动迁移旧版本目录结构(v1.3.x → v1.4.x)
|
|
502
|
+
</details>
|
|
453
503
|
|
|
454
|
-
|
|
504
|
+
<details>
|
|
505
|
+
<summary><strong>Q2: v1.4.0 目录迁移会影响我吗?</strong></summary>
|
|
455
506
|
|
|
456
|
-
|
|
457
|
-
# 交互式卸载
|
|
458
|
-
npx ccg-workflow
|
|
459
|
-
# 选择 "卸载 CCG"
|
|
460
|
-
```
|
|
507
|
+
**不会影响**,系统会自动迁移:
|
|
461
508
|
|
|
462
|
-
|
|
509
|
+
安装/更新时会自动:
|
|
510
|
+
1. 检测旧版本目录(`~/.ccg/`, `~/.claude/prompts/ccg/`)
|
|
511
|
+
2. 迁移所有文件到新位置(`~/.claude/.ccg/`)
|
|
512
|
+
3. 清理旧目录(安全检查后)
|
|
513
|
+
4. 显示迁移报告
|
|
463
514
|
|
|
515
|
+
手动迁移(如果需要):
|
|
464
516
|
```bash
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
517
|
+
# 旧版本 → 新版本
|
|
518
|
+
~/.ccg/ → ~/.claude/.ccg/
|
|
519
|
+
~/.claude/prompts/ccg/ → ~/.claude/.ccg/prompts/
|
|
520
|
+
~/.claude/commands/ccg/_config.md → ~/.claude/.ccg/shared-config.md
|
|
468
521
|
```
|
|
522
|
+
</details>
|
|
469
523
|
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
## 开发
|
|
473
|
-
|
|
474
|
-
```bash
|
|
475
|
-
# 克隆仓库
|
|
476
|
-
git clone https://github.com/fengshao1227/ccg-workflow.git
|
|
477
|
-
cd ccg-workflow/skills-v2
|
|
478
|
-
|
|
479
|
-
# 安装依赖
|
|
480
|
-
pnpm install
|
|
481
|
-
|
|
482
|
-
# 开发模式
|
|
483
|
-
pnpm dev
|
|
484
|
-
|
|
485
|
-
# 构建
|
|
486
|
-
pnpm build
|
|
524
|
+
<details>
|
|
525
|
+
<summary><strong>Q3: MCP 动态选择系统是什么?</strong></summary>
|
|
487
526
|
|
|
488
|
-
|
|
489
|
-
|
|
527
|
+
v1.3.0 核心特性,安装时可以选择:
|
|
528
|
+
- **ace-tool**(第三方):开箱即用,包含 Prompt 增强 + 代码检索
|
|
529
|
+
- **auggie**(官方):代码检索 + 可选 Prompt 增强(需配置)
|
|
490
530
|
|
|
491
|
-
|
|
492
|
-
pnpm typecheck
|
|
531
|
+
命令模板会根据配置自动适配对应的 MCP 工具调用。
|
|
493
532
|
|
|
494
|
-
|
|
495
|
-
|
|
533
|
+
切换方法:编辑 `~/.claude/.ccg/config.toml`:
|
|
534
|
+
```toml
|
|
535
|
+
[mcp]
|
|
536
|
+
provider = "ace-tool" # 或 "auggie"
|
|
496
537
|
```
|
|
538
|
+
</details>
|
|
497
539
|
|
|
498
|
-
|
|
540
|
+
<details>
|
|
541
|
+
<summary><strong>Q4: codeagent-wrapper 是什么?</strong></summary>
|
|
499
542
|
|
|
500
|
-
|
|
543
|
+
来自 [cexll/myclaude](https://github.com/cexll/myclaude) 的 Go 工具,封装了多 CLI 调用:
|
|
544
|
+
- 支持 `--backend codex/gemini/claude` 切换
|
|
545
|
+
- 会话管理(SESSION_ID)
|
|
546
|
+
- ROLE_FILE 动态注入
|
|
547
|
+
- 自动安装到 `~/.claude/bin/`
|
|
501
548
|
|
|
502
|
-
|
|
549
|
+
调用语法:
|
|
503
550
|
```bash
|
|
504
551
|
codeagent-wrapper --backend <codex|gemini|claude> - [工作目录] <<'EOF'
|
|
505
552
|
<任务内容>
|
|
506
553
|
EOF
|
|
507
554
|
```
|
|
555
|
+
</details>
|
|
508
556
|
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
codeagent-wrapper --backend codex "简单任务" [工作目录]
|
|
512
|
-
```
|
|
513
|
-
|
|
514
|
-
**恢复会话**:
|
|
515
|
-
```bash
|
|
516
|
-
codeagent-wrapper --backend codex resume <session_id> - <<'EOF'
|
|
517
|
-
<后续任务>
|
|
518
|
-
EOF
|
|
519
|
-
```
|
|
520
|
-
|
|
521
|
-
---
|
|
522
|
-
|
|
523
|
-
## 并行执行
|
|
524
|
-
|
|
525
|
-
使用 Claude Code 的 `run_in_background: true` 参数实现非阻塞并行:
|
|
557
|
+
<details>
|
|
558
|
+
<summary><strong>Q5: 如何切换 MCP 工具(ace-tool ↔ auggie)?</strong></summary>
|
|
526
559
|
|
|
527
|
-
|
|
528
|
-
# 启动后台任务(非阻塞)
|
|
529
|
-
Bash(run_in_background=true): codeagent-wrapper --backend codex ...
|
|
530
|
-
Bash(run_in_background=true): codeagent-wrapper --backend gemini ...
|
|
560
|
+
手动编辑配置文件 `~/.claude/.ccg/config.toml`:
|
|
531
561
|
|
|
532
|
-
|
|
533
|
-
|
|
562
|
+
```toml
|
|
563
|
+
[mcp]
|
|
564
|
+
provider = "ace-tool" # 或 "auggie"
|
|
534
565
|
```
|
|
535
566
|
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
## 安全机制
|
|
539
|
-
|
|
540
|
-
- **零写入权限**:Codex/Gemini 对文件系统无写入权限
|
|
541
|
-
- **Unified Diff**:所有外部模型输出必须为 Unified Diff Patch 格式
|
|
542
|
-
- **脏原型处理**:外部模型输出视为"脏原型",需经 Claude 重构
|
|
543
|
-
- **自动备份**:Patch Auggie MCP 时自动备份原文件
|
|
567
|
+
然后重新运行 `/ccg:dev` 等命令即可。
|
|
568
|
+
</details>
|
|
544
569
|
|
|
545
|
-
|
|
570
|
+
<details>
|
|
571
|
+
<summary><strong>Q6: ROLE_FILE 动态注入如何工作?</strong></summary>
|
|
546
572
|
|
|
547
|
-
|
|
573
|
+
`codeagent-wrapper` 会自动识别命令中的 `ROLE_FILE:` 指令:
|
|
548
574
|
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
| **Gemini CLI** | 前端、UI/UX、视觉设计 | CSS、React、Vue 组件原型 |
|
|
553
|
-
| **Codex CLI** | 后端、算法、调试 | API、业务逻辑、性能优化原型 |
|
|
554
|
-
| **Claude CLI** | 全栈整合、交叉验证 | 契约设计、原型整合 |
|
|
555
|
-
| **ace-tool** | 代码检索、Prompt 增强 | 上下文获取、需求优化 |
|
|
575
|
+
```bash
|
|
576
|
+
ROLE_FILE: ~/.claude/.ccg/prompts/codex/architect.md
|
|
577
|
+
```
|
|
556
578
|
|
|
557
|
-
|
|
579
|
+
工具会读取文件内容并注入到外部 CLI(Codex/Gemini)的系统提示词中,零 token 消耗。
|
|
580
|
+
</details>
|
|
558
581
|
|
|
559
|
-
|
|
582
|
+
<details>
|
|
583
|
+
<summary><strong>Q7: 为什么需要 Codex CLI / Gemini CLI?</strong></summary>
|
|
560
584
|
|
|
561
|
-
|
|
585
|
+
**核心理念**:让 Claude 专注于编排决策,把具体代码生成交给专业模型。
|
|
562
586
|
|
|
563
|
-
|
|
587
|
+
- **Codex**:后端逻辑、算法、调试能力强
|
|
588
|
+
- **Gemini**:前端 UI、组件、样式能力强
|
|
589
|
+
- **Claude**:全栈整合、质量把控、编排能力强
|
|
564
590
|
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
- `prompts/codex/analyzer.md` - 技术分析师
|
|
568
|
-
- `prompts/codex/debugger.md` - 调试专家
|
|
569
|
-
- `prompts/codex/tester.md` - 测试工程师
|
|
570
|
-
- `prompts/codex/reviewer.md` - 代码审查员
|
|
571
|
-
- `prompts/codex/optimizer.md` - 性能优化专家
|
|
591
|
+
如果只有 Claude Code,系统会降级为纯 Claude 工作流。
|
|
592
|
+
</details>
|
|
572
593
|
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
- `prompts/gemini/analyzer.md` - 设计分析师
|
|
576
|
-
- `prompts/gemini/debugger.md` - UI调试专家
|
|
577
|
-
- `prompts/gemini/tester.md` - 前端测试工程师
|
|
578
|
-
- `prompts/gemini/reviewer.md` - UI审查员
|
|
579
|
-
- `prompts/gemini/optimizer.md` - 前端性能优化专家
|
|
594
|
+
<details>
|
|
595
|
+
<summary><strong>Q8: Codex 总是思考太久超时该怎么办?</strong></summary>
|
|
580
596
|
|
|
581
|
-
|
|
582
|
-
- `prompts/claude/architect.md` - 全栈架构师
|
|
583
|
-
- `prompts/claude/analyzer.md` - 综合分析师
|
|
584
|
-
- `prompts/claude/debugger.md` - 全栈调试专家
|
|
585
|
-
- `prompts/claude/tester.md` - 集成测试工程师
|
|
586
|
-
- `prompts/claude/reviewer.md` - 代码质量审查员
|
|
587
|
-
- `prompts/claude/optimizer.md` - 全栈性能优化专家
|
|
597
|
+
**问题描述**:使用 `/ccg:dev` 等命令时,Codex 后端思考时间过长,导致超时。
|
|
588
598
|
|
|
589
|
-
|
|
599
|
+
**解决方案**:
|
|
600
|
+
- 参考社区讨论:[linux.do - Codex 超时问题](https://linux.do/t/topic/1405588/256?u=feng_li)
|
|
590
601
|
|
|
591
|
-
|
|
602
|
+
**常见优化方法**:
|
|
603
|
+
- 减少任务复杂度,拆分为更小的子任务
|
|
604
|
+
- 调整 Codex CLI 的超时配置
|
|
605
|
+
- 使用 `--backend gemini` 切换到 Gemini 后端测试
|
|
606
|
+
</details>
|
|
592
607
|
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
| `/ccg:code`, `/ccg:backend` | `architect.md` | - | `architect.md` |
|
|
596
|
-
| `/ccg:frontend` | - | `frontend.md` | `architect.md` |
|
|
597
|
-
| `/ccg:analyze`, `/ccg:think`, `/ccg:dev` | `analyzer.md` | `analyzer.md` | `analyzer.md` |
|
|
598
|
-
| `/ccg:debug` | `debugger.md` | `debugger.md` | `debugger.md` |
|
|
599
|
-
| `/ccg:test` | `tester.md` | `tester.md` | `tester.md` |
|
|
600
|
-
| `/ccg:review`, `/ccg:bugfix` | `reviewer.md` | `reviewer.md` | `reviewer.md` |
|
|
601
|
-
| `/ccg:optimize` | `optimizer.md` | `optimizer.md` | `optimizer.md` |
|
|
608
|
+
<details>
|
|
609
|
+
<summary><strong>Q9: 安装后提示 "codeagent-wrapper: command not found"?</strong></summary>
|
|
602
610
|
|
|
603
|
-
|
|
611
|
+
**原因**:PATH 未生效。
|
|
604
612
|
|
|
605
|
-
|
|
613
|
+
**解决方案**:
|
|
606
614
|
|
|
615
|
+
Mac/Linux:
|
|
607
616
|
```bash
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
#
|
|
611
|
-
|
|
617
|
+
# 重启终端或执行
|
|
618
|
+
source ~/.zshrc
|
|
619
|
+
# 或
|
|
620
|
+
source ~/.bashrc
|
|
621
|
+
```
|
|
612
622
|
|
|
613
|
-
|
|
614
|
-
|
|
623
|
+
Windows:
|
|
624
|
+
```powershell
|
|
625
|
+
# 重新打开 PowerShell
|
|
626
|
+
# 或手动添加到环境变量:
|
|
627
|
+
# %USERPROFILE%\.claude\bin
|
|
628
|
+
```
|
|
629
|
+
</details>
|
|
615
630
|
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
</TASK>
|
|
631
|
+
<details>
|
|
632
|
+
<summary><strong>Q10: 如何卸载 CCG 系统?</strong></summary>
|
|
619
633
|
|
|
620
|
-
|
|
621
|
-
|
|
634
|
+
```bash
|
|
635
|
+
npx ccg-workflow
|
|
636
|
+
# 选择 "卸载工作流"
|
|
622
637
|
```
|
|
623
638
|
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
-
|
|
627
|
-
-
|
|
628
|
-
-
|
|
639
|
+
卸载会:
|
|
640
|
+
- 删除 `~/.claude/commands/ccg/` 命令文件
|
|
641
|
+
- 删除 `~/.claude/agents/ccg/` 子智能体
|
|
642
|
+
- 删除 `~/.claude/bin/codeagent-wrapper` 二进制
|
|
643
|
+
- 删除 `~/.claude/.ccg/` 配置目录(可选保留)
|
|
644
|
+
</details>
|
|
629
645
|
|
|
630
|
-
|
|
646
|
+
<details>
|
|
647
|
+
<summary><strong>Q11: auggie 如何配置 Prompt 增强功能?</strong></summary>
|
|
631
648
|
|
|
632
|
-
|
|
649
|
+
auggie 默认只有代码检索功能,要启用 Prompt 增强需要额外配置:
|
|
633
650
|
|
|
634
|
-
|
|
635
|
-
<summary><strong>Q: Codex API 返回 403 "Client not allowed" 错误</strong></summary>
|
|
651
|
+
参考教程:[linux.do - auggie Prompt 增强配置](https://linux.do/t/topic/1280612)
|
|
636
652
|
|
|
637
|
-
|
|
638
|
-
```
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
"message": "Your client is not authorized to use this API key"
|
|
642
|
-
}
|
|
653
|
+
配置完成后,编辑 `~/.claude/.ccg/config.toml`:
|
|
654
|
+
```toml
|
|
655
|
+
[mcp.tools]
|
|
656
|
+
prompt_enhance_auggie = "mcp__auggie__enhance_prompt" # 填入配置的工具名
|
|
643
657
|
```
|
|
658
|
+
</details>
|
|
659
|
+
|
|
660
|
+
---
|
|
644
661
|
|
|
645
|
-
|
|
662
|
+
## 🛠️ 开发指南
|
|
646
663
|
|
|
647
|
-
|
|
664
|
+
### 本地开发
|
|
648
665
|
|
|
649
|
-
设置环境变量来禁用该参数:
|
|
650
666
|
```bash
|
|
651
|
-
#
|
|
652
|
-
|
|
653
|
-
/
|
|
667
|
+
# 克隆仓库
|
|
668
|
+
git clone https://github.com/fengshao1227/ccg-workflow.git
|
|
669
|
+
cd ccg-workflow/skills-v2
|
|
654
670
|
|
|
655
|
-
#
|
|
656
|
-
|
|
657
|
-
source ~/.zshrc
|
|
658
|
-
```
|
|
671
|
+
# 安装依赖
|
|
672
|
+
pnpm install
|
|
659
673
|
|
|
660
|
-
|
|
674
|
+
# 开发模式
|
|
675
|
+
pnpm dev
|
|
661
676
|
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
# 重新登录 Codex
|
|
665
|
-
codex logout
|
|
666
|
-
codex login
|
|
677
|
+
# 构建
|
|
678
|
+
pnpm build
|
|
667
679
|
|
|
668
|
-
#
|
|
669
|
-
|
|
670
|
-
```
|
|
680
|
+
# 本地测试
|
|
681
|
+
pnpm start
|
|
671
682
|
|
|
672
|
-
|
|
683
|
+
# 类型检查
|
|
684
|
+
pnpm typecheck
|
|
673
685
|
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
pip install --upgrade codex-cli
|
|
677
|
-
# 或
|
|
678
|
-
npm install -g @codex/cli
|
|
686
|
+
# 代码检查
|
|
687
|
+
pnpm lint
|
|
679
688
|
```
|
|
680
|
-
</details>
|
|
681
689
|
|
|
682
|
-
|
|
683
|
-
<summary><strong>Q: codex 总是思考太久超时该怎么办?</strong></summary>
|
|
690
|
+
### 项目结构
|
|
684
691
|
|
|
685
|
-
|
|
692
|
+
```
|
|
693
|
+
skills-v2/
|
|
694
|
+
├── src/ # TypeScript 源码
|
|
695
|
+
│ ├── commands/ # CLI 命令
|
|
696
|
+
│ │ ├── init.ts # 初始化命令
|
|
697
|
+
│ │ ├── menu.ts # 主菜单
|
|
698
|
+
│ │ └── update.ts # 更新命令
|
|
699
|
+
│ ├── utils/ # 工具函数
|
|
700
|
+
│ │ ├── installer.ts # 安装器
|
|
701
|
+
│ │ ├── migration.ts # 迁移脚本
|
|
702
|
+
│ │ ├── config.ts # 配置管理
|
|
703
|
+
│ │ └── version.ts # 版本管理
|
|
704
|
+
│ ├── i18n/ # 国际化
|
|
705
|
+
│ ├── types.ts # TypeScript 类型
|
|
706
|
+
│ ├── cli.ts # CLI 入口
|
|
707
|
+
│ └── index.ts # 导出
|
|
708
|
+
├── templates/ # 安装模板
|
|
709
|
+
│ ├── commands/ # 命令模板
|
|
710
|
+
│ ├── config/ # 配置模板
|
|
711
|
+
│ └── prompts/ # 提示词模板
|
|
712
|
+
├── bin/ # 预编译二进制
|
|
713
|
+
│ └── codeagent-wrapper-*
|
|
714
|
+
├── dist/ # 构建输出
|
|
715
|
+
├── package.json
|
|
716
|
+
└── README.md
|
|
717
|
+
```
|
|
686
718
|
|
|
687
|
-
|
|
688
|
-
- 参考社区讨论:[linux.do - Codex 超时问题解决方案](https://linux.do/t/topic/1405588/256?u=feng_li)
|
|
719
|
+
### 发布流程
|
|
689
720
|
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
- 使用 `--backend gemini` 切换到 Gemini 后端测试
|
|
694
|
-
</details>
|
|
721
|
+
```bash
|
|
722
|
+
# 1. 更新版本号(package.json)
|
|
723
|
+
# "version": "1.4.x" → "1.4.y"
|
|
695
724
|
|
|
696
|
-
|
|
697
|
-
|
|
725
|
+
# 2. 构建并发布
|
|
726
|
+
pnpm build
|
|
727
|
+
npm publish
|
|
698
728
|
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
729
|
+
# 3. 提交到 Git
|
|
730
|
+
git add -A
|
|
731
|
+
git commit -m "chore: bump version to x.y.z"
|
|
732
|
+
git push origin main
|
|
703
733
|
```
|
|
704
734
|
|
|
705
|
-
|
|
706
|
-
- 检测 npm 最新版本
|
|
707
|
-
- 增量更新命令模板和提示词
|
|
708
|
-
- 保留用户配置和 MCP 设置
|
|
709
|
-
</details>
|
|
710
|
-
|
|
711
|
-
<details>
|
|
712
|
-
<summary><strong>Q: MCP 动态选择系统是什么?</strong></summary>
|
|
735
|
+
---
|
|
713
736
|
|
|
714
|
-
|
|
715
|
-
- **ace-tool**(第三方):开箱即用,包含 Prompt 增强 + 代码检索
|
|
716
|
-
- **auggie**(官方):代码检索 + 可选 Prompt 增强(需配置)
|
|
737
|
+
## 🙏 致谢
|
|
717
738
|
|
|
718
|
-
|
|
719
|
-
</details>
|
|
739
|
+
感谢以下开源项目的贡献:
|
|
720
740
|
|
|
721
|
-
|
|
722
|
-
|
|
741
|
+
- **[cexll/myclaude](https://github.com/cexll/myclaude)** - `codeagent-wrapper` 多后端调用工具的 Go 代码来源,以及 `/ccg:code`、`/ccg:debug`、`/ccg:test`、`/ccg:bugfix`、`/ccg:think`、`/ccg:optimize` 命令的设计参考
|
|
742
|
+
- **[UfoMiao/zcf](https://github.com/UfoMiao/zcf)** - Git 工具(commit、rollback、clean-branches、worktree)和项目初始化(init)命令来源
|
|
743
|
+
- **[GudaStudio/skills](https://github.com/GuDaStudio/skills)** - 智能路由(前端→Gemini、后端→Codex)的设计理念
|
|
744
|
+
- **[ace-tool MCP](https://linux.do/t/topic/1344562)** - [@mistripple](https://linux.do/u/mistripple) 的轻量级代码检索和 Prompt 增强方案
|
|
745
|
+
- **[linux.do 社区](https://linux.do/)** - 活跃的 Claude Code 中文社区
|
|
723
746
|
|
|
724
|
-
|
|
725
|
-
- 支持 `--backend codex/gemini/claude` 切换
|
|
726
|
-
- 会话管理(SESSION_ID)
|
|
727
|
-
- ROLE_FILE 动态注入
|
|
728
|
-
- 自动安装到 `~/.claude/bin/`
|
|
729
|
-
</details>
|
|
747
|
+
---
|
|
730
748
|
|
|
731
|
-
|
|
732
|
-
<summary><strong>更多问题?</strong></summary>
|
|
749
|
+
## 💬 支持与反馈
|
|
733
750
|
|
|
734
|
-
|
|
735
|
-
- [linux.do
|
|
736
|
-
- [
|
|
737
|
-
</details>
|
|
751
|
+
- **GitHub Issues**: [提交问题](https://github.com/fengshao1227/ccg-workflow/issues)
|
|
752
|
+
- **讨论社区**: [linux.do - CCG 讨论帖](https://linux.do/t/topic/1405588)
|
|
753
|
+
- **完整文档**: [README.md](https://github.com/fengshao1227/ccg-workflow/blob/main/README.md)
|
|
738
754
|
|
|
739
755
|
---
|
|
740
756
|
|
|
@@ -746,9 +762,10 @@ Copyright (c) 2025 fengshao1227
|
|
|
746
762
|
|
|
747
763
|
---
|
|
748
764
|
|
|
749
|
-
|
|
765
|
+
<div align="center">
|
|
750
766
|
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
767
|
+
**最后更新**: 2026-01-06 | **版本**: v1.4.1
|
|
768
|
+
|
|
769
|
+
Made with ❤️ by the CCG Community
|
|
770
|
+
|
|
771
|
+
</div>
|