SuperAPI AI 工具集

ccg-workflow

编程与开发

查看项目

更新于 11-09 17:17

技能介绍

用途

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 编排引擎,实际可用性受这些依赖约束。