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