用途
ccg-workflow 是一个面向软件开发的多智能体编排工作流。它通过斜杠命令协调三个模型的协作:Claude 担任协调者(Coordinator),Codex CLI 担任后端权威(Backend Authority),Gemini CLI 担任前端权威(Frontend Authority)。该项目派生自 ccg-workflow,并为轻量级 OpenSkill 使用做了简化。
主要能力
核心命令(默认配置档)
| 命令 | 作用 |
|---|---|
| /ccg:propose <what> | 快速路径:想法 → 增强 → 并行分析 → 计划 → 批准 |
| /ccg:explore <topic> | 思考与研究:多模型视角,不创建产物 |
| /ccg:apply [change] | 实施:执行计划中的任务,由协调者编写代码 |
| /ccg:archive [change] | 完成:生成提交、归档产物、清理 |
扩展命令(扩展配置档)
| 命令 | 作用 |
|---|---|
| /ccg:new <name> | 创建带依赖图的变更脚手架 |
| /ccg:continue [change] | 创建下一个就绪(READY)产物(一次一个) |
| /ccg:ff [change] | 快进:一次性创建所有规划产物 |
| /ccg:verify [change] | 多模型并行审查,带结构化评分 |
| /ccg:status [change] | 显示变更的当前状态 |
配置命令
| 命令 | 作用 |
|---|---|
| /ccg:config show | 显示当前配置 |
| /ccg:config init | 在项目根目录生成配置文件 |
| /ccg:config profile | 切换命令配置档(core / expanded / full) |
| /ccg:config schema | 列出、派生或切换工作流模式 |
| /ccg:onboard | 面向新用户的引导式端到端演示 |
每个命令在 commands/ 目录下有详细参考文档,如 commands/propose.md、commands/apply.md、commands/config.md 等。
使用方式
快速路径(大多数用户)
/ccg:propose Add user authentication with OAuth2 → 审阅计划 → 批准 /ccg:apply → 编写代码 /ccg:archive → 提交并完成
扩展路径(复杂功能)
/ccg:new add-oauth2 /ccg:ff ← 快进所有规划 → 审阅计划 → 批准 /ccg:apply ← 实施 /ccg:verify ← 多模型审查 → 如有问题则修复 /ccg:archive ← 提交并完成
探索路径(需求不明确)
/ccg:explore Should we use GraphQL or REST? → 多模型视角 /ccg:new api-redesign /ccg:continue ← 一次一个产物 /ccg:continue /ccg:continue → 审阅计划 → 批准 /ccg:apply /ccg:verify /ccg:archive
架构
系统分为四层:
- 协调者:Claude(自身),负责编排阶段、综合结果、编写代码。
- 后端权威:Codex CLI,负责 API、数据库、算法、安全、性能。
- 前端权威:Gemini CLI,负责 UI/UX、组件、可访问性、响应式设计。
- 编排引擎:codeagent-wrapper,用于调用后端的统一 CLI。
关键原则:外部模型(Codex/Gemini)没有文件系统写入权限,只有协调者编写代码。
多模型编排的完整架构见 references/orchestration.md,包括后端注册与路由、并行调用协议(run_in_background + TaskOutput)、跨阶段会话复用(SESSION_ID + resume)、带依赖拓扑排序的批量并行执行、调用模板、阶段角色文件路由矩阵、错误处理与超时管理。
模式系统
模式定义产物依赖图,即创建什么以及按什么顺序创建。内置模式提供完整的六阶段工作流:增强(Enhance)→ 研究(Research)→ 构思(Ideation)→ 规划(Plan)→ 执行(Execute)→ 审查(Review)。可以派生出自定义变体,例如跳过增强与构思的快速模式,或仅审查模式。
产物依赖图(DAG):
- enhance(根节点)
- research(依赖 enhance)
- ideation(依赖 research,并行 Codex + Gemini)
- plan(依赖 ideation,审批门)
- execute(依赖 plan,协调者编写代码)
- review(依赖 execute,并行 Codex + Gemini)
状态转换:BLOCKED → READY → DONE(基于文件系统检测)。
模式管理命令示例:
/ccg:config schema list # 列出所有模式 /ccg:config schema fork default mine # 派生以自定义 /ccg:config schema use mine # 切换活动模式
配置
提供三级自定义:项目配置(ccg-workflow.yaml,控制模型、信任规则、工作流行为、安全)、自定义模式(ccg-schemas/,控制阶段、依赖、角色分配)、运行时覆盖(环境变量,如 CCG_SCHEMA=fast)。
配置文件关键段落包括 schema、backends(按角色选择模型,如 backend 用 codex、frontend 用 gemini 及 gemini-2.5-pro)、trust(冲突解决,含 backend_domain、frontend_domain、conflict_strategy)、workflow(各阶段行为,如 ideation.parallel、plan.require_approval、review.min_score)、safety(max_files_per_execute、require_user_confirm_before_write、timeout_seconds)。完整注释参考见 config.yaml。
任务类型路由
| 任务类型 | 关键词 | 主后端 | 次后端 |
|---|---|---|---|
| 前端 | page, component, UI, style | Gemini | Codex(API 契约) |
| 后端 | API, endpoint, database, auth | Codex | Gemini(消费方视角) |
| 全栈 | 前后端兼有 | 两者并行 | 交叉验证 |
| 调试 | error, bug, fix, crash | 两者并行 | 领域专家决定 |
| 审查 | review, audit, check | 两者并行 | 交叉验证 |
信任规则
可通过配置的 trust 段设置:后端领域(API、DB、安全)以 trust.backend_domain 为准(默认 Codex);前端领域(UI、UX、可访问性)以 trust.frontend_domain 为准(默认 Gemini);跨领域(架构、测试)由协调者综合;冲突按 trust.conflict_strategy 处理(默认 domain_expert 胜出)。
专家角色提示词
执行专门分析时从 references/roles/ 加载:后端专家(roles/backend-expert.md,API、DB、算法)、前端专家(roles/frontend-expert.md,UI/UX、组件)、后端审查者、前端审查者、后端调试者、前端调试者、优化器(性能调优)、测试者(测试策略)。
脚本
| 脚本 | 用途 | 用法 |
|---|---|---|
| scripts/load_config.py | 加载、校验、查询配置 | --init、--validate、--get、--summary |
| scripts/manage_schema.py | 管理工作流模式 | list、show、fork、validate、which |
| scripts/enhance_prompt.py | 增强模糊提示词 | --prompt "..." [--format json] |
| scripts/score_review.py | 为审查发现评分 | --findings '[...]' [--threshold 80] |
| scripts/generate_plan.py | 生成实施计划 | --requirement "..." --type feature |
安全护栏
- 外部模型零写入权限:只有协调者可修改文件。
- 审批门:代码变更前用户必须批准计划。
- 评分门:审查分数低于阈值会触发迭代。
- 文件变更限制:每次执行阶段有最大文件数。
- 超时保护:模型响应在配置秒数后超时。
- 不杀后台任务:终止前需轮询或询问用户。
适用场景
适合需要在软件开发中让多个模型分工协作的场景,例如前后端任务分流、复杂功能的规划与审查、需求不明确时的多视角探索。轻量场景可用核心配置档的 propose → apply → archive 快速路径,复杂功能可用扩展配置档的 new → ff → apply → verify → archive 流程。
限制
资料未提供安装步骤、支持的运行环境、定价与收费信息、具体的性能或效果指标。该工作流依赖 Claude Code、Codex CLI 与 Gemini CLI 三个模型工具及 codeagent-wrapper 编排引擎,实际可用性受这些依赖约束。