ccg-workflow 1.7.24 → 1.7.25

package/README.md

@@ -1,409 +1,135 @@
-# CCG - Claude + Codex + Gemini 多模型协作系统
+# CCG - Claude + Codex + Gemini Multi-Model Collaboration
 
 <div align="center">
 
-**Claude Code 编排 Codex + Gemini 双模型协作的智能开发工作流系统**
-
 [![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)
 
-[快速开始](#-快速开始) • [命令参考](#-命令参考) • [常见问题](#-常见问题) • [更新日志](CHANGELOG.md)
-
 </div>
 
----
-
-## 💡 这是什么？
-
-**CCG** = **Claude Code** (编排) + **Codex CLI** (后端) + **Gemini CLI** (前端)
-
-一个让 Claude Code 专注于编排决策，把具体代码生成交给专业模型的多模型协作系统：
-
-- **前端任务** → Gemini（擅长 UI/CSS/组件）
-- **后端任务** → Codex（擅长逻辑/算法/调试）
-- **全栈整合** → Claude（工作流控制、代码主权）
-
-### 核心优势
-
-- ✅ **智能路由** - 前端 → Gemini，后端 → Codex，自动选择
-- ✅ **多模型并行** - Codex ∥ Gemini 同时分析，交叉验证减少错误
-- ✅ **零写入权限** - 外部模型只返回 Patch，Claude 保持代码主权
-- ✅ **Token 优化** - ROLE_FILE 动态注入，专家提示词零消耗
-- ✅ **Web UI 实时输出** - 自动打开浏览器，流式显示思考过程、命令执行、生成结果
-- ✅ **一键安装** - npx 运行，自动安装全部 15 个命令
-
----
-
-## 🚀 快速开始
-
-### 前置要求
-
-**必需**：
-- [Claude Code CLI](https://claude.ai/code)
-- Node.js 18+
+Claude Code 编排 Codex + Gemini 的多模型协作开发系统。前端任务路由至 Gemini，后端任务路由至 Codex，Claude 负责编排决策和代码审核。
 
-**可选**（根据需求安装）：
-- Codex CLI - 用于后端任务
-- Gemini CLI - 用于前端任务
-
-> 💡 **只装 Claude Code 也能用！** 系统会自动降级为纯 Claude 工作流
-
-### 一键安装
+## 安装
 
 ```bash
 npx ccg-workflow
 ```
 
-**安装流程**：
-1. 选择是否配置 ace-tool MCP（可跳过）
-2. 确认安装
-3. 自动安装全部 15 个命令
-4. 配置 PATH（如需要）
+**要求**：Claude Code CLI、Node.js 18+
 
-就这么简单！无需选择语言、模型、命令预设。
+**可选**：Codex CLI（后端）、Gemini CLI（前端）
 
-### 固定配置
+## 命令
 
-| 项目 | 配置 |
+| 命令 | 说明 |
 |------|------|
-| 前端模型 | **Gemini** |
-| 后端模型 | **Codex** |
-| 协作模式 | **smart** |
-| 命令数量 | **15 个**（全部安装） |
-
-### 第一个命令
-
-```bash
-# 在 Claude Code 中执行
-/ccg:workflow 实现用户登录功能
-
-# 自动执行 6 阶段工作流：
-# 阶段 1: 研究 - Prompt 增强 + 上下文检索
-# 阶段 2: 构思 - 多模型分析 (Codex ∥ Gemini)
-# 阶段 3: 计划 - 多模型规划 + 用户确认
-# 阶段 4: 执行 - 代码实施
-# 阶段 5: 优化 - 多模型审查
-# 阶段 6: 评审 - 质量检查
-```
-
----
-
-## 📚 命令参考
-
-### 核心命令（记住这 3 个就够了）
-
-```bash
-/ccg:workflow   # 完整任务（6 阶段工作流）
-/ccg:feat       # 新功能开发（自动规划）
-/ccg:frontend   # 纯前端任务（Gemini 主导，更快）
-/ccg:backend    # 纯后端任务（Codex 主导，更快）
-```
-
-### 完整命令列表（15 个）
-
-#### 开发工作流
-
-| 命令 | 用途 | 模型 |
-|-----|------|------|
-| `/ccg:workflow` | 完整 6 阶段开发工作流 | Codex ∥ Gemini |
-| `/ccg:frontend` | 前端专项（快速模式） | Gemini |
-| `/ccg:backend` | 后端专项（快速模式） | Codex |
-| `/ccg:feat` | 智能功能开发 | 规划 → 实施 |
-| `/ccg:enhance` | Prompt 增强（ace-tool） | MCP |
-| `/ccg:analyze` | 技术分析（仅分析不改代码） | Codex ∥ Gemini |
-| `/ccg:debug` | 问题诊断 + 修复 | Codex ∥ Gemini |
-| `/ccg:optimize` | 性能优化 | Codex ∥ Gemini |
-| `/ccg:test` | 测试生成 | 智能路由 |
-| `/ccg:review` | 代码审查（无参数自动审查 git diff） | Codex ∥ Gemini |
-
-#### Git 工具
-
-| 命令 | 用途 |
-|-----|------|
-| `/ccg:commit` | 智能提交（自动生成 conventional commit）|
-| `/ccg:rollback` | 交互式回滚 |
-| `/ccg:clean-branches` | 清理已合并分支 |
+| `/ccg:workflow` | 6 阶段完整工作流 |
+| `/ccg:feat` | 新功能开发 |
+| `/ccg:frontend` | 前端任务 (Gemini) |
+| `/ccg:backend` | 后端任务 (Codex) |
+| `/ccg:analyze` | 技术分析 |
+| `/ccg:debug` | 问题诊断 |
+| `/ccg:optimize` | 性能优化 |
+| `/ccg:test` | 测试生成 |
+| `/ccg:review` | 代码审查 |
+| `/ccg:commit` | Git 提交 |
+| `/ccg:rollback` | Git 回滚 |
+| `/ccg:clean-branches` | 清理分支 |
 | `/ccg:worktree` | Worktree 管理 |
+| `/ccg:init` | 初始化 CLAUDE.md |
+| `/ccg:enhance` | Prompt 增强 |
 
-#### 项目工具
-
-| 命令 | 用途 |
-|-----|------|
-| `/ccg:init` | 初始化项目 CLAUDE.md |
-
----
-
-## 🎭 专家角色系统
-
-### ROLE_FILE 动态注入机制
-
-12 个专家提示词（Codex 6 + Gemini 6），**零 token 消耗**：
+## 配置
 
-**Codex 专家**（后端）：
-- `architect.md` - 后端架构师
-- `analyzer.md` - 技术分析师
-- `debugger.md` - 调试专家
-- `optimizer.md` - 性能优化师
-- `reviewer.md` - 代码审查员
-- `tester.md` - 测试工程师
-
-**Gemini 专家**（前端）：
-- `frontend.md` - 前端架构师
-- `analyzer.md` - UI/UX 分析师
-- `debugger.md` - 前端调试专家
-- `optimizer.md` - 前端性能优化
-- `reviewer.md` - 代码审查员
-- `tester.md` - 前端测试工程师
-
-**工作原理**：
-1. 每个命令自动注入对应角色提示词
-2. 通过 `codeagent-wrapper` 子进程读取
-3. 不占用主会话 token
-4. 用户可自定义修改（路径：`~/.claude/.ccg/prompts/`）
-
----
-
-## 🗂️ 安装目录结构
+### 目录结构
 
 ```
 ~/.claude/
-├── commands/ccg/          # 15 个斜杠命令
-├── agents/ccg/            # 4 个子智能体
-├── skills/                # 暂无
-├── bin/
-│   └── codeagent-wrapper  # Go 多后端调用工具
+├── commands/ccg/       # 斜杠命令
+├── agents/ccg/         # 子智能体
+├── bin/codeagent-wrapper
 └── .ccg/
-    ├── config.toml        # 主配置
-    └── prompts/           # 12 个专家提示词
-        ├── codex/
-        └── gemini/
-```
-
----
-
-## 🏗️ 架构说明
-
-```
-┌─────────────────────────────────────────────────┐
-│          Claude Code CLI (主导编排)              │
-│        决策、编排、代码实施、质量把控             │
-└──────────────┬──────────────────────────────────┘
-               │
-       ┌───────┴────────┐
-       │                │
-       ↓                ↓
-┌─────────────┐  ┌─────────────┐
-│  Codex CLI  │  │ Gemini CLI  │
-│  后端专家   │  │  前端专家   │
-│  逻辑算法   │  │  UI 组件    │
-└─────────────┘  └─────────────┘
-       │                │
-       └────────┬───────┘
-                ↓
-      Unified Diff Patch
-    (零写入权限，仅返回补丁)
-```
-
-**信任规则**：
-- 后端问题 → **以 Codex 意见为准**
-- 前端问题 → **以 Gemini 意见为准**
-- 冲突时 → Claude 综合判断，向用户说明分歧
-
----
-
-## ❓ 常见问题
-
-<details>
-<summary><strong>Q1: 只装了 Claude Code，没装 Codex/Gemini 能用吗？</strong></summary>
-
-✅ **可以！** 系统会自动降级为纯 Claude 工作流。
-
-但会失去：
-- 智能路由（前端/后端自动分配）
-- 多模型并行（交叉验证）
-- 专家角色系统（ROLE_FILE 注入）
-
-建议至少安装 Codex 或 Gemini 其中一个以获得完整体验。
-
-</details>
-
-<details>
-<summary><strong>Q2: MCP 工具如何配置？</strong></summary>
-
-**安装时配置**（推荐）：
-
-```bash
-npx ccg-workflow
-# 选择 "安装 ace-tool"
+    ├── config.toml
+    └── prompts/{codex,gemini}/
 ```
 
-**ace-tool 两种方式**：
-
-1. **官方服务**：
-   - 注册地址：https://augmentcode.com/
-   - 获取 Token 后填写即可
-
-2. **中转服务**（无需注册）⭐：
-   - 免费使用：https://linux.do/t/topic/1291730
-   - linux.do 社区提供
-   - 需填写 Base URL 和 Token
-
-**跳过 MCP**：
-
-跳过 MCP 后，命令中涉及 ace-tool 的步骤（代码检索、Prompt 增强）会失效，但其他功能正常工作。
-
-</details>
-
-<details>
-<summary><strong>Q3: 如何更新到最新版本？</strong></summary>
-
-```bash
-npx ccg-workflow@latest
-# 选择 "更新工作流"
+### 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `CODEAGENT_POST_MESSAGE_DELAY` | Codex 完成后等待时间（秒） | 5 |
+| `CODEX_TIMEOUT` | codeagent-wrapper 执行超时（秒） | 7200 |
+| `BASH_DEFAULT_TIMEOUT_MS` | Claude Code Bash 默认超时（毫秒） | 120000 |
+| `BASH_MAX_TIMEOUT_MS` | Claude Code Bash 最大超时（毫秒） | 600000 |
+
+配置方式（`~/.claude/settings.json`）：
+
+```json
+{
+  "env": {
+    "CODEAGENT_POST_MESSAGE_DELAY": "1",
+    "CODEX_TIMEOUT": "7200",
+    "BASH_DEFAULT_TIMEOUT_MS": "600000",
+    "BASH_MAX_TIMEOUT_MS": "3600000"
+  }
+}
 ```
 
-更新会自动：
-- 检测 npm 最新版本
-- 增量更新命令和提示词
-- 保留 MCP 配置
+### MCP 配置
 
-</details>
+ace-tool 用于代码检索和 Prompt 增强，安装时可选配置。
 
-<details>
-<summary><strong>Q4: `/ccg:workflow` 和 `/ccg:frontend`/`/ccg:backend` 有什么区别？</strong></summary>
+Token 获取：https://augmentcode.com/
 
-- **`/ccg:workflow`** - 完整 6 阶段工作流
-  - 每阶段都并行调用 Codex + Gemini
-  - 适合全栈任务、复杂任务
+## 更新 / 卸载
 
-- **`/ccg:frontend`** / **`/ccg:backend`** - 专项快速模式
-  - 只调用对应主导模型（更快）
-  - 适合明确的纯前端/纯后端任务
-
-</details>
-
-<details>
-<summary><strong>Q5: 安装后提示 "codeagent-wrapper: command not found"？</strong></summary>
-
-**原因**：PATH 未生效
-
-**解决方案**：
-
-Mac/Linux：
 ```bash
-source ~/.zshrc
-# 或
-source ~/.bashrc
-```
+# 更新
+npx ccg-workflow@latest          # npx 用户
+npm install -g ccg-workflow@latest  # npm 全局用户
 
-Windows：
-```powershell
-# 重新打开 PowerShell
-```
-
-</details>
-
-<details>
-<summary><strong>Q6: 如何卸载？</strong></summary>
-
-**⚠️ 重要：根据安装方式选择卸载方法**
-
-#### 方式 1：npx 安装用户（推荐）
-
-```bash
-npx ccg-workflow
-# 选择 "卸载工作流"
+# 卸载
+npx ccg-workflow  # 选择 "卸载工作流"
+npm uninstall -g ccg-workflow  # npm 全局用户需额外执行
 ```
 
-会删除：
-- `~/.claude/commands/ccg/` - 命令文件
-- `~/.claude/agents/ccg/` - 子智能体
-- `~/.claude/skills/` - skills
-- `~/.claude/bin/codeagent-wrapper*` - 二进制文件
-- `~/.claude/.ccg/` - 配置目录（可选保留）
+## 已知问题
 
-#### 方式 2：npm 全局安装用户
+**Codex CLI 0.80.0 进程不退出**
 
-**如果你曾经运行过 `npm install -g ccg-workflow`，需要两步卸载：**
+`--json` 模式下 Codex 完成输出后进程不会自动退出。
 
-```bash
-# 第 1 步：卸载工作流文件
-npx ccg-workflow
-# 选择 "卸载工作流"
+解决：设置 `CODEAGENT_POST_MESSAGE_DELAY=1`
 
-# 第 2 步：卸载 npm 全局包（必须执行，否则 ccg 命令仍可用）
-npm uninstall -g ccg-workflow
-```
+## 架构
 
-**v1.7.11 新增**：系统会自动检测全局安装并提示第 2 步操作。
-
-#### 方式 3：手动清理
-
-```bash
-# 删除所有工作流文件
-rm -rf ~/.claude/commands/ccg
-rm -rf ~/.claude/agents/ccg
-rm -rf ~/.claude/skills/multi-model-collaboration
-rm -rf ~/.claude/bin/codeagent-wrapper*
-rm -rf ~/.claude/.ccg
-
-# 如果是全局安装，还需执行
-npm uninstall -g ccg-workflow
-
-# 清理 MCP 配置（如果安装了 ace-tool）
-# 手动编辑 ~/.claude.json 删除 ace-tool 相关配置
 ```
-
-**⚠️ 注意：npx 缓存问题**
-
-如果卸载后重新安装仍使用旧版本，清理 npx 缓存：
-
-```bash
-# 清理 npx 缓存
-npx clear-npx-cache
-# 或
-rm -rf ~/.npm/_npx
-
-# 然后重新安装
-npx ccg-workflow@latest
+Claude Code (编排)
+       │
+   ┌───┴───┐
+   ↓       ↓
+Codex   Gemini
+(后端)   (前端)
+   │       │
+   └───┬───┘
+       ↓
+  Unified Patch
 ```
 
-</details>
+外部模型无写入权限，仅返回 Patch，由 Claude 审核后应用。
 
----
+## 致谢
 
-## 🙏 致谢
+- [cexll/myclaude](https://github.com/cexll/myclaude) - codeagent-wrapper
+- [UfoMiao/zcf](https://github.com/UfoMiao/zcf) - Git 工具
+- [GudaStudio/skills](https://github.com/GuDaStudio/skills) - 路由设计
+- [ace-tool](https://linux.do/t/topic/1344562) - MCP 工具
 
-感谢以下开源项目的贡献：
+## License
 
-- **[cexll/myclaude](https://github.com/cexll/myclaude)** - codeagent-wrapper 多后端调用工具
-- **[UfoMiao/zcf](https://github.com/UfoMiao/zcf)** - Git 工具与 MCP 配置逻辑
-- **[GudaStudio/skills](https://github.com/GuDaStudio/skills)** - 智能路由设计理念
-- **[ace-tool MCP](https://linux.do/t/topic/1344562)** - 轻量级代码检索和 Prompt 增强
-- **[linux.do 社区](https://linux.do/)** - 活跃的 Vibe Coding 技术交流社区
+MIT
 
 ---
 
-## 💬 支持与反馈
-
-- **GitHub Issues**: [提交问题](https://github.com/fengshao1227/ccg-workflow/issues)
-- **讨论社区**: [linux.do - CCG 讨论帖](https://linux.do/t/topic/1405588)
-
----
-
-## 📄 许可证
-
-本项目采用 [MIT License](LICENSE) 开源协议。
-
-Copyright (c) 2025 fengshao1227
-
----
-
-<div align="center">
-
-**版本**: v1.7.10 | **最后更新**: 2026-01-09
-
-Made with ❤️ by the CCG Community
-
-</div>
+v1.7.24 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues)

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { y as diagnoseMcpConfig, z as isWindows, A as readClaudeCodeConfig, B as fixWindowsMcpConfig, C as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, s as showMainMenu, i as init, D as configMcp, E as version, a as i18n } from './shared/ccg-workflow.D62jmTLV.mjs';
+import { y as diagnoseMcpConfig, z as isWindows, A as readClaudeCodeConfig, B as fixWindowsMcpConfig, C as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, s as showMainMenu, i as init, D as configMcp, E as version, a as i18n } from './shared/ccg-workflow.DJlWxdzA.mjs';
 import 'inquirer';
 import 'node:child_process';
 import 'node:util';

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, v as checkForUpdates, x as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, q as getCurrentVersion, t as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, k as installWorkflows, o as migrateToV1_4_0, p as needsMigration, r as readCcgConfig, s as showMainMenu, n as uninstallAceTool, m as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.D62jmTLV.mjs';
+export { c as changeLanguage, v as checkForUpdates, x as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, q as getCurrentVersion, t as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, k as installWorkflows, o as migrateToV1_4_0, p as needsMigration, r as readCcgConfig, s as showMainMenu, n as uninstallAceTool, m as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.DJlWxdzA.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:child_process';

package/dist/shared/{ccg-workflow.D62jmTLV.mjs → ccg-workflow.DJlWxdzA.mjs}

@@ -10,7 +10,7 @@ import i18next from 'i18next';
 import ora from 'ora';
 import { parse, stringify } from 'smol-toml';
 
-const version = "1.7.24";
+const version = "1.7.25";
 
 function isWindows() {
   return process.platform === "win32";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.7.24",
+  "version": "1.7.25",
   "description": "Claude-Codex-Gemini 多模型协作系统 - 智能路由多模型开发工作流",
   "type": "module",
   "packageManager": "pnpm@10.17.1",