用途:the-flow 是 SDD 流水线的单一入口,覆盖从研究到发布的全流程:research(1a explore)、plan(1b plan)、workshop(2c)、ADR(3a)、phase tasks(5)、implement(6)、progress(6a)、review(7)、ship(8),另有条件性 8c reconcile(分支分歧时合并)和维护动词 sync(重建 spine)。
主要能力:内置 Registry 表,将编号与动词绑定到对应子技能模块;两种加载路径——引导模式(/the-flow 或带 slug)读取路由与教练文档,按阶段逐步引导并维护状态;直跳模式(/the-flow <id> <verb> [flags])只加载并执行指定阶段。命令语法统一为 /the-flow <id> <verb> [flags]。逐步披露是核心契约:每次只加载当前步骤所需的一个子技能。
使用方式:引导式入口会自动执行 spine-reconcile(sync),读取 nav 位置并运行 harness flow orient,先打印可复制命令再询问是否执行;直跳模式不带教练、不写状态。发布阶段 push 与开 PR 分别确认,合并需输入 PROCEED。
限制:需要可用的 harness flow CLI(引导模式硬依赖,先做能力预检),缺 CLI 需先运行 harness update 或 npm i -g @ai-substrate/engineering-harness。飞行计划只能由 CLI 生成,禁止手写或手改。旧格式(无 provenance)会返回 E308 并停止,不自动迁移。不运行 /compact,不给时间估算(仅 CS 1–5),不从记忆中即兴补全缺失模块。旧 slug 在读取时按别名表转换到新目标,未映射则询问而不猜测。
分类:编程与开发。