跳转到内容
flow — gated build harness for coding agentsflow — gated build harness for coding agentsflow

Agent 编排

每个 stage 可以把起草交给 specialist agent，没装就回退到内置行为，这让 flow 可移植，不依赖别人家的 agent 注册表。优先级是 specialist agent 优先，然后是对等 skill，最后是内置回退。stage 映射跟你想的差不多：research 给 researcher，scope 和 PRD 给 planner，ADR 给 architect，contract 给 spec-oriented kernel，build 给全栈 developer，review 给 code reviewer 或三层敌对评审，上线验证给 tester。

让这套安全只有一句话：agent 可插拔，gate 是固定的。 gate 在每条路上都一样，所以缺 agent 永远降不了 bar，fancy 的 agent 也永远抬不了它没挣到的通过。委托还按设计做上下文隔离——subagent 只拿到它的任务、它的文件、它的验收标准、相关的 law 或 contract 片段，拿不到 session 历史——回来只报几个 verdict 之一：DONE、DONE_WITH_CONCERNS、BLOCKED、NEEDS_CONTEXT。委托之后跑 gate，施加语义挑战，写持久 hook，并宣布到底走了哪条路。

本页是这条规则周围 power surface 的操作者主场：一 agent 一 worktree、可选的额外引擎、recall/promote 循环、指纹绑定的证据。维护者图表留在仓库，只在页脚链接。

多 agent 工作区

Section titled “多 agent 工作区”

几个 agent、几个终端、同 checkout 是陷阱：其中一个切了分支，其他终端全跟着翻。/flow workspace 给每个 agent 自己的 git worktree——自己的 HEAD、自己的 index、自己的文件、共享对象库——这事就不会发生。

/flow workspace add <branch>
/flow workspace add <branch> --card C-NNN --vendor <name> --task "<one line>" --copy-env
/flow workspace list
/flow workspace enter <branch>
/flow workspace check <branch> --card C-NNN
/flow workspace remove <branch>
/flow workspace doctor
  • add <branch> 建树，带不同的端口偏移（两个本地服务不打架），打印一条拿来即用的 cd 和 env 块。可选 flag 钉 card、vendor 标签、任务行、是否把 env 拷进新树。
  • list 看谁在哪。
  • enter <branch> 给挂掉的终端重打印环境。
  • check <branch> --card 在启动前标出分支认领冲突和 allowed-files 重叠。跑它。日后合并冲突，说明这次检查被跳过或糊弄了。
  • remove 拆树，永远不自动 force。git 不让，你自己解决；flow 不会替你 --force。
  • doctor 对账孤儿树并记录。

git 本人是注册表和真锁。git worktree list 是活的；git 拒绝一个分支检出两次，这才是真保护。边上的 .flow/workspaces.jsonl 只在上面加 vendor、card、端口、任务元数据。

用这些动词，让 journal 没有洞。裸 git worktree add 什么都不记。

第二引擎

Section titled “第二引擎”

OpenAI Codex（openai-codex 插件）是可选的第二引擎。Google Antigravity（agy CLI 或 Antigravity IDE）是可选的第三。两个都是额外 vendor，用在同样的高价值时刻，让评审能被很少共享盲点的模型审。哪个都不代替 specialist → skill → 内置这条梯子。默认引擎还是这条梯子。没装 Codex 或 Antigravity，运行不断。

flow 区分装了和可用。装了指插件、二进制、IDE 目录在。可用还要加一个便宜不计费的探针，确认引擎真就绪、真登录。只有可用的引擎才被路由。否则 flow 静默但宣布地降级回正常梯子，gate 不动。

Antigravity 的探针是两个里最严的，原因实测过：agy -p 没登录也返回 exit code 0、stdout 空，错误只进日志文件。所以 flow 只在拿到非空预期输出时才路由给 Antigravity，永远不看 exit code——它撒谎。那个平台无头抓取不可靠，支持的默认是交互式：在 IDE Agent Manager 或真终端里跑评审，把结果贴回来。空的 Gemini 结果意思是“评审不可用”，永远不是批准。

这些调用计费，diff 加 contract 或 PRD 片段会离机，所以恰好三个触发器能打开 cost gate：

  1. 两振僵局——同模型 agent 被拦两次。Antigravity 是更晚的额外引擎：同模型路和第二引擎都卡住，它才上。
  2. security-class card 评审。
  3. 操作者明确 opt-in（“用 Codex 评审这个”、“用 Antigravity 评审这个”、/flow … codex、/flow … antigravity）。

默认永远不对每个 stage 开。敏感、受监管、签了 NDA 的代码库，想清楚再 opt-in：选 Codex 等于把 brief 发给 OpenAI，走你套餐的留存条款；选 Antigravity 等于发给 Google，走你的 Gemini 套餐。认证全权交给插件或 agy / IDE。flow 不读、不存、不记这些凭证。

gate 对等是绝对的。Codex 或 Antigravity 起草或挑刺；一模一样的 stage gate 照样审判。跨模型评审只影响分诊，永远不自动通过、永远不自动打回 card。

用完，flow 宣布哪个引擎跑了（或那 tier 不可用、降级成了什么）。运行保持可读。

知识循环

Section titled “知识循环”

对话窗口会忘。持久 harness——SQLite 库加 RETRO.md、DEBT.md、playbooks/——是闭环的捕获、复用、改进循环，让 agent 驱动的项目像人组成的团队一样积累经验。

捕获是引擎触发的，不是自愿的：

  • 走过 stage 01 种一个 intake
  • 通过的 card check 记一条 tier 打分的 trace
  • 故意的 skip 记它的 debt

复用是 /flow recall。stage 或 card 开工前跑，先别写任何东西。它读回 open debt、最近 retro、上张 card 的 scope、harness 摩擦和 backlog、审计健康、promote 过的 playbook，开工先看到以前的痛，而不是重新发现。

改进也是机械的：harness audit 给熵和漂移打分，harness propose 把重复摩擦挖成改进 backlog（pattern 触发两次及以上），harness decision outcome 闭合预测对实际的环。

resume 开头、recall 跟上的中途仪式在中途接手。

Promote

Section titled “Promote”

教训大过一个项目，就提上去：

/flow promote <playbook.md>

拷进跨项目知识库 ~/.claude/flow/playbooks。从此 recall 到处都能翻到它，不只在学到它的地方。

背书执行

Section titled “背书执行”

运行一旦自治，“这个被评审过”必须是可以被脚本检查的意思。背书执行控制面发指纹绑定的证据——评审过的 stage 或 card 发 semantic_gate 证据，验过的部署发 live_verify 证据——绑在它批准的东西的指纹上。

/flow attest semantic --stage <stage> --revision <rev> --owner <manifest>
/flow attest semantic --card <id> --base <rev> --revision <rev> --owner <manifest>
/flow attest live-verify <id> --revision <rev> --owner <manifest>
/flow attest status [<stage|card>]
/flow attest recover <C-NNN> --mark-failed

铸造对的是已提交 blob 在特定 revision，不是工作区里脏的。live 证据要求精确的 HEAD tip 加重算的指纹，所以批准之后改文件，批准作废，不悄悄继承。status 告诉你证据是否还新鲜。recover … --mark-failed 是 live verify 卡在半空时的 Must-ask 逃生口：它把那次尝试标失败，不铸通过。

/flow auto 开着时，check、CLI 接管的 card 翻转、依赖就绪、删合过的 worktree，都要新鲜证据。/flow auto stop 回到只告警的手动模式。没有暗门。auto halt 规则——含 security-class HALT——在工作何时必须停下。

证据防主体过期。不认证 actor，不防恶意 host。防的是自治循环消费自己过期的批准，不是防掌控机器的人。

维护者文件（不在公开页）：skills/flow/SKILL.md、skills/flow/references/codex-integration.md、skills/flow/references/antigravity-integration.md、skills/flow/references/attestations.md。维护者要的图：docs/system-architecture.md。