技能 Core

反思

评审阶段工作流 — 经验教训、演进提案(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 戳记(合规报告的截断哈希),归档仅在文件、戳记或报告缺失,或戳记与报告不再匹配时才重新生成。

它做什么

  1. 加载评审者人设以及安全与测试技能以获取上下文
  2. 对照 DoD 审查变更,验证测试通过,检查安全漏洞
  3. 使用反思模板创建反思文档
  4. 记录已知修复决策 — 要么在任务的洞察文件中记录一条经过验证的 known_fix 记录(失败类别、症状、修复步骤、验证、来源),要么显式记录 none;省略该判定会阻止归档
  5. 生成演进提案 — 将每条提案归类为 Class A(内容变更,可直接批准)或 Class B(运营模式变更,须先按演进技能的门禁更新 PRD)。在将某条经验教训以冗余为由拒绝之前,会针对更早的反思运行复发检查;复发的经验教训必须升级为门禁
  6. 运行健康指标检查 — 统计技能、代理、命令总数并与阈值比较。若超出任一阈值,建议运行 /dr-optimize
  7. 识别后续任务并将其返回给 /dr-archive Step 4 以写入待办列表

Class A 与 Class B 门禁

Class A 提案(新增配方、修正描述、更新现有技能)走常规审批。Class B 提案(更改事实来源方向、同步语义、流水线路由、核心契约)须先更新 PRD 才能获批。此门禁是在 <TASK-ID>/<TASK-ID> 事件之后引入的,该事件中一项研究结论被当作常规提案处理,导致 6 小时的方向性错误工作。

失败模式

如果技能加载失败或用户拒绝所有提案,归档流程在 Step 0.5 停止。它不会继续到 Step 1。归档是幂等的 — 重新运行会重新进入 Step 0.5。