diff --git a/POST_DRAFT.md b/POST_DRAFT.md new file mode 100644 index 0000000..cdd82b1 --- /dev/null +++ b/POST_DRAFT.md @@ -0,0 +1,393 @@ +# 帖子标题 + +**【开源·更新】CCG v1.7.61 : Claude Code 编排三 CLI 协作 | Codex + Gemini + Claude | Agent Teams 并行实施** + +--- + +# 正文 + +> **GitHub**: https://github.com/fengshao1227/ccg-workflow +> 觉得好用请留下你的 ⭐ Star + +[![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) + +## 一句话介绍 + +**CCG** = Claude Code 编排 Codex + Gemini 三 CLI 协作 + +- 前端任务 → **Gemini**（擅长 UI/CSS/组件） +- 后端任务 → **Codex**（擅长逻辑/算法/调试） +- 全栈整合 → **Claude**（编排决策、质量把控、代码审核） + +外部模型无写入权限，仅返回 Patch，由 Claude 审核后应用。 + +--- + +## 🚀 30 秒安装 + +```bash +npx ccg-workflow +``` + +选择「初始化工作流」→ 自动安装 25 个命令 → 重启终端生效 + +**要求**：Claude Code CLI、Node.js 20+ +**可选**：Codex CLI（后端）、Gemini CLI（前端） + +> 只有 Claude Code 也能用，就是没有多模型协作了 + +--- + +## 📦 版本更新 + +
+🔥 v1.7.61 — Agent Teams 并行实施（2026-02-10） + +新增独立的 Team 系列命令，利用 Claude Code Agent Teams 实验特性实现多 agent 并行开发： + +| 命令 | 用途 | +|------|------| +| `/ccg:team-research` | 需求 → 约束集（并行探索代码库） | +| `/ccg:team-plan` | 约束 → 零决策并行计划 | +| `/ccg:team-exec` | spawn Builder teammates 并行写代码 | +| `/ccg:team-review` | 双模型交叉审查 | + +**工作流**： +``` +/ccg:team-research → /clear → /ccg:team-plan → /clear → /ccg:team-exec → /clear → /ccg:team-review +``` + +**特点**： +- 每步 `/clear` 隔离上下文，通过文件传递状态，不怕上下文爆 +- Builder teammates 使用 Sonnet 并行写代码，速度翻倍 +- 完全独立体系，不依赖现有 `/ccg:workflow` 等命令 + +**前置条件**：需手动启用 Agent Teams： +```json +// ~/.claude/settings.json +{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } +``` + +**实战效果**：一个实时协作看板 API（JWT 认证 + 4 层嵌套 CRUD + WebSocket + 权限控制 + 拖拽排序），10 个源文件、20+ REST 端点，全链路验证零 bug。 + +
+ +
+v1.7.59 — 内置 Prompt 增强（2026-02-09） + +- 新增 `/ccg:enhance` 命令，内置 Prompt 增强 +- 移除对 ace-tool `enhance_prompt` 的依赖 + +
+ +
+v1.7.58 — 输出风格配置（2026-02-09） + +- **6 种输出风格**：默认 / 专业工程师 / 猫娘 / 老王 / 大小姐 / 邪修 + +
+ +
+v1.7.57 — MCP 扩展 + API 配置 + 实用工具（2026-02-08） + +- **MCP 扩展**：ContextWeaver（推荐免费）+ 辅助工具（Context7/Playwright/DeepWiki/Exa） +- **API 配置**：支持自定义 URL + Key，自动优化配置 +- **实用工具**：ccusage 用量分析 + CCometixLine 状态栏 +- **Claude Code 安装**：npm / homebrew / curl / powershell / cmd +- **OpenSpec 集成**：规范驱动开发，把需求变成约束 + +
+ +
+v1.7.52 — OpenSpec OPSX 架构（2026-01-26） + +- 迁移到 OPSX 架构，废弃 `/openspec:xxx`，启用 `/opsx:xxx` +- 更新 `spec-*` 系列命令 + +
+ +--- + +## ✨ 核心特性 + +| 特性 | 说明 | +|-----|------| +| **固定路由** | 前端→Gemini，后端→Codex，全栈→Claude | +| **多模型并行** | Codex ∥ Gemini 同时调用，交叉验证 | +| **Agent Teams** | spawn Builder teammates 并行写代码（v1.7.61+） | +| **6阶段工作流** | Prompt增强 → 检索 → 分析 → 原型 → 实施 → 审计 | +| **25个斜杠命令** | 开发工作流 + Git 工具 + OPSX + Agent Teams | +| **13个专家提示词** | Codex 6 个 + Gemini 7 个，零 token 动态注入 | +| **6种输出风格** | 默认 / 专业工程师 / 猫娘 / 老王 / 大小姐 / 邪修 | +| **跨平台支持** | macOS / Linux / Windows × Intel / ARM | + +### 架构图 + +``` +Claude Code (编排) + │ + ┌───┴───┐ + ↓ ↓ +Codex Gemini +(后端) (前端) + │ │ + └───┬───┘ + ↓ + Unified Patch + (Claude 审核后应用) +``` + +--- + +## 📚 命令速查 + +
+🔧 日常开发（6 个） + +```bash +/ccg:workflow # 完整6阶段流程 +/ccg:plan # 多模型规划，生成计划 +/ccg:execute # 多模型执行，执行计划 +/ccg:feat # 新功能开发 +/ccg:frontend # 纯前端，Gemini 快速模式 +/ccg:backend # 纯后端，Codex 快速模式 +``` + +
+ +
+🔍 分析调试（5 个） + +```bash +/ccg:analyze # 技术分析 +/ccg:debug # 问题诊断+修复 +/ccg:optimize # 性能优化 +/ccg:test # 测试生成 +/ccg:review # 代码审查（无参数自动审查 git diff） +``` + +
+ +
+🔀 Git 工具（4 个） + +```bash +/ccg:commit # 智能提交（conventional commit） +/ccg:rollback # 交互式回滚 +/ccg:clean-branches # 清理已合并分支 +/ccg:worktree # Worktree 管理 +``` + +
+ +
+📋 OpenSpec 规范驱动（5 个） + +集成了 [OpenSpec (OPSX)](https://github.com/fission-ai/opsx)，把需求变成约束，让 AI 没法自由发挥。 + +| 命令 | 干嘛的 | +|------|--------| +| `/ccg:spec-init` | 初始化 OpenSpec 环境 | +| `/ccg:spec-research` | 分析需求，输出约束集 | +| `/ccg:spec-plan` | Codex + Gemini 并行分析，生成执行计划 | +| `/ccg:spec-impl` | 按计划一步步实现，完了自动归档 | +| `/ccg:spec-review` | 双模型审查，随时可以用 | + +``` +需求 ──→ spec-research ──→ spec-plan ──→ spec-impl + │ │ │ + 约束集 零决策计划 机械执行 +``` + +每个阶段之间可以 `/clear`，状态存在 `openspec/` 目录，不怕上下文爆。 + +
+ +
+⚡ Agent Teams 并行实施（4 个）— v1.7.61 新增 + +利用 Claude Code Agent Teams 实验特性，spawn 多个 Builder teammates 并行写代码。 + +| 命令 | 干嘛的 | +|------|--------| +| `/ccg:team-research` | 并行探索代码库，产出约束集 | +| `/ccg:team-plan` | Codex + Gemini 分析，拆分为并行子任务 | +| `/ccg:team-exec` | spawn Builder teammates 并行实施 | +| `/ccg:team-review` | 双模型交叉审查 | + +``` +需求 ──→ team-research ──→ team-plan ──→ team-exec ──→ team-review + │ │ │ │ + 约束集 并行计划 Builder×N 并行 双模型审查 +``` + +**vs 传统工作流**：每步 `/clear` 隔离上下文，Builder 并行实施。适合可拆分为 3+ 独立模块的任务。 + +**前置条件**： +```json +// ~/.claude/settings.json +{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } +``` + +
+ +
+📁 项目管理（1 个） + +```bash +/ccg:init # 初始化项目 CLAUDE.md +``` + +
+ +--- + +## 🔧 交互式菜单 + +```bash +npx ccg-workflow +``` + +
+菜单选项详情 + +- 初始化工作流 +- 更新工作流 +- 配置 MCP +- 配置 API +- 配置输出风格 +- 实用工具 +- 安装 Claude Code +- 卸载工作流 + +### 配置 MCP + +**代码检索 MCP（二选一）**： +- ✅ **ContextWeaver**（推荐）- 本地混合搜索，需要硅基流动 API Key（免费） +- ⚠️ **ace-tool**（收费）- Augment 官方 + +**辅助工具 MCP（可选）**： +- **Context7** - 获取最新库文档 +- **Playwright** - 浏览器自动化/测试 +- **DeepWiki** - 知识库查询 +- **Exa** - 搜索引擎（需 API Key，有免费额度） + +### 配置 API + +- 支持自定义 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY` +- 自动添加优化配置（禁用遥测、MCP 超时等） +- 自动添加 codeagent-wrapper 权限白名单 + +### 配置输出风格 + +| 风格 | 说明 | +|-----|------| +| 默认 | Claude Code 原生风格 | +| 专业工程师 | 简洁专业的技术风格 | +| 猫娘工程师 | 可爱猫娘语气喵~ | +| 老王工程师 | 接地气的老王风格 | +| 大小姐工程师 | 优雅大小姐语气 | +| 邪修风格 | 宿命深渊·道语标签 | + +### 实用工具 + +- **ccusage** - Claude Code 用量分析 +- **CCometixLine** - 状态栏工具（Git + 用量跟踪） + +### 安装 Claude Code + +支持多种安装方式：npm / homebrew / curl / powershell / cmd + +
+ +--- + +## ❓ 常见问题 + +
+Q: codeagent-wrapper: command not found？ + +PATH 未生效，重启终端或执行： +```bash +source ~/.zshrc # Mac/Linux +``` +
+ +
+Q: 如何更新？ + +```bash +npx ccg-workflow@latest +# 选择 "更新工作流" +``` +
+ +
+Q: 如何卸载？ + +```bash +npx ccg-workflow +# 选择 "卸载工作流" +``` +
+ +
+Q: Codex 任务卡住？ + +Codex CLI 0.80.0 已知 bug，设置环境变量解决： +```bash +export CODEAGENT_POST_MESSAGE_DELAY=1 +``` +或在 `~/.claude/settings.json` 中配置： +```json +{ "env": { "CODEAGENT_POST_MESSAGE_DELAY": "1" } } +``` +
+ +
+Q: Claude Code 任务超时？ + +修改 `~/.claude/settings.json`： +```json +{ + "env": { + "CODEX_TIMEOUT": "7200", + "BASH_DEFAULT_TIMEOUT_MS": "600000", + "BASH_MAX_TIMEOUT_MS": "3600000" + } +} +``` +
+ +
+Q: Agent Teams 怎么启用？ + +在 `~/.claude/settings.json` 中添加： +```json +{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } +``` +然后重新运行 `npx ccg-workflow` 安装最新命令。 +
+ +
+Q: OpenSpec CLI 装不上？ + +```bash +npm install -g @fission-ai/openspec@latest +``` +
+ +--- + +## 🙏 鸣谢 + +- [cexll/myclaude](https://github.com/cexll/myclaude) - codeagent-wrapper +- [UfoMiao/zcf](https://github.com/UfoMiao/zcf) - Git 工具 + 输出风格 +- [telagod/code-abyss](https://github.com/telagod/code-abyss) - 邪修输出风格 +- [GudaStudio/skills](https://github.com/GuDaStudio/skills) - 智能路由设计 +- [fission-ai/opsx](https://github.com/fission-ai/opsx) - OpenSpec 规范驱动框架 +- [ace-tool MCP](https://linux.do/t/topic/1344562) - 代码检索工具 + +--- + +**版本**: v1.7.61 | [GitHub Issues](https://github.com/fengshao1227/ccg-workflow/issues)