记忆转规则

要解决的问题

Claude 在使用项目时会积累大量自动记忆（auto-memory），其中不乏真正有价值的经验：比如「这个项目必须用 pnpm 而不是 npm」「API handler 必须做参数校验」。这些内容以描述性笔记的形式存放在 MEMORY.md 里，只是背景信息。Claude 每次会话可能会读到它们，但不一定会严格执行——记忆是提醒，不是指令。

结果就是：同一个约定，你可能已经纠正过 Claude 好几次，它每次都「知道了」，下次照样踩坑。真正稳定的做法，是把这类经验从记忆系统晋升（promote）到项目的规则系统里，让它变成一条强制指令。这正是 /si:promote 要做的事。

技能如何工作

核心思路是把一条「描述性笔记」改写成「指令性规则」，并写入合适的位置。工作流分七步：

1. 理解模式：解析用户的描述，如果太模糊就问一个问题——「你希望 Claude 具体遵循什么行为？」
2. 定位记忆：在 auto-memory 中找出匹配条目，并和用户确认无误。
3. 选择目标位置：按作用域分三种情况：

- 整个项目通用 → ./CLAUDE.md（如「用 pnpm，不用 npm」）
- 只针对特定文件类型 → .claude/rules/ 下的 .md（如「API handler 需要校验」）
- 跨所有项目的个人习惯 → ~/.claude/CLAUDE.md

1. 蒸馏成规则：这是最关键的一步，改写要求包括：

- 尽量一行一条
- 使用祈使句（Use X、Always Y、Never Z）
- 包含具体命令或示例，不只是概念
- 去掉背景故事，只留指令

1. 写入目标文件：对 CLAUDE.md，读取现有内容、找到合适章节、追加到对应标题下，超过 200 行时建议改用 .claude/rules/；对 rules/ 文件，则创建文件、按需加 YAML frontmatter 声明作用路径。
2. 清理记忆：晋升完成后，询问用户确认，再从 MEMORY.md 移除或标记原条目，腾出空间给新经验。
3. 确认结果。

适用边界与注意点

适合晋升的信号：

• 同一个模式在 auto-memory 中出现 3 次以上
• 你纠正过 Claude 不止一次
• 它是每个贡献者都该知道的项目约定
• 它能避免重复性错误

不该晋升的情况：

• 一次性调试笔记（留在 auto-memory 就好）
• 只在当前会话有意义的上下文
• 可能很快变化的内容（比如迁移期间）
• 已经被现有规则覆盖的条目

维护建议：

• CLAUDE.md 保持在 200 行以内，超出部分分流到 rules/
• 一行一条规则，比大段文字更易维护
• 规则里写具体命令，不只是概念
• 每季度回顾一次已晋升规则，删掉不再相关的内容