期望清单
以纯 markdown 编写的操作员愿望清单产物——wish_id slug、状态历史、当前状态、覆盖语义。在需求步骤编写,在质量审查和加固步骤验证。
选定的任务文档
自 4.3.3 起,验证器会读取任务描述中的 prd 和 plan 指针,包括显式指定版本的 PRD 和计划。选择损坏即为错误;干净的旧版副本不能替代选定的文档。缺少指针时保留现有的旧版行为和依赖复杂度的行为。期望清单的 parent_prd 必须指向选定的 PRD。任务标识和允许的路径会被检查,但无关的文档元数据和并发写入的原子性不在认证范围内。
概述
期望清单是一份操作员可读的「工作完成后需要验证的事项」列表,对于较大的任务在需求步骤捕获,对于较小的任务在规划步骤捕获。每一项都用操作员自己的话书写——不使用技术术语,不使用缩写——以便非技术读者也能理解。之后,质量审查步骤为每一项分配最终状态,加固步骤再次验证同一列表,归档步骤则以通俗语言将结果与操作员简报一并呈现。
Schema
- Frontmatter——任务标识符、产物类型、schema 版本(新文件以
schema_version: 4写入;v1–v3 仍可读取)、捕获命令、父链接(init-task 文件、需求文档)。 - 每一项都带有一个稳定的 slug(新项使用 ASCII kebab-case;旧版西里尔字母 ID 仍可读取)、一段操作员用语的描述、一条用操作员自己的话表述的成功标准,以及一个可选的、指向需求文档中正式验收标准的链接。
- 状态历史——由每个流水线步骤写入的状态转换运行日志。格式:
<ISO timestamp> / <local time> · <command> · <prior> → <new> · reason: <one-sentence plain text>。 - 当前状态——取值为:pending、met、partial、missed、n-a、deleted 之一。
- 客户绑定(schema v4)——每一项都声明
customer_derived: true | false;值为true的项还带有需求 ID、表面类别、可见性和一个覆盖回执指针。 - 覆盖行(可选)——一种软否决,允许 partial / missed 项不阻断路由。自 2.31.0 起,覆盖带有作者身份检查:操作员撰写的覆盖无条件接受,而 agent 撰写的覆盖必须引用一个允许的类别(time-dependent / external-blocker / operator-authorized / plan-scope-boundary)以及一个存在于 backlog 或任务索引中的产物 ID——agent 不能再仅凭文字自行认证缺口。
语言兼容性
新模板保留稳定的机器键,如 success_criterion、linked_ac、status_history 和 current_status。共享解析器也接受现有的英文标签,如 Operator expectations 和 Related AC from PRD,以及历史俄文标签。每个关联的 V-AC 都会被检查;本地化不会豁免证据、状态或覆盖要求。
验证门
质量审查步骤引入一个专用层,遍历每一项、计算其状态、追加一行历史记录并更新当前状态。随后由内置验证器判定结论是 pass(全部满足或已覆盖)、conditional pass(存在带覆盖的 partial),还是 blocked(存在任何未覆盖的 missed 项)。在 blocked 结论下,失败路由的行动号召会转述重点事项,并提供一个可直接粘贴的命令,以较窄的范围将任务退回实现阶段。
为何采用此 Schema
扁平 markdown 布局使愿望清单可作为普通文档阅读——操作员可以在任意编辑器中浏览、在任意编辑器中编辑,无需任何专用工具即可审阅。运行中的状态历史在多次流水线运行之间保留审计轨迹,因此当同一任务两次经过质量审查(一次中间运行,一次最终运行)时,两次运行都会留下各自的一行记录。
来源
随 Datarim v2.8.0 发布的契约。