Init-task 持久化
逐字记录操作员简报的产物契约——frontmatter + 追加日志 + 问答往返自动追加 + 每条流水线命令强制读取。作为任务全生命周期内操作员意图的唯一事实来源。
概述
Init-task 持久化是操作员原始提示词的事实来源契约。当操作员调用 init 命令时,Datarim 会写入一个按任务划分的文件,逐字记录提示词。该文件在整个任务生命周期内存在,并在操作员后续添加澄清或更正时被追加(绝不覆盖)。之后每一条流水线命令——需求、规划、设计、实现、评审、加固、归档——都必须在其第一步读取该文件,并标记操作员所述意图与计划或已实现工作之间的任何偏差。
为何存在
操作员简报会漂移。任务开始时告知 agent 的自由形式提示词,会被需求步骤转述,然后被规划步骤再次转述,再被实现步骤收窄。三次转述之后,agent 的理解可能已偏离操作员最初的要求。init-task 文件是不可变的锚点——原始提示词的字面文本——因此每个后续步骤都能重新锚定到它。追加日志部分让操作员可以添加新约束或更正而不丢失原始锚点;agent 必须读取完整的追加日志,而不仅仅是顶部区块。
文件布局
- Frontmatter(封闭 schema)——七个必填字段(任务标识符、产物类型、schema 版本、捕获日期、捕获命令、操作员标识符、状态),外加一个推荐的 source 字段和可选的按任务策略字段,例如浏览器 QA 模式。校验器会拒绝缺少任何必填字段的文件。
- 操作员简报(逐字)——交给 init 命令的确切文本,不重述、不概括。
- 追加日志(操作员修订)——按时间顺序的追加内容,每条都带有时间戳和作者签名。agent 必须读取每一条记录,而不仅仅是最新的一条。
校验器
一个内置工具(dev-tools/check-init-task-presence.sh)按任务验证 schema 正确性(--task ID),并扫描活动任务集以查找缺失文件(--all)。30 天滚动软窗口意味着没有 init-task 文件的遗留任务永远不会阻塞流水线:不足 30 天为 info 级发现,超过 30 天为 warn 级发现,绝不阻塞。对现有任务采用为可选加入,对契约落地后创建的新任务则为强制。
跨流水线强制读取
流水线中的每条命令都在其第一步读取 init-task 文件。agent 必须在任务描述的 Implementation Notes 部分引用与操作员简报的偏差;评审和加固命令带有明确的偏差检查。
问答往返自动追加(v2.9.0)
流水线阶段中每一轮操作员澄清现在都会自动落入追加日志。六条流水线命令——需求、规划、设计、实现、评审、加固——会调用一个小工具写入结构化区块:逐字的问题、逐字的回答、一行说明该轮如何改变初始条件的摘要,以及一个标记,指示是操作员作答还是 agent 自主决定。当 agent 自行决定时(因为操作员不可用或问题非关键),该区块必须附带至少 50 个字符的理由,说明该选择的最佳实践依据。评审命令在专门的子检查中对照实现验证每一项自主决定;任何与现有愿望之间未闭合的矛盾都会阻塞总体结论,并将任务退回聚焦返工。
来源
契约随 Datarim v2.8.0 发布;问答往返扩展随 Datarim v2.9.0 发布。