/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 workspaces。我嘗試 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/:
- 如果檔案不存在則建立
- 如果設定範圍,則加入 YAML 前置資料並加上
paths - 寫入規則內容
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# API 開發規則
- 所有端點必須使用 Zod 架構驗證輸入
- 錯誤回應使用 `ApiError` 類別(而非原始 Error)
- 在處理函數上包含 OpenAPI JSDoc 註解
步驟 6:清理自動記憶
提升後,在 MEMORY.md 中移除或標記原始條目:
# 顯示將被移除的內容
grep -n "<模式>" "$MEMORY_DIR/MEMORY.md"
請使用者確認移除。然後編輯 MEMORY.md 以移除已提升的條目。這樣能為新的學習內容釋放空間。
步驟 7:確認
✅ 已提升至 {{target}}
規則:"{{精煉後的規則}}"
來源:MEMORY.md 第 {{n}} 行(已移除)
MEMORY.md:剩餘 {{lines}}/200 行
此模式現在為強制性指令。Claude 將在未來所有對話中遵循它。
提升決策指南
應提升時:
- 模式在自動記憶中出現 3 次以上
- 你已多次修正 Claude 關於該模式的事項
- 這是任何貢獻者都應知道的專案慣例
- 它能防止重複錯誤
不應提升時:
- 這只是一次性的除錯備註(保留在自動記憶中)
- 這是特定對話的上下文(對話記憶會處理)
- 它可能會很快改變(例如在遷移期間)
- 它已被現有規則涵蓋
CLAUDE.md 與 .claude/rules/ 的比較
| 使用 CLAUDE.md 的時機 | 使用 .claude/rules/ 的時機 |
|---|---|
| 全域專案規則 | 特定檔案類型的模式 |
| 建置命令 | 測試慣例 |
| 架構決策 | API 設計規則 |
| 團隊慣例 | 框架特定陷阱 |
提示
- 保持 CLAUDE.md 在 200 行以下 — 超出部分使用 rules/
- 一行一條規則比段落更易於維護
- 包含具體的命令,而不只是概念
- 每季審查已提升的規則 — 移除不再相關的內容