附录 C. 应用 SDD 检查清单

本附录可作为应用周期中的快速参考。它建立在第一卷的附录 C之上：其中的基础检查清单（规范前、实现前、合并前）在此不再重复。流程模板（合并请求、回顾、最小 /clear 请求和重新规划）已移至 [examples/templates/](examples/templates/)：pr-template.md、retrospective.md、clear-prompt.md、replan-prompt.md。

开始应用卷之前

• [ ] 已阅读第 0 部分，已选择一个学习用 incident-case。
• [ ] 清楚各章节中哪些命令具有 [runnable] 状态，哪些标记为 [project script]。
• [ ] 已创建或已规划 capstone/ 目录用于最终包。
• [ ] 从第一卷中理解 requirements.md、plan.md、validation.md、QWEN.md 和证据包。
• [ ] 已选择阅读模式：学习最小路径或完整生产路径。

从遗留系统恢复规范之前

• [ ] 所有来源均已列出，包含所有者和链接。
• [ ] 事件时间已标准化。

• [ ] 需求已与背景上下文分离。
• [ ] 每条断言都有证据支持，或标记为假设。
• [ ] 争议项未进入已批准合同。

启动毒化规范之前

• [ ] 恰好引入一个缺陷。
• [ ] 已描述预期故障症状。
• [ ] 存在恢复标准。
• [ ] 修复必须更改 spec/plan/validation，而非仅更改说明。

启用规范网关（Spec CI）之前

• [ ] 需求具有稳定的 REQ-* 标识符。
• [ ] 计划项引用需求。
• [ ] 覆盖范围检查依赖领域模型或 API 合同。
• [ ] validation.md 中的 JSON 示例通过模式验证。
• [ ] CI 错误包含文件、行、规则、原因和操作。

对有争议变更进行文件仲裁之前

• [ ] 协调者、实现者和验证者角色已提前描述。
• [ ] 验证者仅接受可验证的证据。
• [ ] 争议通过文件差异（diff）解决，而非聊天中的争论。
• [ ] 重复决策进入 precedents.md。
• [ ] 存在手动审查的停止条件。

优化生产指标之前

• [ ] 目标指标已与质量不变量分离。
• [ ] 存在古德哈特情景的红色按钮规则。
• [ ] 重放不仅检查聚合值，还检查行为漂移。
• [ ] 痕迹包含决策来源、策略版本、提示哈希或其他可复现标识符。
• [ ] 阈值变更作为风险变更处理，而非 YAML 的修饰性修改。

自动修复之前

• [ ] 已知影响半径。
• [ ] 存在试运行（dry-run）或安全预检。
• [ ] 回滚条件在执行前已记录。
• [ ] 在不确定性、重复失败或影响半径扩大时启用人工确认。
• [ ] 若风险较高，事件在获得两个独立恢复确认前不关闭。

审计应用周期反模式之前

完整症状和原因分析见第 12 部分。此处为 12 个问题的快速检查清单。

• [ ] constitution.md 在执行前作为网关生效，而非仅作为事后审查。
• [ ] mutable_rules 中没有无 ttl 或 ttl 超过 90 天的规则。

• [ ] 毒化规范失败后至少更改一个工件（requirements.md、plan.md、validation.md），而非仅更改说明。
• [ ] 验证者使用反例、日志 hook 或 JSON Schema——而非自由文本。
• [ ] governance_protocol 包含 Safety 的否决权和确定性的平局决胜机制。
• [ ] 可运行命令（[runnable]）与 [project script] 接口明确分离。
• [ ] 每个目标指标都配对一个反古德哈特指标。
• [ ] CI 失败时修复代码，而非放宽 validation.md。
• [ ] 层级切换具有预算上限和应急模式。
• [ ] QWEN.md 的每条记录都有作者、证据和 ttl。
• [ ] manual_review_floor 不随 KPI 值变化而保留。
• [ ] 痕迹的每条记录都填写了 evidence_ref。

若三项及以上回答为否定——不要添加新的自动化层；先关闭当前回路中的缺陷。

最终生产考核之前

• [ ] capstone/README.md 无需聊天历史即可解释案例。
• [ ] genealogy.md 包含需求、来源、置信度水平和开放问题。

• [ ] 毒化/修复对包含一个缺陷和一个可验证的修复。
• [ ] validation.md 至少引用一个实际运行的 runnable 示例或其项目类比。
• [ ] judgment.md 包含裁决、原因、evidence_ref 和下一步。
• [ ] 预算层和反古德哈特层各至少有一个阻塞性不变量。
• [ ] Readiness 结论将阻塞项与改进项分离。
• [ ] 第 12 部分的诊断检查清单已完成，否定回答有所有者和下一个检查点。