/si:promote — 將學習成果提升為規則
將經驗證的模式從 Claude 的自動記憶移至專案的規則系統,使其成為強制執行的指令,而非背景筆記。
使用方式
/si:promote <pattern description> # 自動偵測最佳目標
/si:promote <pattern> --target claude.md # 提升至 CLAUDE.md
/si:promote <pattern> --target rules/testing.md # 提升至範圍限定的規則
/si:promote <pattern> --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 "< keywords >" "$MEMORY_DIR/MEMORY.md"
顯示符合的條目,並確認這是使用者所指的內容。
步驟 3:決定合適的目標
| 模式範圍 | 目標 | 範例 |
|---|---|---|
| 適用於整個專案 | ./CLAUDE.md | 「使用 pnpm,不要使用 npm」 |
| 適用於特定檔案類型 | .claude/rules/<topic>.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 "<pattern>" "$MEMORY_DIR/MEMORY.md"
要求使用者確認移除。然後編輯 MEMORY.md 以移除已提升的條目。這將為新的學習內容釋放空間。
步驟 7:確認
✅ 已提升至 {{target}}
規則:「{{distilled rule}}」
來源:MEMORY.md 第 {{n}} 行(已移除)
MEMORY.md:剩下 {{lines}}/200 行
該模式現在是一條強制性指令。Claude 將在未來所有工作階段中遵循它。
提升決策指南
以下情況應提升:
- 模式在自動記憶中出現 3 次以上
- 你糾正過 Claude 同一點超過一次
- 這是任何貢獻者都應知道的專案慣例
- 它可以防止重複發生的錯誤
以下情況不應提升:
- 這是一次性的除錯筆記(留在自動記憶中)
- 這是工作階段特定的上下文(工作階段記憶會處理)
- 它可能很快就會改變(例如在遷移期間)
- 現有規則已涵蓋
CLAUDE.md 與 .claude/rules/
| 使用 CLAUDE.md 的時機 | 使用 .claude/rules/ 的時機 |
|---|---|
| 全域專案規則 | 檔案類型特定的模式 |
| 建置指令 | 測試慣例 |
| 架構決策 | API 設計規則 |
| 團隊慣例 | 框架特定的雷區 |
提示
- 保持 CLAUDE.md 在 200 行以下 — 超出時使用 rules/
- 一行一條規則比段落更容易維護
- 包含具體指令,而不只是概念
- 每季審查已提升的規則 — 移除不再相關的內容