/si:promote — 将学习内容提升为规则
将 Claude 自动记忆中的成熟模式移动到项目的规则系统中,使其成为强制执行的指令,而非背景笔记。
用法
/si:promote <模式描述> # 自动检测最佳目标
/si:promote <模式> --target claude.md # 提升到 CLAUDE.md
/si:promote <模式> --target rules/testing.md # 提升到作用域规则
/si:promote <模式> --target rules/api.md --paths "src/api/**/*.ts" # 带路径作用域
工作流程
步骤 1: 理解模式
解析用户的描述。如果描述模糊,提出一个澄清性问题:
- "Claude 应该遵循什么具体行为?"
- "这适用于所有文件还是特定路径?"
步骤 2: 在自动记忆中查找模式
# 在 MEMORY.md 中搜索相关条目
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F/|/|; s|^/||')/memory"
grep -ni "<关键词>" "$MEMORY_DIR/MEMORY.md"
显示匹配的条目并确认这是用户想要的。
步骤 3: 确定合适的目标
| 模式作用域 | 目标 | 示例 |
|---|---|---|
| 适用于整个项目 | ./CLAUDE.md | "使用 pnpm,而不是 npm" |
| 适用于特定文件类型 | .claude/rules/<主题>.md | "API 处理器需要校验" |
| 适用于你所有项目 | ~/.claude/CLAUDE.md | "优先使用显式错误处理" |
如果用户未指定目标,请根据作用域推荐一个。
步骤 4: 提炼为简洁的规则
将学习内容从自动记忆的笔记格式转换为 CLAUDE.md 的指令格式:
之前 (MEMORY.md — 描述性):
该项目使用 pnpm 工作空间。当我尝试 npm install 时失败了。锁文件是 pnpm-lock.yaml。必须使用 pnpm install 来安装依赖。
之后 (CLAUDE.md — 规范性):
## 构建与依赖
- 包管理器:pnpm(不是 npm)。使用 `pnpm install`。
提炼规则:
- 每条规则尽量一行
- 使用祈使语气("使用 X"、"始终 Y"、"绝不 Z")
- 包含命令或示例,而不仅仅是概念
- 不要背景故事——只需指令
步骤 5: 写入目标
对于 CLAUDE.md:
- 读取现有的 CLAUDE.md
- 找到合适的部分(或创建一个)
- 在正确的标题下追加新规则
- 如果文件超过 200 行,建议改用
.claude/rules/
对于 .claude/rules/:
- 如果文件不存在则创建
- 如果带作用域,则添加包含
paths的 YAML 前置元数据 - 写入规则内容
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# API 开发规则
- 所有端点必须使用 Zod 模式校验输入
- 使用 `ApiError` 类处理错误响应(而不是原始 Error)
- 在处理函数上包含 OpenAPI JSDoc 注释
步骤 6: 清理自动记忆
提升后,移除或标记 MEMORY.md 中的原始条目:
# 显示将被移除的内容
grep -n "<模式>" "$MEMORY_DIR/MEMORY.md"
要求用户确认移除。然后编辑 MEMORY.md 以移除已提升的条目。这为新的学习内容腾出空间。
步骤 7: 确认
✅ 已提升到 {{目标}}
规则: "{{提炼后的规则}}"
来源: MEMORY.md 第 {{n}} 行(已移除)
MEMORY.md: 剩余 {{lines}}/200 行
该模式现在是一条强制执行的指令。Claude 将在所有未来会话中遵循它。
提升决策指南
何时提升:
- 模式在自动记忆中出现 3 次以上
- 你曾不止一次纠正 Claude 关于它的事情
- 这是一个任何贡献者都应该知道的项目约定
- 它防止了重复出现的错误
何时不提升:
- 这是一次性的调试笔记(留在自动记忆中)
- 这是会话特定的上下文(会话存储器会处理此情况)
- 它可能很快会改变(例如迁移期间)
- 现有规则已经涵盖了它
CLAUDE.md 与 .claude/rules/
| 使用 CLAUDE.md 的场景 | 使用 .claude/rules/ 的场景 |
|---|---|
| 全局项目规则 | 文件类型特定的模式 |
| 构建命令 | 测试约定 |
| 架构决策 | API 设计规则 |
| 团队约定 | 框架特定的陷阱 |
提示
- 保持 CLAUDE.md 在 200 行以内——超出部分使用 rules/ 目录
- 每行一条规则比段落更容易维护
- 包含具体的命令,而不仅仅是概念
- 每季度审查已提升的规则——移除不再相关的内容