SuperAPI AI 工具集

behavior-first-planning

测试与质量

查看项目

更新于 10-15 17:29

技能介绍

用途:把意图转成每个都带有可运行验收测试的 beads,让「完成」有机器可判定的标准,取代只有标题和散文式理由的 spec-first 规划。产物依次为冻结的 Gherkin、已执行呈红的测试、推导出的规格、带验收门禁的 bead DAG。

四个阶段按序执行:一、Behaviors,先定义完成标准,写成具体可测的 Given/When/Then,覆盖正常、边界与错误/失败路径,明确失败路径须中止/阻断而非静默通过;结果写入 behaviors.md 并冻结。可请独立对抗者补列缺失场景并逐一处置。二、验收测试,把每个冻结场景写成项目框架下的可运行测试,放在 acceptance-tests/,并写 acceptance-tests.md 映射场景 id 到测试名/路径及运行命令;必须实际运行并报告红/绿/框架错误的机械结果,已通过或框架报错都不算有效红,每个测试单独一次调用。三、Spec,推导出仅以让验收测试通过为目标的规格,写入 spec.md。四、带验收门禁的 bead DAG,每个 bead 须带 scenario_ref(真实冻结场景 id)和 acceptance_test(可调用命令加测试路径),再机械计算门禁:测试可运行、引用有效、覆盖完整、无环。任一检查不过即拒写。每切片只含一个行为,可用 bash scripts/check-slice-batch-size.sh <bead-id> 机械校验。

收口门禁:写入 tracker 前,先产出 bead-manifest.json 清单,交独立且跨家族的评审者按冻结行为评分并抽跑至少两条验收命令,仅在通过且覆盖完整、无环、漂移守卫为绿时才写入 tracker;使用主检出的 br,不用 worktree。

与 bdd-foundry 工作流的关系:该工作流是此纪律之上的薄编排器,按阶段派发黑盒 agent 并做机械门禁;直接调用本技能时自行执行四阶段并手用同一套门禁。

限制与禁止事项:不得在清单通过覆盖、无环、可运行测试、独立评审四道门禁前创建 tracker bead;不接受纯散文、见规格或未运行测试作为验收;不得自评自己的计划;不重复 operating-loop 中较轻的单 BDD 意图阶段,此技能用于 beads 必须真正达到可执行就绪时。具体脚本细节、命令参数与平台支持以仓库资料为准,资料未提供更多环境或收费信息。