2026年8月1日

expectations-checklist 技能——锁定操作者的验收测试

Datarim 如何借助一份结构化的期望文件,在从 PRD 到 QA 再到合规的各个流水线阶段中保留操作者的原始意图,并在愿望未达成时阻断流程。

智能体的质量检查,其可靠性取决于它所对照的目标。当目标只是对操作者意图的转述时——正如验收标准由 PRD 生成时那样——检查就可能悄然偏离操作者真正想要的东西。expectations-checklist 技能的存在,就是为了把原始意图保留为一份独立的、由操作者拥有的产物。

该文件位于 datarim/tasks/{TASK-ID}-expectations.md。它依据 PRD 或计划一次性写入,此后只做追加——绝不重写。每一项都是一条人类可读的愿望,并附带一个具体的成功标准,可通过运行命令或观察可见结果来核验。

文件的创建时机

对于 Level 3 和 Level 4 任务,该文件由架构师在 /dr-prd 期间、验收标准定稿后创建。对于没有 PRD 的 Level 2 任务,由规划者在 /dr-plan 期间创建。Level 1 任务不要求该文件,但可以选择性添加。

围绕它的三份产物构成一个三元组:init-task 文件承载操作者的逐字提示词;task-description 承载智能体的解读与实现说明;expectations 文件承载验收测试。三者用途不同,作者也不同。

schema 与证据类型

每条愿望项都声明一个 evidence_type:empirical(带真实 stdout 的运行时命令)、static(针对源码树的 grep 或文件检查),或 measurement(与预算相比较的数值,例如延迟或覆盖率)。该字段在 schema 版本 2 中为必填,用于告诉 /dr-qa 每条愿望需要产出何种证据。

状态转换遵循固定枚举:pending、met、partial、missed、n-a 或 deleted。历史记录只追加——每次状态变更都会新增一行带日期的记录,绝不覆盖。

阻断式门禁

在 /dr-qa 和 /dr-compliance 阶段,校验器会针对该文件运行,并给出三种判定之一。PASS 表示每条愿望均为 met、not-applicable、pending 或 deleted。CONDITIONAL_PASS 表示部分愿望为 partial 或 missed,但每条都带有操作者撰写、至少十个字符的覆盖说明。BLOCKED 判定会停止流水线,打印未通过的愿望 ID,并发出一个路由 CTA,将工作连同这些愿望 ID 一并引导回 /dr-do。

正是这种路由行为,使 expectations 文件区别于普通的验收标准:未达成的愿望不只是出现在报告里——它会停止流水线,并明确指出需要修复什么。

追加合并与多阶段任务

当 PRD 被修订或任务范围扩大时,新愿望会追加在末尾。已有愿望绝不编辑;任何上下文变化都会以一行历史记录加以记载。对于多阶段的伞形任务,属于后续阶段的愿望在早期阶段全程保持 pending——而不是 n-a,后者会永久将其排除在考虑之外。历史条目会注明所属阶段,以便后续审计者区分“尚未验证”与“被遗漏”。

如需进一步了解 Datarim 流水线,请参阅什么是 Datarim,或查看finishing-a-development-branch 技能,了解期望达成之后会发生什么。