用途：在需要初始化、刷新或扩充 .pr-agent/*.mdc 仓库策略规则时使用，让 PR Agent 能捕获更多代码库特有的缺陷。.pr-agent 是 PR Agent 加载的唯一持久偏好记忆目录（对应 REPO_POLICY_DIRNAME，见 ADR 0025）。核心原则：只有本仓库审阅者不看规则就会漏掉的坑，才值得占一个位置。
主要能力：通过一次按顺序的检查清单完成工作——盘点现有 .pr-agent/*.mdc 及数量，计算剩余额度（20 减去现有数量，最多 20 个文件）；阅读 CONTEXT.md 统一术语；参考 docs/development.md 与现有 module-layout、esm-imports、web-worker-boundary 规则了解布局；梳理特性开关与常量；查看安全面规则与 ADR；为每个候选坑在 src/ 或 test/ 下确认具体路径；过滤掉已有规则覆盖的坑；每个坑写一个新文件，数量不超过剩余额度。没有新文件也是合法结果。
使用方式与文件契约：文件路径必须为 .pr-agent/<kebab-gotcha>.mdc（带前导点），frontmatter 只能含 globs 和/或 alwaysApply（schema 见 src/review/repoPolicy.ts），正文为祈使句、单一关注点、不超过 1000 字符（MAX_REPO_POLICY_INSTRUCTION_CHARS），文件不超过 8 KiB，.pr-agent/ 总量不超过 32 KiB。正文须引用本仓库可解析路径（src/...、test/...、docs/adr/00XX-...）。
限制与禁区：不得写通用建议、大块汇总文件或错误目录；不得创建不带点的 pr-agent/（连 README 别名或指针也不行）；不得改写或复述已有 .mdc 正文；不得保留草稿；不得为填满额度而写弱规则；不得跳过盘点与剩余额度计算。文件数达 20 时只能经明确人工批准后合并或替换。若正文超限会被静默截断。