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 CHANGED
@@ -1,157 +1,131 @@
1
- # 【开源缝合】CCG: Claude Code 编排三 CLI 协作
1
+ # CCG - Claude + Codex + Gemini 多模型协作系统
2
2
 
3
3
  <div align="center">
4
4
 
5
- **Claude Code 主导 + Codex CLI + Gemini CLI + Claude CLI 协作工作流系统**
5
+ **Claude Code 编排 Codex + Gemini 双模型协作的智能开发工作流系统**
6
6
 
7
- [![npm version](https://img.shields.io/npm/v/ccg-workflow.svg)](https://www.npmjs.com/package/ccg-workflow) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-green.svg)](https://claude.ai/code) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-Supported-orange.svg)](https://github.com/openai/openai-python) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Supported-purple.svg)](https://ai.google.dev/)
7
+ [![npm version](https://img.shields.io/npm/v/ccg-workflow.svg)](https://www.npmjs.com/package/ccg-workflow)
8
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
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/)
8
12
 
9
- > **最新版本 v1.3.6**:修复 Codex API 客户端认证问题
13
+ > **最新版本 v1.4.2** - Windows MCP 配置自动修复 + 诊断工具
14
+
15
+ [快速开始](#-快速开始) • [命令参考](#-命令参考) • [常见问题](#-常见问题) • [更新日志](CHANGELOG.md)
10
16
 
11
17
  </div>
12
18
 
13
19
  ---
14
20
 
15
- ## 🎉 最新更新
16
-
17
- ### v1.3.6 - Codex API 认证修复 🔧
18
- - ✅ **环境变量开关**:新增 `CODEX_DISABLE_SKIP_GIT_CHECK` 环境变量
19
- - ✅ **认证兼容**:修复部分用户 Codex API 返回 403 "Client not allowed" 错误
20
- - ✅ **灵活配置**:保持默认行为,允许用户按需禁用 `--skip-git-repo-check`
21
- - ✅ **故障排除**:README 添加完整的 Codex 认证问题解决方案
22
-
23
- ### v1.3.5 - MCP 工具选择功能 🎯
24
- - ✅ **交互式选择**:新增 MCP 工具选择菜单(ace-tool / auggie / 跳过)
25
- - ✅ **ace-tool**:推荐选项,开箱即用含 Prompt 增强 + 代码检索
26
- - ✅ **auggie**:官方版本,代码检索 + 可选 Prompt 增强(提示配置教程)
27
- - ✅ **灵活配置**:允许跳过 MCP 配置,稍后手动配置
28
- - ✅ **智能保存**:用户选择自动保存到 `~/.ccg/config.toml`
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
- <details>
75
- <summary>查看历史版本 (v1.0.0 - v1.2.3)</summary>
36
+ ---
76
37
 
77
- ### v1.2.3 - 安装体验优化
78
- - 安装后自动验证 `codeagent-wrapper` 可用性
79
- - 安装失败时显示详细错误信息和解决方案
38
+ ## 💡 核心理念
80
39
 
81
- ### v1.2.0 - ROLE_FILE 动态注入
82
- - `codeagent-wrapper` 自动识别 `ROLE_FILE:` 指令
83
- - 专家提示词零 token 消耗,不占用主会话
40
+ CCG = **Claude Code** (主导编排) + **Codex CLI** (后端原型) + **Gemini CLI** (前端原型)
84
41
 
85
- ### v1.1.3 - PATH 自动配置
86
- - Mac/Linux 自动添加到 shell 配置文件
87
- - Windows 提供 PowerShell 一键命令
42
+ ### 设计哲学
88
43
 
89
- ### v1.1.0 - 智能更新系统
90
- - 一键更新,无需卸载重装
91
- - 保留用户配置和 MCP 设置
44
+ Claude Code 专注于编排决策和代码实施,把具体的代码生成交给专业模型:
45
+ - **前端任务** → Gemini(视觉设计、组件原型)
46
+ - **后端任务** Codex(逻辑运算、算法调试)
47
+ - **全栈整合** → Claude(工作流控制、代码主权)
92
48
 
93
- ### v1.0.0 - npm 首次发布
94
- - `npx ccg-workflow` 一键安装
95
- - 三模型协作(Claude + Codex + Gemini)
96
- - 18 个专家提示词
49
+ ### 核心优势
97
50
 
98
- **完整变更记录**: [CHANGELOG.md](https://github.com/fengshao1227/ccg-workflow/blob/main/CHANGELOG.md)
99
-
100
- </details>
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
- Claude Code CLI (主导)
111
- 编排、决策、代码实施
112
- ├─────────────────────────────────────────────────────────────┤
113
-
114
- │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
115
- Codex CLI │ │ Gemini CLI │ │ Claude CLI │ │
116
- │ │ (后端原型) │ │ (前端原型) │ │ (全栈整合) │ │
117
- └─────────────┘ └─────────────┘ └─────────────┘ │
118
-
119
- 通过 codeagent-wrapper 调用,返回 Unified Diff Patch
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
- - **Claude Code** 是主对话,负责编排整个工作流、做最终决策、实施代码
126
- - **Codex/Gemini/Claude 子进程** 通过 `codeagent-wrapper` 调用,生成原型代码
127
- - **零写入权限**:子进程只能返回 Unified Diff Patch,不能直接修改文件
128
- - **脏原型处理**:子进程输出视为"脏原型",需经 Claude Code 重构为生产级代码
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
- | **Claude Code 主导** | Claude Code CLI 作为编排者,Codex/Gemini/Claude 子进程协作 |
137
- | **三 CLI 协作** | 同时调用 Codex CLI + Gemini CLI + Claude CLI 进行交叉验证 |
138
- | **智能路由** | 前端任务 Gemini,后端任务 → Codex,全栈整合 → Claude |
139
- | **MCP 动态选择** | 安装时可选 ace-tool / auggie,命令模板自动适配,支持 Prompt 增强(ace-tool)或纯代码检索(auggie) |
140
- | **6阶段工作流** | Prompt增强 上下文检索 CLI 分析 原型生成 → 代码实施 → 审计交付 |
141
- | **18个专家提示词** | Codex 6个 + Gemini 6个 + Claude 6个角色 |
142
- | **交互式安装** | npx 一键运行,图形化配置界面 |
143
- | **跨平台** | 支持 macOS、Linux、Windows |
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
- - Node.js 18+
176
- - Claude Code CLI
177
- - Codex CLI / Gemini CLI(可选,用于多模型协作)
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
- 1. 选择语言(中文/English)
201
- 2. **选择 MCP 代码检索工具**:✨ NEW
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. 配置前端模型(Gemini/Codex/Claude
206
- 4. 配置后端模型(Codex/Gemini/Claude)
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
- # 完整的多模型开发工作流(含 Prompt 增强)
230
- /ccg:dev "实现用户认证功能"
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
- # 质量门控修复(90%+ 通过)
242
- /ccg:bugfix "密码重置邮件发送失败"
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
- /ccg:optimize "优化首页加载速度"
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
- # 前端任务 → Gemini
251
- /ccg:frontend "创建登录表单组件"
247
+ ### Git 工具命令
252
248
 
253
- # 后端任务 Codex
254
- /ccg:backend "实现 JWT 认证中间件"
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
- # 双模型代码审查(无参数自动审查 git diff)
257
- /ccg:review
256
+ ### 项目初始化
258
257
 
259
- # 双模型分析
260
- /ccg:analyze "这个架构有什么问题?"
258
+ | 命令 | 用途 |
259
+ |-----|------|
260
+ | `/ccg:init` | 初始化项目 AI 上下文,生成 CLAUDE.md 索引 |
261
261
 
262
- # 单独使用 Prompt 增强
263
- /ccg:enhance "实现用户认证功能"
262
+ ---
264
263
 
265
- # Git 智能提交
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
- /ccg:clean-branches --dry-run
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
- # 创建 Worktree 并用 IDE 打开
275
- /ccg:worktree add feature-ui -o
302
+ ### 使用示例
276
303
 
277
- # 初始化项目 AI 上下文
278
- /ccg:init "我的项目"
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
- ### Git 工具
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
- /ccg:dev 工作流 │
324
- ├─────────────────────────────────────────────────────────────┤
325
-
326
- Phase 0: Prompt 增强 (ace-tool prompt-enhancer) │
327
- ↓ │
328
- │ Phase 1: 上下文检索 (ace-tool codebase-retrieval) │
329
- ↓ │
330
- Phase 2: CLI 分析 (Codex ∥ Gemini ∥ Claude) ← 并行 │
331
- ↓ │
332
- Phase 3: 三 CLI 原型生成 │
333
- ├── 前端任务 → Gemini CLI │
334
- ├── 后端任务 → Codex CLI │
335
- └── 全栈整合 Claude CLI
336
- │ ↓ │
337
- │ Phase 4: 代码实施 (Claude Code 交叉验证后重构) │
338
- │ ↓ │
339
- │ Phase 5: 审计交付 (Codex ∥ Gemini ∥ Claude) ← 并行审查 │
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
- 安装后会在 `~/.claude/` 和 `~/.ccg/` 下创建:
374
+ <TASK>
375
+ 实现后端逻辑: 用户登录 API
349
376
 
350
- ```
351
- ~/.claude/
352
- ├── commands/ccg/ # 斜杠命令
353
- │ ├── _config.md # 共享配置
354
- │ ├── dev.md # /ccg:dev 完整工作流
355
- │ ├── code.md # /ccg:code 多模型代码生成
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.3.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
- ```bash
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
- ```bash
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
- rm -rf ~/.claude/commands/ccg
466
- rm -rf ~/.claude/prompts/ccg
467
- rm -rf ~/.ccg
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
- pnpm start
527
+ v1.3.0 核心特性,安装时可以选择:
528
+ - **ace-tool**(第三方):开箱即用,包含 Prompt 增强 + 代码检索
529
+ - **auggie**(官方):代码检索 + 可选 Prompt 增强(需配置)
490
530
 
491
- # 类型检查
492
- pnpm typecheck
531
+ 命令模板会根据配置自动适配对应的 MCP 工具调用。
493
532
 
494
- # 代码检查
495
- pnpm lint
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
- **HEREDOC 语法(推荐)**:
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
- ```bash
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
- TaskOutput: task_id=<task_id>
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
- ## CLI 分工
573
+ `codeagent-wrapper` 会自动识别命令中的 `ROLE_FILE:` 指令:
548
574
 
549
- | CLI | 擅长领域 | 使用场景 |
550
- |------|----------|----------|
551
- | **Claude Code** | 编排、决策、代码实施 | 工作流控制、最终代码重构、交付 |
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
- 调用外部 CLI 时动态注入相应的角色设定,确保输出质量和一致性。
585
+ **核心理念**:让 Claude 专注于编排决策,把具体代码生成交给专业模型。
562
586
 
563
- ### 18个角色文件
587
+ - **Codex**:后端逻辑、算法、调试能力强
588
+ - **Gemini**:前端 UI、组件、样式能力强
589
+ - **Claude**:全栈整合、质量把控、编排能力强
564
590
 
565
- **Codex CLI 角色**(6个):
566
- - `prompts/codex/architect.md` - 后端架构师
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
- **Gemini CLI 角色**(6个):
574
- - `prompts/gemini/frontend.md` - 前端开发专家
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
- **Claude CLI 角色**(6个):
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
- | 命令 | Codex 角色 | Gemini 角色 | Claude 角色 |
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
- 命令执行时,将角色文件内容注入到 `<ROLE>` 标签中:
613
+ **解决方案**:
606
614
 
615
+ Mac/Linux:
607
616
  ```bash
608
- codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
609
- <ROLE>
610
- # 读取 prompts/codex/architect.md 的内容并注入
611
- </ROLE>
617
+ # 重启终端或执行
618
+ source ~/.zshrc
619
+ #
620
+ source ~/.bashrc
621
+ ```
612
622
 
613
- <TASK>
614
- 实现后端逻辑: <任务描述>
623
+ Windows:
624
+ ```powershell
625
+ # 重新打开 PowerShell
626
+ # 或手动添加到环境变量:
627
+ # %USERPROFILE%\.claude\bin
628
+ ```
629
+ </details>
615
630
 
616
- Context:
617
- <相关代码>
618
- </TASK>
631
+ <details>
632
+ <summary><strong>Q10: 如何卸载 CCG 系统?</strong></summary>
619
633
 
620
- OUTPUT: Unified Diff Patch ONLY.
621
- EOF
634
+ ```bash
635
+ npx ccg-workflow
636
+ # 选择 "卸载工作流"
622
637
  ```
623
638
 
624
- ### 完整提示词文件
625
-
626
- - **Codex CLI 角色**: `prompts/codex/` 目录下的 6 个文件
627
- - **Gemini CLI 角色**: `prompts/gemini/` 目录下的 6 个文件
628
- - **Claude CLI 角色**: `prompts/claude/` 目录下的 6 个文件
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
- <details>
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
- ```json
639
- {
640
- "error": "Client not allowed",
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
- **原因**:Codex API 对客户端验证有严格限制,`--skip-git-repo-check` 参数可能触发不同的认证逻辑。
662
+ ## 🛠️ 开发指南
646
663
 
647
- **解决方案 1:禁用 git-repo-check(推荐)**
664
+ ### 本地开发
648
665
 
649
- 设置环境变量来禁用该参数:
650
666
  ```bash
651
- # 临时禁用
652
- export CODEX_DISABLE_SKIP_GIT_CHECK=true
653
- /ccg:dev "your task"
667
+ # 克隆仓库
668
+ git clone https://github.com/fengshao1227/ccg-workflow.git
669
+ cd ccg-workflow/skills-v2
654
670
 
655
- # 永久禁用(添加到 ~/.zshrc 或 ~/.bashrc)
656
- echo 'export CODEX_DISABLE_SKIP_GIT_CHECK=true' >> ~/.zshrc
657
- source ~/.zshrc
658
- ```
671
+ # 安装依赖
672
+ pnpm install
659
673
 
660
- **解决方案 2:检查 Codex 配置**
674
+ # 开发模式
675
+ pnpm dev
661
676
 
662
- 如果方案 1 无效,检查 Codex CLI 配置:
663
- ```bash
664
- # 重新登录 Codex
665
- codex logout
666
- codex login
677
+ # 构建
678
+ pnpm build
667
679
 
668
- # 验证直接调用是否正常
669
- codex e "test task"
670
- ```
680
+ # 本地测试
681
+ pnpm start
671
682
 
672
- **解决方案 3:更新 Codex CLI**
683
+ # 类型检查
684
+ pnpm typecheck
673
685
 
674
- ```bash
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
- <details>
683
- <summary><strong>Q: codex 总是思考太久超时该怎么办?</strong></summary>
690
+ ### 项目结构
684
691
 
685
- **问题描述**:在使用 `/ccg:dev` 等命令时,Codex 后端思考时间过长,导致超时。
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
- - 调整 Codex CLI 的超时配置
693
- - 使用 `--backend gemini` 切换到 Gemini 后端测试
694
- </details>
721
+ ```bash
722
+ # 1. 更新版本号(package.json)
723
+ # "version": "1.4.x" "1.4.y"
695
724
 
696
- <details>
697
- <summary><strong>Q: 如何更新到最新版本?</strong></summary>
725
+ # 2. 构建并发布
726
+ pnpm build
727
+ npm publish
698
728
 
699
- **一键更新,无需卸载重装**:
700
- ```bash
701
- npx ccg-workflow
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
- **v1.3.0 核心特性**:安装时可以选择:
715
- - **ace-tool**(第三方):开箱即用,包含 Prompt 增强 + 代码检索
716
- - **auggie**(官方):代码检索 + 可选 Prompt 增强(需配置)
737
+ ## 🙏 致谢
717
738
 
718
- 命令模板会根据配置自动适配对应的 MCP 工具调用。
719
- </details>
739
+ 感谢以下开源项目的贡献:
720
740
 
721
- <details>
722
- <summary><strong>Q: codeagent-wrapper 是什么?</strong></summary>
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
- 来自 [cexll/myclaude](https://github.com/cexll/myclaude) 的 Go 工具,封装了多 CLI 调用:
725
- - 支持 `--backend codex/gemini/claude` 切换
726
- - 会话管理(SESSION_ID)
727
- - ROLE_FILE 动态注入
728
- - 自动安装到 `~/.claude/bin/`
729
- </details>
747
+ ---
730
748
 
731
- <details>
732
- <summary><strong>更多问题?</strong></summary>
749
+ ## 💬 支持与反馈
733
750
 
734
- 查看完整讨论和 Q&A:
735
- - [linux.do 社区讨论帖](https://linux.do/t/topic/1405588) - 包含 11 个常见问题的详细解答
736
- - [GitHub Issues](https://github.com/fengshao1227/ccg-workflow/issues) - 提交问题和建议
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
- - **[cexll/myclaude](https://github.com/cexll/myclaude)** - codeagent-wrapper 多后端调用工具的 Go 代码来源,以及 `/ccg:code`、`/ccg:debug`、`/ccg:test`、`/ccg:bugfix`、`/ccg:think`、`/ccg:optimize` 命令的设计参考
752
- - **[UfoMiao/zcf](https://github.com/UfoMiao/zcf)** - Git 工具(commit、rollback、clean-branches、worktree)和项目初始化(init)命令来源
753
- - **[GudaStudio/skills](https://github.com/GuDaStudio/skills)** - 智能路由(前端→Gemini、后端→Codex)的设计理念
754
- - **[ace-tool MCP](https://linux.do/t/topic/1344562)** - [@mistripple](https://linux.do/u/mistripple) 的 ace-tool 轻量级代码检索和 Prompt 增强方案
767
+ **最后更新**: 2026-01-06 | **版本**: v1.4.1
768
+
769
+ Made with ❤️ by the CCG Community
770
+
771
+ </div>