技能 Quality

结构审查

审查产物的组织性、完整性与内部一致性——它作为一份文档是否自洽。在 /dr-plan 和 /dr-qa 加载。

概述

adversarial-review 追问产物是否错误。edge-case-hunter 追问它忽略了哪些输入。本技能提出第三个正交问题:产物是否自洽——作为一份文档,它是否有组织、完整且内部一致,而无论其中任何单条论断是否正确?一份计划可以每一句在事实上都正确,却仍在这里失败,因为两个章节互相矛盾,或某个承诺的章节缺失。

检查内容

  1. 对照产物自身契约的完整性。如果它是计划,每个声明的组件是否都有实现步骤和验证条目?如果它是 PRD,每条验收标准是否都能追溯到某项需求?检验标准是闭合性:没有悬空引用,没有承诺却缺失的章节,没有无归属的需求。
  2. 内部一致性。将产物与自身对照检索。§3 是否假设了 §7 所排除的内容?摘要中的计数是否与枚举列表不同?某处的“MUST”是否在另一处变成了“should”?章节之间的矛盾是产出率最高的结构性缺陷。
  3. 可追溯性。读者能否将每个结论回溯到其前提,并将每项需求向前追溯到其验证?没有记录理由的决策就是断开的链条。
  4. 可运行的步骤顺序。引用了仅由后续步骤产生的输出、或仅在此后才安装的工具的步骤,按所写内容无法运行——文档对自己的执行顺序撒了谎。
  5. 恰当的详细程度。每个章节处于一致的细节层级。一份计划将一个组件规定到行号,却将另一个组件写成“适当处理错误”,这掩盖了规格不足的部分。

计数纪律

每当产物陈述一个计数(“3 个组件”、“五道关卡”),都要对照同一文档中的枚举进行核实。计数漂移表明文档在一处被编辑而另一处没有。发现按缺失、矛盾、不可追溯和计数漂移分组,每组都引用两处位置;实质性缺陷(错误论断、未处理的输入)转交兄弟技能处理,不在此解决。

加载时机

  • /dr-plan——在计划冻结之前,核实它作为一份文档是否自洽。
  • /dr-qa 第 3 层——对产出的产物进行结构性/编辑性检查。