2026年7月28日

dr-next-snapshot-replay 技能 — 阶段快照消费契约

介绍 /dr-next 如何读取阶段快照、校验快照、组装恢复提示词,并路由到正确的下一条命令——无需重新读取完整任务历史。

每次运行 /dr-next 时,它的第一个动作就是查找位于 datarim/snapshots/{TASK-ID}.snapshot.md 的快照。dr-next-snapshot-replay 技能定义了接下来发生之事的精确契约:快照如何被校验、校验通过时输出何种形态的提示词,以及校验未通过时如何静默处理。

使用前先校验

快照不会被无条件信任。校验脚本——check-stage-snapshot-on-exit.sh --validate-frontmatter --task <ID>——必须以退出码 0 结束,快照内容才能进入恢复提示词。如果脚本以任何其他退出码结束,该技能会静默回退到标准读取流水线:依次为 task-description、init-task、activeContext。不会出现警告消息,也不会中断——操作者只是得到一条稍慢但完整的恢复路径。

之所以采用这种回退策略,是因为损坏或不完整的快照比没有快照更糟。静默回退意味着操作者在恢复前永远不需要手动清除坏快照。

重放提示词

校验通过后,该技能会以固定形态组装一条重放提示词。提示词以快照 frontmatter 中的 recommended_next 值开头——即上一阶段建议作为自然延续的命令——随后是一个双语执行块。无论运行时区域设置如何,该块在每条重放提示词中都会以俄语和英语同时出现。原因很实际:/dr-next 运行在 Claude Code、Codex CLI 和英语区域设置的代理之下。双语块可确保执行指令无论哪个运行时处于活动状态都能传达给模型。

随后快照正文会以字面量 done before: 标题出现,为模型提供一份已完成内容的紧凑记录。

推荐命令如何选择

该技能记录了一套用于评估快照中 recommended_next 提示的启发式规则。核心原则是最大化解决方案的边际质量提升。对于刚完成计划但验证轮次较少的复杂任务,优先选择 /dr-verify,而不是直接跳到 /dr-do——一次验证结论的代价远低于回滚一个建立在未被发现的偏差之上的实现。当验证已饱和且实现已完成时,/dr-archive 就是自然的下一步。

操作者始终可以通过输入其他命令来覆盖该建议。重放提示词会显示推荐,但不会阻止覆盖。

快照从何而来

生产方是 stage-snapshot-writer 技能,它在每个流水线阶段结束时运行,并写出该技能稍后读取的快照文件。这里的消费方契约——dr-next-snapshot-replay——只定义读取侧。orchestrator 插件在其子代理解析器之前集成了同一契约,将 recommended_next 作为提示传入,解析器可以接受或覆盖它。

另请参阅 /dr-next 命令文章了解命令级行为,以及 Datarim 是什么了解更广泛的背景。