用途:为 agentic-review 创建并维护项目专属审查策略。该技能以访谈为先、以证据为基础,从仓库文档与 ADR 推导既有事实,挖掘高置信度实现约定,补齐缺失的项目/领域约束,并在 <docs-dir>/review/policies/ 写入结构化策略产物,在 POLICY_INDEX.md 中定义审查审计治理规则。写策略文件前需阅读 references/policy-contract.md,它是规范 schema,含 onion/clean 架构模板。
主要能力:分阶段执行。阶段1校验前置条件并定位 <docs-dir>,需在 setup-agentic-repository 之后运行,读取根 AGENTS.md,确认 AGENTS.md、<docs-dir>/ENGINEERING.md、<docs-dir>/AGENTS_CONTEXT.md 及至少一个 CONTEXT.md,缺失则快速失败并提示先修复 setup-agentic-repository。阶段2先加载基线事实,读取 AGENTS.md、ENGINEERING.md、CONTEXT-MAP.md 与相关 CONTEXT.md、adr/*.md,提取候选规则并标注来源。阶段3挖掘仓库约定候选(v1 仅继承约定,check_type: inheritance_suffix),默认 min_samples=4、min_adoption_ratio=0.85,分为 promoted-candidate 与 exploratory-candidate,绝不自动持久化,须经访谈确认。阶段4结构化访谈,用 AskUserQuestion 逐项决策,覆盖架构完整性、依赖方向、调用流限制、继承约定确认、模块例外、事务/数据完整性、安全热点等。阶段5写入 global-policy.md、module-<slug>.md、POLICY_INDEX.md,每条规则含 id、title、scope、severity、intent、check_logic、evidence_expectation、allowed_exceptions、source 等元数据。阶段6重跑时原地合并更新,保留稳定 id,废弃规则标记 deprecated,冲突标记 needs decision。阶段7定义 agentic-review 集成契约。阶段8汇报产物与未决冲突,并在结束前询问 .gitignore 忽略策略(全部忽略/仅忽略 diff/保持跟踪),按确定性映射更新,保证幂等,不提交更改。
适用场景:已使用 agentic-review 且完成 setup-agentic-repository 的仓库,需要建立或维护项目级审查策略时。
限制:依赖上述必需文件,缺失即失败;v1 仅支持继承约定挖掘;不自动持久化挖掘结果;不提交更改,需用户先审阅策略产物。