该技能用于把一次用户纠正转化为可长期执行的项目规则,并同步修复已有代码。核心思路是“两次即规则”:当用户明确说“把它设为规则”“总是”“永远不要”“记住这一点”,或对同一问题重复纠正两次时,就应提出并写下规则。每条规则由一句话说明加一对示例(错误行与应替换的行)组成,要求足够简短,便于每次编辑前快速阅读。
使用流程:第一步,先读取 AGENTS.md、CLAUDE.md 以及编辑器的规则文件夹,避免在已有规则下违规操作。第二步,用一句话陈述规则,并给出错误行和替换行;没有示例的规则被视为不完整。第三步,保持简短,一条规则为一到三句加示例对,不应写成大段推理。第四步,为规则指定唯一归属文件,按主题放入相应文件,不要复制到第二个文件;当新规则与旧规则冲突时,替换旧规则并说明变更。第五步,搜索违反新规则的代码,修复并列出涉及的文件,不应留下旧违规。
该技能同时定义了自我约束标识,例如先读规则再操作、写规则必须带示例对、规则保持简短、规则只有一个归属、解决冲突、清理既有违规等。在编辑时遵守规则属于 scope 的职责,而全量对照所有规则审查代码库则属于 audit 的职责。
报告方式:按严重程度分级。HIGH 指编辑违反已写规则,或两条规则相互矛盾;MEDIUM 指规则没有示例对,或新规则写入后仍留有旧违规;LOW 指规则比所需更长。每个根因一条发现,格式为“file:line - [rule-id] 问题描述”,随后给出 Rule | Count | Severity 汇总。存在 HIGH 时阻塞,否则通过;无法读取的规则文件标记为未验证。
适用场景:配合 AI 编码助手维护项目级编码约定、界面规范与团队行为规则,并将新规则回填到现有代码。限制与安装方式、收费与平台信息暂未提供。