反思
评审阶段工作流 — 经验教训、演进提案(Class A/B 门禁)、健康指标检查。在 /dr-compliance 运行;/dr-archive 的 Step 0.5 仅在缺失或过期时重新生成。
概述
Reflecting 是强制性的反思门禁。它主要在 /dr-compliance 判定通过时运行;/dr-archive 的 Step 0.5 是新鲜度兜底,仅在反思缺失或过期时重新生成。它对每个已完成任务运行,回顾发生了什么、提炼经验教训,并提出框架改进建议。自 v1.10.0 起,它取代了原先可选的 /dr-reflect 命令 — 因为反思本应在每个任务上执行,而作为独立阶段却很容易被跳过。
调用契约
此技能不是独立命令。它由 /dr-compliance(主要)或 /dr-archive 的 Step 0.5(兜底)在内部加载。输入是来自 datarim/tasks.md 和 datarim/activeContext.md 的已解析任务状态。输出是位于 datarim/reflection/reflection-{task-id}.md 的反思文档,外加可选的已批准 Class A 演进变更,以及返回给 /dr-archive Step 4 的后续任务列表。新鲜度由 dev-tools/reflection-freshness.sh 判定:反思带有 reflection_basis 戳记(合规报告的截断哈希),归档仅在文件、戳记或报告缺失,或戳记与报告不再匹配时才重新生成。
它做什么
- 加载评审者人设以及安全与测试技能以获取上下文
- 对照 DoD 审查变更,验证测试通过,检查安全漏洞
- 使用反思模板创建反思文档
- 记录已知修复决策 — 要么在任务的洞察文件中记录一条经过验证的
known_fix记录(失败类别、症状、修复步骤、验证、来源),要么显式记录none;省略该判定会阻止归档 - 生成演进提案 — 将每条提案归类为 Class A(内容变更,可直接批准)或 Class B(运营模式变更,须先按演进技能的门禁更新 PRD)。在将某条经验教训以冗余为由拒绝之前,会针对更早的反思运行复发检查;复发的经验教训必须升级为门禁
- 运行健康指标检查 — 统计技能、代理、命令总数并与阈值比较。若超出任一阈值,建议运行
/dr-optimize - 识别后续任务并将其返回给
/dr-archiveStep 4 以写入待办列表
Class A 与 Class B 门禁
Class A 提案(新增配方、修正描述、更新现有技能)走常规审批。Class B 提案(更改事实来源方向、同步语义、流水线路由、核心契约)须先更新 PRD 才能获批。此门禁是在 <TASK-ID>/<TASK-ID> 事件之后引入的,该事件中一项研究结论被当作常规提案处理,导致 6 小时的方向性错误工作。
失败模式
如果技能加载失败或用户拒绝所有提案,归档流程在 Step 0.5 停止。它不会继续到 Step 1。归档是幂等的 — 重新运行会重新进入 Step 0.5。