ccg-workflow 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 fengshao1227
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,434 @@
+# CCG: 多模型协作系统
+
+<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)
+
+</div>
+
+---
+
+## 核心特性
+
+| 特性 | 描述 |
+|------|------|
+| **智能路由** | 前端任务自动路由到 Gemini，后端任务路由到 Codex |
+| **三模型协作** | 同时调用 Claude + Codex + Gemini 进行交叉验证 |
+| **Prompt 增强** | 集成 ace-tool MCP，自动优化需求描述 |
+| **6阶段工作流** | Prompt增强 → 上下文检索 → 多模型分析 → 原型生成 → 代码实施 → 审计交付 |
+| **交互式安装** | npx 一键运行，图形化配置界面 |
+| **跨平台** | 支持 macOS、Linux、Windows |
+
+---
+
+## 快速开始
+
+### 方式一：npx 直接运行（推荐）
+
+```bash
+# 交互式配置安装
+npx ccg-workflow
+
+# 或简写
+npx ccg
+```
+
+### 方式二：全局安装
+
+```bash
+npm install -g ccg-workflow
+ccg
+```
+
+### 方式三：源码安装
+
+```bash
+git clone https://github.com/fengshao1227/ccg-workflow.git
+cd ccg-workflow/skills-v2
+pnpm install && pnpm build
+pnpm start
+```
+
+### 前置要求
+
+- Node.js 18+
+- Claude Code CLI
+- Codex CLI / Gemini CLI（可选，用于多模型协作）
+
+---
+
+## 交互式菜单
+
+运行后会显示交互式菜单：
+
+```
+  CCG - Claude + Codex + Gemini
+  Multi-Model Collaboration System
+
+? CCG 主菜单
+❯ ➜ 初始化 CCG 配置
+  ➜ 更新工作流
+  ➜ 卸载 CCG
+  ? 帮助
+  ✕ 退出
+```
+
+选择 "初始化 CCG 配置" 进行首次安装，会引导你：
+1. 选择语言（中文/English）
+2. 配置前端模型（Gemini/Codex/Claude）
+3. 配置后端模型（Codex/Gemini/Claude）
+4. 选择协作模式（并行/智能/顺序）
+5. 选择要安装的工作流
+6. 配置 ace-tool MCP（可选）
+
+---
+
+## 使用
+
+```bash
+# 完整的多模型开发工作流（含 Prompt 增强）
+/ccg:dev "实现用户认证功能"
+
+# 智能路由代码生成
+/ccg:code "添加用户注册表单"
+
+# UltraThink 调试
+/ccg:debug "登录接口返回 500 错误"
+
+# 多模型测试生成
+/ccg:test "为用户服务添加单元测试"
+
+# 质量门控修复（90%+ 通过）
+/ccg:bugfix "密码重置邮件发送失败"
+
+# 深度分析
+/ccg:think "评估微服务拆分方案"
+
+# 性能优化
+/ccg:optimize "优化首页加载速度"
+
+# 前端任务 → Gemini
+/ccg:frontend "创建登录表单组件"
+
+# 后端任务 → Codex
+/ccg:backend "实现 JWT 认证中间件"
+
+# 双模型代码审查（无参数自动审查 git diff）
+/ccg:review
+
+# 双模型分析
+/ccg:analyze "这个架构有什么问题？"
+
+# 单独使用 Prompt 增强
+/ccg:enhance "实现用户认证功能"
+
+# Git 智能提交
+/ccg:commit --emoji
+
+# 交互式回滚
+/ccg:rollback --branch main --target v1.0.0
+
+# 清理已合并分支
+/ccg:clean-branches --dry-run
+
+# 创建 Worktree 并用 IDE 打开
+/ccg:worktree add feature-ui -o
+
+# 初始化项目 AI 上下文
+/ccg:init "我的项目"
+```
+
+---
+
+## 命令列表
+
+### 开发工作流
+
+| 命令 | 用途 | 模型路由 |
+|------|------|----------|
+| `/ccg:dev` | 完整6阶段开发工作流（含Prompt增强） | Auggie + Codex + Gemini |
+| `/ccg:code` | 多模型代码生成（智能路由） | 前端→Gemini / 后端→Codex |
+| `/ccg:debug` | UltraThink 多模型调试 | Codex + Gemini 并行诊断 |
+| `/ccg:test` | 多模型测试生成 | Codex 后端测试 + Gemini 前端测试 |
+| `/ccg:bugfix` | 质量门控修复（90%+ 通过） | 双模型交叉验证 |
+| `/ccg:think` | 深度分析 | 双模型并行分析 |
+| `/ccg:optimize` | 性能优化 | Codex 后端 + Gemini 前端 |
+| `/ccg:frontend` | 前端/UI/样式任务 | Gemini |
+| `/ccg:backend` | 后端/逻辑/算法任务 | Codex |
+| `/ccg:review` | 代码审查（无参数自动审查 git diff） | Codex + Gemini |
+| `/ccg:analyze` | 技术分析 | Codex + Gemini |
+| `/ccg:enhance` | Prompt 增强 | Auggie MCP |
+
+### Git 工具
+
+| 命令 | 用途 |
+|------|------|
+| `/ccg:commit` | 智能 commit：分析改动、生成 conventional commit 信息、支持 emoji |
+| `/ccg:rollback` | 交互式回滚：列分支、列版本、二次确认后执行 reset/revert |
+| `/ccg:clean-branches` | 清理分支：安全查找并清理已合并或过期的分支 |
+| `/ccg:worktree` | Worktree 管理：在 `../.ccg/项目名/` 下创建，支持 IDE 集成 |
+
+### 项目初始化
+
+| 命令 | 用途 |
+|------|------|
+| `/ccg:init` | 初始化项目 AI 上下文，生成根级与模块级 CLAUDE.md 索引 |
+
+---
+
+## 工作流程
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                   /ccg:dev 工作流                            │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  Phase 0: Prompt 增强 (Auggie prompt-enhancer)              │
+│      ↓                                                      │
+│  Phase 1: 上下文检索 (Auggie codebase-retrieval)            │
+│      ↓                                                      │
+│  Phase 2: 多模型分析 (Codex ∥ Gemini) ← 并行执行            │
+│      ↓                                                      │
+│  Phase 3: 原型生成                                           │
+│      ├── 前端任务 → Gemini                                  │
+│      └── 后端任务 → Codex                                   │
+│      ↓                                                      │
+│  Phase 4: 代码实施 (Claude 重构为生产级代码)                 │
+│      ↓                                                      │
+│  Phase 5: 审计交付 (Codex ∥ Gemini) ← 并行审查              │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 安装目录结构
+
+安装后会在 `~/.claude/` 和 `~/.ccg/` 下创建：
+
+```
+~/.claude/
+├── commands/ccg/           # 斜杠命令
+│   ├── _config.md          # 共享配置
+│   ├── dev.md              # /ccg:dev 完整工作流
+│   ├── code.md             # /ccg:code 多模型代码生成
+│   ├── frontend.md         # /ccg:frontend 前端任务
+│   ├── backend.md          # /ccg:backend 后端任务
+│   └── ...                 # 其他命令
+└── prompts/ccg/            # 角色提示词
+    ├── codex/
+    │   ├── architect.md    # 后端架构师
+    │   ├── analyzer.md     # 技术分析师
+    │   ├── debugger.md     # 调试专家
+    │   ├── tester.md       # 测试工程师
+    │   ├── reviewer.md     # 代码审查员
+    │   └── optimizer.md    # 性能优化专家
+    ├── gemini/
+    │   ├── frontend.md     # 前端开发专家
+    │   └── ...
+    └── claude/
+        └── ...
+
+~/.ccg/
+└── config.toml             # CCG 配置文件
+```
+
+---
+
+## 配置文件
+
+配置文件位于 `~/.ccg/config.toml`：
+
+```toml
+[general]
+version = "1.0.0"
+language = "zh-CN"
+
+[routing]
+mode = "smart"  # smart | parallel | sequential
+
+[routing.frontend]
+models = ["gemini", "codex", "claude"]
+primary = "gemini"
+strategy = "parallel"
+
+[routing.backend]
+models = ["codex", "gemini", "claude"]
+primary = "codex"
+strategy = "parallel"
+
+[routing.review]
+models = ["codex", "gemini", "claude"]
+strategy = "parallel"
+```
+
+---
+
+## 卸载
+
+```bash
+# 交互式卸载
+npx ccg-workflow
+# 选择 "卸载 CCG"
+```
+
+或手动删除：
+
+```bash
+rm -rf ~/.claude/commands/ccg
+rm -rf ~/.claude/prompts/ccg
+rm -rf ~/.ccg
+```
+
+---
+
+## 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/fengshao1227/ccg-workflow.git
+cd ccg-workflow/skills-v2
+
+# 安装依赖
+pnpm install
+
+# 开发模式
+pnpm dev
+
+# 构建
+pnpm build
+
+# 本地测试
+pnpm start
+
+# 类型检查
+pnpm typecheck
+
+# 代码检查
+pnpm lint
+```
+
+---
+
+## 调用语法
+
+**HEREDOC 语法（推荐）**：
+```bash
+codeagent-wrapper --backend <codex|gemini|claude> - [工作目录] <<'EOF'
+<任务内容>
+EOF
+```
+
+**简单任务**：
+```bash
+codeagent-wrapper --backend codex "简单任务" [工作目录]
+```
+
+**恢复会话**：
+```bash
+codeagent-wrapper --backend codex resume <session_id> - <<'EOF'
+<后续任务>
+EOF
+```
+
+---
+
+## 并行执行
+
+使用 Claude Code 的 `run_in_background: true` 参数实现非阻塞并行：
+
+```
+# 启动后台任务（非阻塞）
+Bash(run_in_background=true): codeagent-wrapper --backend codex ...
+Bash(run_in_background=true): codeagent-wrapper --backend gemini ...
+
+# 获取结果
+TaskOutput: task_id=<task_id>
+```
+
+---
+
+## 安全机制
+
+- **零写入权限**：Codex/Gemini 对文件系统无写入权限
+- **Unified Diff**：所有外部模型输出必须为 Unified Diff Patch 格式
+- **脏原型处理**：外部模型输出视为"脏原型"，需经 Claude 重构
+- **自动备份**：Patch Auggie MCP 时自动备份原文件
+
+---
+
+## 模型分工
+
+| 模型 | 擅长领域 | 使用场景 |
+|------|----------|----------|
+| **Gemini** | 前端、UI/UX、视觉设计 | CSS、React、Vue 组件 |
+| **Codex** | 后端、算法、调试 | API、业务逻辑、性能优化 |
+| **Claude** | 编排、重构、交付 | 工作流控制、代码审核 |
+| **Auggie** | 代码检索、Prompt 增强 | 上下文获取、需求优化 |
+
+---
+
+## 专家系统提示词
+
+调用外部模型时动态注入相应的角色设定，确保输出质量和一致性。
+
+### 角色文件结构
+
+每个命令根据任务类型注入不同的角色提示词：
+
+| 命令 | Codex 角色 | Gemini 角色 |
+|------|-----------|-------------|
+| `/ccg:code`, `/ccg:backend` | `prompts/codex/architect.md` | - |
+| `/ccg:frontend` | - | `prompts/gemini/frontend.md` |
+| `/ccg:analyze`, `/ccg:think`, `/ccg:dev` | `prompts/codex/analyzer.md` | `prompts/gemini/analyzer.md` |
+| `/ccg:debug` | `prompts/codex/debugger.md` | `prompts/gemini/debugger.md` |
+| `/ccg:test` | `prompts/codex/tester.md` | `prompts/gemini/tester.md` |
+| `/ccg:review`, `/ccg:bugfix` | `prompts/codex/reviewer.md` | `prompts/gemini/reviewer.md` |
+| `/ccg:optimize` | `prompts/codex/optimizer.md` | `prompts/gemini/optimizer.md` |
+
+### 动态角色注入
+
+命令执行时，将角色文件内容注入到 `<ROLE>` 标签中：
+
+```bash
+codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
+<ROLE>
+# 读取 prompts/codex/architect.md 的内容并注入
+</ROLE>
+
+<TASK>
+实现后端逻辑: <任务描述>
+
+Context:
+<相关代码>
+</TASK>
+
+OUTPUT: Unified Diff Patch ONLY.
+EOF
+```
+
+### 完整提示词文件
+
+- **Codex 角色**: `prompts/codex/` 目录下的 6 个文件
+- **Gemini 角色**: `prompts/gemini/` 目录下的 6 个文件
+
+---
+
+## 📄 许可证
+
+本项目采用 [MIT License](LICENSE) 开源协议。
+
+Copyright (c) 2025 fengshao1227
+
+---
+
+## 致谢
+
+- **[cexll/myclaude](https://github.com/cexll/myclaude)** - codeagent-wrapper 多后端调用工具的 Go 代码来源，以及 `/ccg:code`、`/ccg:debug`、`/ccg:test`、`/ccg:bugfix`、`/ccg:think`、`/ccg:optimize` 命令的设计参考
+- **[UfoMiao/zcf](https://github.com/UfoMiao/zcf)** - Git 工具（commit、rollback、clean-branches、worktree）和项目初始化（init）命令来源
+- **[GudaStudio/skills](https://github.com/GuDaStudio/skills)** - 智能路由（前端→Gemini、后端→Codex）的设计理念
+- **[linux.do 社区](https://linux.do/t/topic/1280612)** - Auggie MCP prompt-enhancer 补丁

package/bin/ccg.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli.mjs'

package/dist/cli.d.mts

@@ -0,0 +1 @@
+

package/dist/cli.d.ts

@@ -0,0 +1 @@
+

package/dist/cli.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import cac from 'cac';
+import ansis from 'ansis';
+import { r as readCcgConfig, b as initI18n, s as showMainMenu, i as init, a as i18n } from './shared/ccg-workflow.D_RkPyZ0.mjs';
+import 'inquirer';
+import 'node:os';
+import 'pathe';
+import 'i18next';
+import 'fs-extra';
+import 'node:url';
+import 'ora';
+import 'smol-toml';
+
+const version = "1.0.0";
+
+function customizeHelp(sections) {
+  sections.unshift({
+    title: "",
+    body: ansis.cyan.bold(`CCG - Claude + Codex + Gemini v${version}`)
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.commands")),
+    body: [
+      `  ${ansis.cyan("ccg")}              ${i18n.t("cli:help.commandDescriptions.showMenu")}`,
+      `  ${ansis.cyan("ccg init")} | ${ansis.cyan("i")}     ${i18n.t("cli:help.commandDescriptions.initConfig")}`,
+      "",
+      ansis.gray(`  ${i18n.t("cli:help.shortcuts")}`),
+      `  ${ansis.cyan("ccg i")}            ${i18n.t("cli:help.shortcutDescriptions.quickInit")}`
+    ].join("\n")
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.options")),
+    body: [
+      `  ${ansis.green("--lang, -l")} <lang>         ${i18n.t("cli:help.optionDescriptions.displayLanguage")} (zh-CN, en)`,
+      `  ${ansis.green("--force, -f")}               ${i18n.t("cli:help.optionDescriptions.forceOverwrite")}`,
+      `  ${ansis.green("--help, -h")}                ${i18n.t("cli:help.optionDescriptions.displayHelp")}`,
+      `  ${ansis.green("--version, -v")}             ${i18n.t("cli:help.optionDescriptions.displayVersion")}`,
+      "",
+      ansis.gray(`  ${i18n.t("cli:help.nonInteractiveMode")}`),
+      `  ${ansis.green("--skip-prompt, -s")}         ${i18n.t("cli:help.optionDescriptions.skipAllPrompts")}`,
+      `  ${ansis.green("--frontend, -F")} <models>   ${i18n.t("cli:help.optionDescriptions.frontendModels")}`,
+      `  ${ansis.green("--backend, -B")} <models>    ${i18n.t("cli:help.optionDescriptions.backendModels")}`,
+      `  ${ansis.green("--mode, -m")} <mode>         ${i18n.t("cli:help.optionDescriptions.collaborationMode")}`,
+      `  ${ansis.green("--workflows, -w")} <list>    ${i18n.t("cli:help.optionDescriptions.workflows")}`,
+      `  ${ansis.green("--install-dir, -d")} <path>  ${i18n.t("cli:help.optionDescriptions.installDir")}`
+    ].join("\n")
+  });
+  sections.push({
+    title: ansis.yellow(i18n.t("cli:help.examples")),
+    body: [
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.showInteractiveMenu")}`),
+      `  ${ansis.cyan("npx ccg")}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.runFullInitialization")}`),
+      `  ${ansis.cyan("npx ccg init")}`,
+      `  ${ansis.cyan("npx ccg i")}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.customModels")}`),
+      `  ${ansis.cyan("npx ccg i --frontend gemini,codex --backend codex,gemini")}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.parallelMode")}`),
+      `  ${ansis.cyan("npx ccg i --mode parallel")}`,
+      ""
+    ].join("\n")
+  });
+  return sections;
+}
+async function setupCommands(cli) {
+  try {
+    const config = await readCcgConfig();
+    const defaultLang = config?.general?.language || "en";
+    await initI18n(defaultLang);
+  } catch {
+    await initI18n("en");
+  }
+  cli.command("", "Show interactive menu (default)").option("--lang, -l <lang>", "Display language (zh-CN, en)").action(async (options) => {
+    if (options.lang) {
+      await initI18n(options.lang);
+    }
+    await showMainMenu();
+  });
+  cli.command("init", "Initialize CCG multi-model collaboration system").alias("i").option("--lang, -l <lang>", "Display language (zh-CN, en)").option("--force, -f", "Force overwrite existing configuration").option("--skip-prompt, -s", "Skip all interactive prompts (non-interactive mode)").option("--frontend, -F <models>", "Frontend models (comma-separated: gemini,codex,claude)").option("--backend, -B <models>", "Backend models (comma-separated: codex,gemini,claude)").option("--mode, -m <mode>", "Collaboration mode (parallel, smart, sequential)").option("--workflows, -w <workflows>", 'Workflows to install (comma-separated or "all")').option("--install-dir, -d <path>", "Installation directory (default: ~/.claude)").action(async (options) => {
+    if (options.lang) {
+      await initI18n(options.lang);
+    }
+    await init(options);
+  });
+  cli.help((sections) => customizeHelp(sections));
+  cli.version(version);
+}
+
+async function main() {
+  const cli = cac("ccg");
+  await setupCommands(cli);
+  cli.parse();
+}
+main().catch(console.error);