2026年8月18日

反思技能 — 融入每个归档的经验教训

Datarim 的反思技能如何将任务收尾转化为结构化复盘、演进提案和健康检查——每次自动执行。

大多数开发流程在最后一行代码提交时便告结束。Datarim 在关闭任何任务前增加了一个强制步骤:反思。反思技能作为 /dr-archive 的第 0.5 步运行——不是可选的,不是按需触发的,而是每次归档任务时都会执行。

在 Datarim v1.10.0 之前,反思是一个名为 /dr-reflect 的独立命令。它是可选的。这种模式在实践中失败了:反思本应针对每个任务执行,却很容易被跳过。该命令已被停用,其逻辑被移入 /dr-archive 作为一个硬性步骤。反思未完成前,归档无法继续。

该技能产出什么

该技能会在 datarim/reflection/reflection-{task-id}.md 创建一份反思文档。该文档记录了哪些做法有效、哪些效率低下,以及任务暴露出的任何缺失模式。它还会记录一次健康检查:统计当前活动范围内的技能、代理和命令总数,并与既定阈值进行比对。如果超出阈值,该技能会提示运行 /dr-optimize——但不会自动运行它。

范围外漂移检测器是其中较为实用的部分之一。在实现过程中,有时会出现关于已发现但未修复事项的备注:过时的配置、并行漂移、延迟的清理。该技能会扫描实现备注中的这些信号,并自动建议后续待办事项条目。这取代了那种在心里记下“我应该为此提交点什么”然后却不做的非正式习惯。

演进提案

在审查任务之后,该技能会生成演进提案:对技能、代理、命令定义或模板的更改,这些更改将使未来的工作更快或更安全。每个提案被归类为 A 类或 B 类。

A 类涵盖内容更改——规则文本更新、新示例、措辞改进——可以在同一归档周期内提交给操作员审批。B 类涵盖运营模式更改:流水线路由、核心契约、命令语义。这些需要先更新 PRD 才能应用。归档期间出现的 B 类提案会被搁置,直到该 PRD 起草完成;它无法在同一天应用。

在任何已批准的 A 类提案写入框架运行时之前,它需要通过一个与技术栈无关的关卡。该关卡检查提案是否指定了特定的技术栈。如果是,该提案会被框架拒绝,并重定向到项目自己的 AGENTS.md。框架技能保持技术栈中立。在任何已批准的写入之后,会运行完整的测试套件;测试失败会将提案重新标记为已拒绝。

它适合放在哪里

该技能作为 /dr-archive 内的强制第 0.5 步运行。它在内部被调用——操作员通过归档命令与其交互,而非直接调用。它产出的反思文档会反馈到 /dr-archive 第 4 步,在那里后续任务被写入待办事项。

查看Datarim 是什么以了解更广泛的流水线,或阅读关于research-workflow 技能的内容,该技能在周期的另一端为规划阶段提供输入。