运行时依赖
版本
运行最小集成验证
安装命令
点击复制技能文档
Taku Build - 可审计的实现构建 实现批准的合同,并为审查提供足够的证据,以决定工作是否可以发布。 规则标签: [IRON LAW] 表示不可商量的正确性约束。 [GUIDANCE] 表示可能根据上下文进行调整的强烈默认值。 [IRON LAW] 没有失败的测试、重现或显式验证锚点的生产代码是不允许的。如果仓库缺少测试框架,请创建最小的可重现检查并说明原因。
预飞行 编辑前:阅读 PLAN.md、批准的快速小设计或显式用户批准的任务合同。 如果计划有 Build Agent 合同,请先阅读必需字段并仅将可选字段用于上下文。 加载 references/tdd.md 以进行本地 TDD 循环。 仅在需要隔离时使用 references/worktrees.md。 自行选择执行模式:顺序、并行或混合。 除非选择改变产品范围、成本或风险,否则不要要求用户选择模式。
输出合同 构建以三种稳定的形式进行交流。 BUILD PREFLIGHT BUILD PREFLIGHT
- 模式:顺序 | 并行 | 混合
- 原因:[一句话]
- 子代理:可用 | 不可用;使用顺序波执行
- 波:[波-slug:任务-slug 列表,或波-1 单任务]
- 工作树:不需要 | [路径]
- TDD:启用
- 账本:
- 下一步:[第一个波/任务]
- 已完成:[波-slug 或任务-slug]
- 任务:[任务-slug 列表]
- 结果:[测试/重现/规格检查观察]
- 偏差:无 | 批准:[...] | 需要审查:[...]
- 账本增量:[仅更改的行]
- 下一步:[下一个波/任务或审查]
- 执行的波:[...]
- 任务账本:[所有完成 | 异常列出]
- 更改的文件:[...]
- 验证证据:[命令和结果]
- 偏差:无 | 批准:[...] | 需要审查:[...]
- 残余风险:无 | [...]
- 状态:READY_FOR_REVIEW | BLOCKED
- 下一步:审查
账本是交接工件,而不是日记。 每个任务保留一行,包含以下字段:任务-slug、文件、tdd、状态、偏差、证据。
模式选择 顺序:任务紧密耦合或只有 1-2 个明显步骤。 并行:任务独立且触及不相交的文件。 混合:波依赖于早期波,但波内的任务是独立的。 保留计划任务 ID 时可用。 如果计划缺少 ID,请创建稳定的 kebab-case slug。 如果文件出现在多个任务中,则这些任务是依赖的,不能并行运行。 当子代理不可用时,保持相同的波调度并按顺序本地执行每个波。 在 BUILD PREFLIGHT 中报告。
执行循环 对于每个任务或波: 标记账本行(s)为 in_progress。 创建失败的测试、重现或验证锚点。 实现满足规格的最小更改。 运行任务验证。 检查规格合规性,然后检查代码质量。 使用状态、证据和偏差更新账本。 发出 BUILD UPDATE。 不要将任务标记为完成,直到其规格和 TDD/验证锚点有证据。
偏差政策 使用批准的合同作为边界。 偏差=无:实现与计划匹配。 偏差=批准:用户显式批准了差异;在后续摘要中保留批准。 偏差=需要审查:实现与计划不同且未获得批准。 需要审查的偏差会阻止 READY_FOR_REVIEW,除非偏差是唯一安全的路径并且为审查明确记录。
调解 在每个并行或混合波之后: 检查重叠的文件更改 运行最小的集成验证 验证没有任务泄漏到其分配的文件之外而没有记录偏差 调解是必需的,即使所有单个任务都报告完成。
完成门 在路由到审查之前: 每个任务都完成或明确未完成,带有原因 每个完成的任务都有证据 所有偏差都是无、批准或需要审查 更改的文件被列出 验证证据被列出 然后发出 BUILD COMPLETE 并路由到 /taku-review。
已知陷阱 审查时账本丢失。 审查无法区分批准的偏差和范围漂移。 预防:在 BUILD PREFLIGHT 中创建账本,并在每个更新中保留任务 slug。 并行任务触及同一个文件。 一个任务覆盖了另一个任务。 预防:重复文件路径创建依赖关系;顺序运行它们。 在测试框架失败后跳过 TDD 锚点。 代理称代码“可能正确”。 预防:调试或限制框架失败,然后在声明完成之前保留可验证的锚点。