fengshao1227/ccg-workflow

# CCG - Claude + Codex + Gemini 多模型协作 一个多模型协作开发系统，由 Claude Code 编排 Codex + Gemini。前端任务路由至 Gemini，后端任务路由至 Codex，Claude 负责编排和代码审查。 ## 安装 ``` npx ccg-workflow ``` **要求**：Claude Code CLI, Node.js 20+ **可选**：Codex CLI (后端), Gemini CLI (前端) ## 首次设置 首次运行时，CCG 会提示您选择首选语言（英语或中文）。此偏好设置将被保存并用于所有后续会话。 ## 命令 | Command | Description | |---------|-------------| | `/ccg:workflow` | 完整 6 阶段开发工作流 | | `/ccg:plan` | 多模型协作规划（阶段 1-2） | | `/ccg:execute` | 多模型协作执行（阶段 3-5） | | `/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:spec-init` | 初始化 OPSX 环境 | | `/ccg:spec-research` | 需求 → 约束 | | `/ccg:spec-plan` | 约束 → 零决策计划 | | `/ccg:spec-impl` | 执行计划 + 归档 | | `/ccg:spec-review` | 双模型交叉审查 | | `/ccg:team-research` | Agent Teams 需求 → 约束 | | `/ccg:team-plan` | Agent Teams 约束 → 并行计划 | | `/ccg:team-exec` | Agent Teams 并行执行 | | `/ccg:team-review` | Agent Teams 双模型审查 | | `/ccg:codex-exec` | Codex 完整执行（计划 → 编码 → 审查） | ### OPSX 规范驱动 (v1.7.52+) 集成 [OPSX 架构](https://github.com/fission-ai/opsx)，将需求转化为约束，消除 AI 即兴发挥： ``` # 初始化 OPSX 环境 /ccg:spec-init # 需求调研 → 输出约束 /ccg:spec-research implement user authentication # 并行分析 → 零决策计划 /ccg:spec-plan # 执行计划 /ccg:spec-impl # 独立审查（随时可用） /ccg:spec-review ``` **注意**：`/ccg:spec-*` 命令是 CCG 对 OPSX 的封装，内部调用 `/opsx:*` 命令。您可以在阶段之间执行 `/clear` —— 状态会持久化在 `openspec/` 目录中，因此无需担心上下文溢出。 ### Agent Teams 并行执行 (v1.7.60+) 利用 Claude Code Agent Teams 实验性功能生成多个 Builder 队友进行并行编码： ``` # 1. 需求调研 → 约束（推荐用于复杂项目） /ccg:team-research implement real-time collaboration kanban API # 2. /clear 然后 plan → 零决策并行计划 /ccg:team-plan kanban-api # 3. /clear 然后并行执行 → Builder 队友并行编写代码 /ccg:team-exec # 4. /clear 然后 review → 双模型交叉审查 /ccg:team-review ``` **前置条件**：需手动启用 Agent Teams（`settings.json`：设置 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`） **与传统工作流对比**：Team 系列在步骤之间使用 `/clear` 来隔离上下文，通过文件传递状态。Builder 并行工作，适用于可分解为 3 个以上独立模块的任务。 ### 规划与执行分离 ``` # 1. 生成实施计划 /ccg:plan implement user authentication # 2. 审查计划（可编辑） # 计划已保存至 .claude/plan/user-auth.md # 3a. 执行（Claude 重构）— 细粒度控制 /ccg:execute .claude/plan/user-auth.md # 3b. 执行（Codex 完成所有工作）— 高效，低 Claude token 用量 /ccg:codex-exec .claude/plan/user-auth.md ``` ## 配置 ### 目录结构 ``` ~/.claude/ ├── commands/ccg/ # Slash commands ├── agents/ccg/ # Sub-agents ├── skills/ # Quality gates + multi-agent orchestration ├── bin/codeagent-wrapper └── .ccg/ ├── config.toml └── prompts/{codex,gemini}/ ``` ### 环境变量 | Variable | Description | Default | |----------|-------------|---------| | `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` 中的配置： ``` { "env": { "CODEAGENT_POST_MESSAGE_DELAY": "1", "CODEX_TIMEOUT": "7200", "BASH_DEFAULT_TIMEOUT_MS": "600000", "BASH_MAX_TIMEOUT_MS": "3600000" } } ``` ### codeagent-wrapper 自动授权 CCG 会在 `settings.json` 中自动安装一个 Hook 来自动授权 codeagent-wrapper 命令，因此您无需手动批准每次协作调用。 **要求**：系统必须安装 `jq`。 ``` # macOS brew install jq # Linux (Debian/Ubuntu) sudo apt install jq # Linux (RHEL/CentOS) sudo yum install jq # Windows choco install jq # 或 scoop install jq ``` ### MCP 配置 代码检索 MCP（任选其一）： - **ace-tool**（推荐） - 通过 `search_context` 进行代码搜索（注意：`enhance_prompt` 已不再可用）。[官方](https://augmentcode.com/) | [第三方代理（推荐）](https://acemcp.heroman.wtf/) - **ContextWeaver**（备选） - 本地混合搜索，需要 SiliconFlow API Key（免费） 可选 MCP 工具： - **Context7** - 最新库文档 - **Playwright** - 浏览器自动化/测试 - **DeepWiki** - 知识库查询 - **Exa** - 搜索引擎（需要 API Key） ``` # 配置 MCP npx ccg-workflow menu # Select "Configure MCP" ``` ## 工具 ``` npx ccg-workflow menu # Select "Tools" ``` - **ccusage** - Claude Code 使用分析 - **CCometixLine** - 状态栏工具（Git + 使用量追踪） ## 安装 Claude Code ``` npx ccg-workflow menu # Select "Install Claude Code" ``` 支持多种安装方式：npm, homebrew, curl, powershell, cmd ## 更新 / 卸载 ``` # 更新 npx ccg-workflow@latest # npx users npm install -g ccg-workflow@latest # npm global users # 卸载 npx ccg-workflow # Select "Uninstall" npm uninstall -g ccg-workflow # npm global users need this extra step ``` ## 常见问题 ### 1. 如何自动授权 codeagent-wrapper 而无需手动批准？ CCG 在设置期间会自动安装 Hook（v1.7.71+）。如果您安装的是旧版本，请将以下内容添加到 `~/.claude/settings.json`： ``` { "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "jq -r '.tool_input.command' | grep -q 'codeagent-wrapper' && echo '{\"hookSpecificOutput\": {\"hookEventName\": \"PreToolUse\", \"permissionDecision\": \"allow\", \"permissionDecisionReason\": \"codeagent-wrapper auto-approved\"}}' || exit 1", "timeout": 1 } ] } ] } } ``` ### 2. Codex CLI 0.80.0 进程未退出 在 `--json` 模式下，Codex 在输出完成后不会自动退出。 修复方法：设置 `CODEAGENT_POST_MESSAGE_DELAY=1` ## 架构 ``` Claude Code (Orchestrator) │ ┌───┴───┐ ↓ ↓ Codex Gemini (Backend) (Frontend) │ │ └───┬───┘ ↓ Unified Patch ``` 外部模型没有写入权限 —— 它们只返回补丁，由 Claude 审查后再应用。 ## 许可证 MIT v1.7.75 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues)

标签：AI编程助手, Claude Code, CLI, DLL 劫持, EVTX分析, Gemini, Git工具, GNU通用公共许可证, MITM代理, MIT协议, Node.js, NPM包, OpenAI Codex, OSV-Scalibr, Python安全, WiFi技术, Worktree管理, 人机协同, 代码优化, 代码审查, 代码生成, 代码调试, 多模型协作, 大语言模型, 应用安全, 开发工作流, 技术架构, 提示词增强, 效率工具, 数据管道, 智能路由, 暗色界面, 测试生成, 渗透测试工具, 自动化运维, 软件工程