init-task-persistence 技能——以操作者意图为事实来源
init-task-persistence 如何在 /dr-init 时逐字捕获操作者的原始提示词,在整个流水线中保持其仅追加,并让后续每条命令都与之核对。
流水线产出的每一份工件都是一次转述。PRD 转述了需求简报。计划转述了 PRD。等到实现开始时,原始请求已经经过了多层解读。init-task-persistence 技能的存在,就是为了保留一份未经转述的记录:操作者在 /dr-init 时输入的确切文本。
该记录位于 datarim/tasks/{TASK-ID}-init-task.md。它只创建一次,永不覆盖——操作者可以追加内容,但顶部的逐字简报保持原样。后续每条流水线命令都会读取整个文件(包括任何修订),并且必须在其自身输出中呈现分歧。
文件结构与 frontmatter
该文件采用封闭的 frontmatter 模式:任务 ID、工件类型、模式版本、创建日期、操作者名称,以及一个状态字段——初始为 canonical,在操作者首次追加时翻转为 amended。正文包含三个部分:源命令块、逐字操作者简报,以及一个初始为空的追加日志。
追加日志是增长面。操作者在那里添加修订;流水线命令为它们获得的每次澄清在那里追加问答块。每个问答块记录问题、答案、决策者,以及该决策如何改变初始条件的摘要。当决策由智能体而非操作者做出时,需要至少 50 个字符的理由说明,指明其所依据的框架规则或先例。
为什么问答轮次数量很重要
对于 L3+ 任务——跨越多个会话的史诗——规范分解模式会在三个组中产生五轮或更多:在 /dr-init 进行一轮范围澄清,在 /dr-prd 进行一轮分解为里程碑和子任务,以及在 /dr-do 会话期间进行一轮或多轮实现中途澄清。一个跨越五个会话的史诗留下七轮问答轨迹是正常的,并非优柔寡断的迹象。值得关注的信号恰恰相反:一个问答轮次少于两轮的 L3+ 史诗,通常隐藏着从未被呈现的隐式决策,并且更有可能在之后需要返工周期。
对于 L1-L2 任务,四轮或更多通常表明范围估算错误,或所问问题在操作者简报中已有答案。
校验与向后兼容
dev-tools/check-init-task-presence.sh 处的校验器可检查单个任务或所有任务。每个任务从其创建日期起有 30 天的软窗口:在该窗口内缺少 init-task 文件属于 info 级发现,而非阻断项。30 天后则变为 warn。带有 status: archived 或 legacy: true 标记的任务永远不会被标记。
如果某个流水线阶段需要该文件,而由于跳过了 /dr-init 导致文件不存在,该阶段会就地创建一个最小版本,用任务描述作为逐字简报的替代,并将来源标记为追溯回填。归档时该文件永远不会被删除——init-task 何时缺失、何时被恢复的记录,是任务历史的一部分。
阅读什么是 Datarim以了解更广泛的背景,或查看关于human-summary 技能的相关文章,了解流水线如何在每个阶段结束时以通俗语言呈现操作者意图。