多Agent无人值守跑了4天：14万行代码是怎么编排出来的

视频笔记 · 整理自 @小天fotos 的置顶视频。本文为视频口播内容的文字化整理与要点提炼，尽量保留原意，个别口语误听已按上下文修正（如"压墨"→YAML、"A阵"→Agent、"TOP"→DAG）。

背景

这是他开源项目 Niuma 的第一次大型实战——"用自己重构了自己"：让多 Agent 无人值守连续跑了 4 天，重构自己的项目，产出 14 万行代码、200+ 合并 PR。这期视频是对这 4 天长任务的完整复盘：AI Agent 怎么编排、任务怎么拆分、用了多少 token、踩了哪些坑。

核心观点一：长任务为什么难？

• 把复杂需求丢给一个 AI，一开始做得很好，跑着跑着就跑偏——不是模型不够聪明，是上下文窗口的限制：前面的细节被挤出去，每 compact 一次就忘掉一些，忘几次之后就开始瞎编。
• 即使换成百万上下文的模型也一样，问题只是被推迟了——因为你不可能不 compact。
• 他的解法：让 Agent 不 compact。把任务拆成小块，每个 Agent 都在干净的上下文里做完自己那份工作，然后"交棒"给下一个。

核心观点二：用"图"来编排（Graph Orchestration）

• 用一张图实现整个工作拆分，每个节点是一个 Agent，节点之间不随便聊天，只通过固定格式的结构化数据（交接棒 / handoff）传递信息。
• 每个 Agent 的工作范围和交流方式都被锁死，干完就交棒。
• 这 4 天里，一条流水线被调用了 212 次，几乎所有任务都由它完成。它共 6 个节点、是一条链，每个节点只有一个职责：分析 → 编码 → 跑测试 → 检查证据 → 看代码质量 → 做提交。
• 节点之间支持"一步投递"（handoff）：Coder 改完代码，一次 handoff 同时发给 Tester 和 QualityGate；Tester 收到立即开工，QualityGate 设置了 after-tester 所以会等 Tester 跑完再动。
• 数据可以提前到，但执行顺序由 DAG 锁死——图编排的精细之处。DAG 里可以定义串行、并行、发散、汇聚、打回、循环：测试成功就往下走，失败就打回给 Coder。

核心观点三：交接棒必须是结构化的

• Agent 之间不对话，改完活只写一份固定格式的结构化交接文档。
• 为什么必须这样：固定格式的信息才可能被程序自动检查。自由对话里 Agent 说"我搞定了"，你根本不知道它漏了什么；而交接棒少了一个字段，系统当场就能识别并打回去。
• 通信拓扑：一对一（架构师→程序员→committer）、一对多（调查任务同时分给多个 Agent）、多对一（多份调查报告汇总给一个汇总节点写日报）。
• 每次交棒后都交给节点控制器调度，出现死循环就释放信号让外层编排者接管——总之不用人参与。

核心观点四：编排者是 Codex（不写代码的那个）

启动整张图的是一个 Codex 作为"编排者"，它不做任何 coding，站在人和图之间，职责有三：

1. 分配任务：接收 issue 或语音指令，理解意图，生成结构化任务草稿；
2. 启动图：根据任务类型选一份 YAML 模板，把任务丢进流水线；
3. 监控兜底：不停轮询节点状态（哪个在跑、哪个失败、跑到哪一步），必要时介入或立即停止——随时可以终止、回滚。

他也坦承目前还不完美：Codex 有些过程过度监控，消耗偏大。

核心观点五：为什么用 YAML 定义编排

图、节点、交接规则都不写死在代码里，全部放在 YAML 文件里：

1. 复用：同一份 YAML 模板被调用 212 次，不同任务只是输入的 issue 不同，流水线结构完全相同；
2. 分层独立改进：编排把系统拆成六层——编排标识、图拓扑、Agent 定义、模型 Profile、容器环境、安全边界。模型太贵就改 Profile；某个节点跑偏就改它的 System Prompt；要加一轮 review 就改节点，其他层都不动；
3. 配置决定质量：AI 能不能干好活，取决于 YAML 里写了什么。配置越清楚输出越稳定；每次跑完发现问题，就把改进写回 YAML，下次所有任务都按最新标准执行——所有经验都沉淀在配置里。YAML 不是附属说明，它是整套系统的核心接口。

核心观点六：Scorecard 审计层

AI 干完活不能只听它说"我干完了"。Scorecard 是程序实现的机器审计层，会核查：数据库里的真实记录、节点有没有跑偏、handoff 格式对不对、测试命令有没有真实输出、QualityGate 的三种检查有没有交代、PR 有没有指向正确的 issue……相当于一层机器阅卷，杜绝"口头交差"。

金句摘录

• "不是模型不够聪明，是上下文窗口的限制。"
• "数据可以提前到，但执行顺序由 DAG 锁死。"
• "YAML 不是一个附属说明，它就是整套系统的核心接口。"
• "AI 干完活，你不能只听它说我干完了。"

视频来源

• 作者：小天fotos（抖音号 969304610 / B站 UID 28554995，"输出一手实战型AI生产力方法论，不卖课、不收徒"）
• 原视频：《多Agent无人值守跑了4天，14万行代码，怎么编排的？【B站AI创造公开赛】》
• 发布时间：2026-06-14 ｜ 时长约 9 分钟 ｜ B站播放 3.4 万+
• B站链接：https://www.bilibili.com/video/BV1cuJH6LEvU（同内容亦发布于抖音/小红书 @小天fotos）
• 本文为视频内容的文字整理，版权归原作者所有，转载请注明出处。