按 YAML 规则清单评审

以下示例与示意结果由本站编写，用于说明方法，不是模型实测结果。

使用场景

用版本化规则审查迁移方案：缺必需回退应阻断，缺摘要只给建议。教学规则SAFE-1与DOC-1若都被当成“一有问题就失败”，结果无法反映政策。

具体做法

从明确的项目权威建立规则版本、稳定ID、适用条件、判据及失败动作。用YAML存储后先校验结构，再运行或人工按实际判据评估。每项返回pass/fail/needs_review与证据；未知不是通过。汇总阻断项和建议项，保留规则版本，不能把文案出现某词当作真实满足。

反例

评审提到任何担忧就失败，或只要YAML存在就视为规则执行完毕。

改进写法

按教学rules-v1逐项评估：SAFE-1检查必需回退，失败block；DOC-1检查摘要，失败advise。返回规则ID、版本、判定与证据位置；证据无法取得为needs_review，不能pass。汇总时保留不同失败动作。

为什么这样改

规则数据把政策、检查和后果分开呈现，便于查明为何阻断。稳定身份与版本使同一方案的评审可以追溯到当时标准，而不靠印象或规则文件存在。

如何验证

教学配置：

version: rules-v1
rules:
  - id: SAFE-1
    check: rollback_present
    on_fail: block
  - id: DOC-1
    check: summary_present
    on_fail: advise

有回退无摘要只给建议；无回退则阻断；读不到方案返回待复核。测试规则ID重复和未知check也应报配置问题。

适用边界

此条目无已确认冻结来源，配置是独立教学构造。YAML不是执行引擎或授权，判据仍需可靠实现和语义检查。回退是否足够有效不能只看存在；规则冲突、适用范围和权限需项目明确。