用途:在 <docs-dir>/review/policies/ 下的 global-policy.md 或 module-<slug>.md 中新增或更新 agentic-review 策略规则。编辑前需先阅读 references/policy-rule-checklist.md。
主要能力:定位目标策略文件(缺失时按模板创建);通过 AskTheUser 访谈收集规则范围、领域/模块、意图、严重级别、检查逻辑、证据期望、例外与可选自动化;生成或沿用规则 ID(全局 RP-GLOBAL-NNN,模块 RP-<MODULE>-NNN);在 ## Rules 下写入或合并规则 YAML,并更新 - Updated: YYYY-MM-DD;在适用时更新 POLICY_INDEX.md 元数据表;校验必填字段并报告结果。
使用方式:用户可提出如“为 <module-slug> 添加高严重级别规则以强制 <constraint>”“更新 <module-slug> 中的 RP-<MODULE>-NNN”“添加全局策略规则”“更新全局规则 RP-GLOBAL-NNN”等请求。技能会询问缺失字段,用户不确定时提供默认值(severity: high、source: user-specified、status: active、allowed_exceptions: none)。若自动化元数据有增删改,会询问是否更新 POLICY_INDEX.md 的 Automated Checks。
适用场景:需要维护可测试、以证据为导向的审查策略规则,并保持规则索引与机器可检查项一致时。
限制与护栏:不静默删除已有规则;替换意图时将旧规则标记为 deprecated;编辑尽量局部化;与 ADR 约束冲突时标记 needs-decision;POLICY_INDEX.md 不存在时不创建,仅报告警告;可运行 python skills/review-policy-rule-builder/scripts/validate_policy_rule.py <policy-file> 校验(若可用)。