用途:审计并维护 Cursor 项目中的规则文件(.cursor/rules/ 下的 .mdc),检查前缀约定、frontmatter 与规则重叠,并同步 doc/rules.md。
触发条件:用户要求审计或维护项目规则、检查前缀约定、同步 doc/rules.md;或上下文涉及 .cursor/rules/、.mdc 规则文件、cursor-rules-principles / retro 约定。
事实来源:cursor-rules-principles.md(仓库或 ~/.cursor 中),含 000–500 前缀表与通用原则,完整前缀表见 reference.md;commands/retro.md 的 PROJECT RULES 部分,涉及 000/050/100/200/900 前缀、扁平 .mdc、rules 下不建子文件夹。
流程:先解析路径,PROJECT_ROOT 用 git rev-parse --show-toplevel,PROJECT_CURSOR_DIR 为 ${PROJECT_ROOT}/.cursor,PROJECT_RULES_DIR 为 ${PROJECT_CURSOR_DIR}/rules;若规则目录不存在,报告“No .cursor/rules in this repo”并停止。随后审计:列出所有 *.mdc(扁平,无子文件夹),逐文件记录名称、前缀是否符合原则/retro、frontmatter(description、alwaysApply、globs)、行数(建议约 <50)、与其他规则的重复或近似重复;标记缺失前缀、前缀槽位错误、frontmatter 缺失或无效、文件过大、内容重复。再给出建议:RENAME(无数字前缀的文件按 reference.md / retro 建议前缀)、MERGE(范围重叠的规则建议目标文件与章节)、DELETE(仅在明确理由如过时或已完全合并时提出)。未经用户确认,不得删除、移动或重命名。若仓库存在 doc/rules.md 或 docs/rules.md,更新其“Context-Specific Rules”(或等价)列表,使其与当前 .mdc 文件及其 globs/scope 保持一致。
输出:文件表格(路径、前缀是否正确、frontmatter 是否正确、行数、备注)与建议列表(RENAME/MERGE/DELETE 及原因和目标);结尾行为“Do zastosowania: potwierdź zmiany lub wywołaj agenta rules-keeper.”。
限制:无用户明确确认不得做破坏性更改;完整前缀表与约定见 reference.md。