Orchestrator — 常见问题

关于这支十角色 AI 团队的回答：你做什么、它做什么、哪些保证由代码而不是提示词强制执行。

1. Orchestrator 是什么？

   Orchestrator 为一人公司组建一支 AI 团队。你说一句话，它读你的仓库、把活拆成一片一片、出一份方案给你批，然后在你不用打开的容器里构建、测试、审查，最后开一个 PR。以一个二进制、MIT 协议发布在 github.com/pamin-labs/orchestrator。

2. 我到底要做什么？

   三件事。说一句话。批方案——不对就打回，它重出一版。合并。凡不是「带证据的决定」的步骤都被委托出去；阻塞会到你面前，噪音不会。

3. 和单个编码智能体有什么不同？

   十个角色，边界是真的。只有 Engineer 写代码。另外两个审它，都不是作者：QA 拿这一片的 diff 对着验收标准验，Auditor 在组外、换一个模型、读整个分支。Dispatcher 把你那句话拆成片，Architect 给每个组分定文件路径让两个组撞不上，Scribe 照着做完的 diff 写 commit 和 PR。加一个角色是写一个 YAML，不是改代码。

4. 怎么知道一件事真的做完了？

   一片必须先跑通你项目自己的命令——测试、typecheck、lint——才算数。看退出码，不看智能体怎么说；也不给百分比，面板只显示哪几项过了。每片结束时，把「它声称改了什么」与 git 里真实的 diff 对一遍，对不上当场暴露，不用等你读 PR 才发现。

5. 沙箱挡住什么？

   三件事。动你的电脑：容器里只有这个项目的一份克隆，你别的项目、家目录、工作副本都不在里面。拿到你的真 token：容器里放的是格式对但用不了的假值，真 token 在请求出网那一刻由容器外替换进去。往你仓库里推东西：组里的凭据只够拉代码，推是另一个没有智能体的容器干的。

6. 沙箱挡不住什么？

   两件事，直说。数据出去——网络默认放行，因为智能体要查文档、装依赖；介意的话第一次跑之前先配好 sandbox.denyDomains。以及组内角色之间——一个组共用一个容器，隔离是组与组之间的，不是组内角色之间的。

7. 为什么不把规矩写进提示词就好？

   因为提示词到第二十轮就被忘了。凡是能用检查卡住的都写进代码：哪个组能碰哪些文件、笔记多长、谁去推卡住的状态，以及要你点头那张卡的 12 行硬上限。你批的是方向和验收标准，不是一堵实现细节的墙。

8. 跑起来需要什么？

   Docker、uv，以及 Claude 和/或 ChatGPT 订阅。不需要 bun、node、任何工具链。两步：在有 Docker 的机器上把沙箱服务器跑一次，然后跑 orchestrator 本体。