Ibrahim-3d/orchestrator-supaconductor

Multi-agent orchestration system for Claude Code with parallel execution, automated quality gates, Board of Directors, and bundled Superpowers skills

SupaConductor – AI 驱动的“软件工程师即服务”

它是什么 – SupaConductor 是一个适用于 Anthropic Claude Code 的插件（通过适配器也支持 Codex、Cursor、Google Antigravity、Windsurf 和 GitHub Copilot）。它能让编码代理像一个小型开发团队一样运作。您只需给出一个自然语言目标（例如“新增 Google-OAuth 登录”），插件就会自动：

编写详细规格。
将工作拆解为任务依赖图。
执行这些任务（尽可能并行处理）。
运行内置评估器（UI/UX、代码质量、集成测试、业务逻辑）。
修复任何失败并重复循环，直到所有检查通过。

这一切都通过以 /orchestrator-supaconductor: 开头的 斜线指令 进行编排。

核心概念

概念	角色
Orchestrator	执行“评估循环”（规划 → 评估规划 → 执行 → 评估执行 → 修复 → 完成）的中央控制器。
Agents / Skills	执行规划、编码、测试和评估的小型自主工作者（15 个代理，39 个技能）。
Evaluators	四个质量检查模块（UI/UX、代码质量、集成测试、业务逻辑）。
Board of Directors	五位虚拟主管（架构师、产品经理、安全专家、运维专家、体验设计师），可针对重大决策进行审议。
Lead Engineers	提供架构、产品、QA 和技术建议的虚拟专家。
`conductor/` folder	项目本地元数据（规格、计划、追踪注册表、决策日志、知识模式）。

如何使用

安装 – 通过 Claude Code 市场，或克隆存储库并运行 scripts/build-platform-adapters.py 来生成其他主机的适配器。
初始设置 – 每个项目执行一次 /orchestrator-supaconductor:setup。它会创建 conductor/ 目录并询问关于您的代码库和技术栈的问题。
设定目标 – 例如 /orchestrator-supaconductor:go Add Stripe payment integration with webhooks。
观察循环 – 插件会自动规划、执行、评估和修复。您可以使用 /orchestrator-supaconductor:status 查看进度。
控制模式 – 编辑 conductor/config.json 选择 agentic（全自动）或 human-in-the-loop（在关键步骤暂停等待您的输入）。

主要指令（快速参考）

指令	功能
`:go <goal>`	针对描述的功能/错误启动完整的端到端追踪。
`:setup`	引导建立 `conductor/` 文件夹和初始冲刺。
`:status`	列出所有活动中的追踪及其当前步骤。
`:implement`	手动推进当前追踪的评估循环。
`:board-meeting <topic>`	执行完整的虚拟董事会审议（书面理由、投票）。
`:board-review <topic>`	快速董事会评估（更快、细节较少）。
`:cto-advisor`, `:ux-designer`, …	向虚拟主管询问架构、设计等建议。
`:loop-planner`, `:loop-executor`, `:loop-fixer`	运行循环的各个阶段以进行细粒度控制。

架构概览

/go <goal> → Orchestrator → (Plan → Eval-Plan → Execute → Eval-Exec → Fix) × n → Complete

每个阶段由专门的代理/技能处理。
并行调度器同时执行独立任务。
评估器将结果反馈给编排器，可能会触发最多 5 次修复循环或 3 次计划修订。
决策日志和知识文件以纯 Markdown/JSON 格式存储在 conductor/ 中，以便人工审计。

成本与性能

使用 Claude API；规划/评估在 Opus 上运行，执行在 Sonnet 上。
Token 使用量约为单次手动 Claude 对话的 3-5 倍，因为有多个代理同时运行，但系统会自动优化成本（例如对常规编码使用较便宜的模型）。
上下文使用是模块化的 – 只有活动技能会加载其约 5k token 的提示词，将主要对话保持在约 4k token 以下。

适用对象

希望自动化重复性功能开发或错误修复循环的团队。
偏好针对多文件变更使用“设置后即忘”工作流程的独立开发者。
正在实验 AI 增强开发管线并寻找即插即用编排层的组织。

限制

不适合微小的单文件编辑 – 开销大于效益。
需要支持的编码代理主机（Claude Code 为参考标准；其他需要生成的适配器）。
API 成本高于手动提示；您可能需要监控使用量。

社区与贡献

讨论、问题和路线图托管在 GitHub 上。
采用 AGPL-3.0 授权；包含 MIT 授权的 Superpowers 库。

总结 – SupaConductor 是一个真实的开源编排层，将编码代理转变为一个微型、自我管理的工程团队。它是为 Claude Code 构建的，但也为其他 AI 编码助手提供了适配器，让您只需描述一次功能，即可让 AI 自动处理规划、实现、测试和质量保证。