claude-reflect
Claude Code 的自學系統（v2.6.0，MIT）。透過 Hooks 自動捕捉使用者的糾正行為，把它們永久寫進
CLAUDE.md；同時分析歷史 session，挖掘重複模式並生成可重用的 slash commands。
核心機制
機制 1 — 從糾正中學習（Learn from Corrections）
使用者糾正 Claude Code 的行為
↓（Hook 自動觸發）
捕捉糾正事件 → 存入佇列
↓（使用者執行 /reflect）
Claude 審查佇列 → 提煉成規則 → 寫進 CLAUDE.md
- Hook 全自動：使用者不需要手動觸發捕捉，只要糾正過就會被記錄
/reflect審查：使用者主動執行後，Claude 會把佇列中的糾正整合成可讀的指南- 永久記憶：改動落地到 CLAUDE.md，未來所有 session 都能繼承
機制 2 — 工作流模式挖掘（Skill Discovery via /reflect-skills）
分析過去 session 歷史
↓
找出重複出現的操作模式
↓
生成對應 slash command（草稿）
↓（使用者核准）
新技能加入工作流
- v2 新功能：
/reflect-skills命令，主動掃描歷史找 pattern - 非強制：生成的 slash command 要使用者批准才生效
- 長尾累積：用的愈久，挖掘出的 skills 愈精準
功能對比表
| 功能 | 說明 |
|---|---|
| 永久記憶（Permanent Memory） | 糾正 → CLAUDE.md，跨 session 持久 |
| 技能發現（Skill Discovery） | session 歷史 → 自動生成 slash command |
| 多語言支援 | Python 3.6+，macOS / Linux / Windows |
| 技能改善（Skill Improvement） | 已建立的 skill 可持續精煉 |
安裝
# Step 1 — 從 marketplace 安裝
claude plugin marketplace add bayramannakov/claude-reflect
# Step 2 — 本地安裝到 Claude Code
claude plugin install claude-reflect@claude-reflect-marketplace前置需求：Claude Code CLI、Python 3.6+
自動 Hooks 配置
claude-reflect 安裝後會自動設定三個 Hooks：
| Hook | 觸發時機 | 作用 |
|---|---|---|
| UserPromptSubmit | 每次送出提示詞後 | 偵測糾正模式（「不對，應該用 X」）→ 加入佇列 |
| PreCompact | /compact 壓縮前 | 備份佇列，提醒執行 /reflect |
| PostToolUse | git commit 後 | 提醒回顧學習 |
主要命令
| 命令 | 用途 |
|---|---|
/reflect | 審查糾正佇列，提煉規則寫進 CLAUDE.md 或對應 Skill |
/reflect-skills | 掃描 session 歷史，生成 slash command 草稿（v2） |
智慧路由（Routing）
/reflect 會判斷糾正發生時正在使用哪個 Skill，並詢問「是否要更新該 Skill 的指令檔案」，而非籠統寫入全域 CLAUDE.md。這確保每條記憶落在正確位置，而不是在 CLAUDE.md 堆積。
與本 vault 的關係
本 vault 的 CLAUDE.md（專案手冊） 也是讓 LLM 讀的維護指南，但採用手工維護方式，由使用者和 LLM 協作更新。
claude-reflect 的哲學是完全自動化捕捉，把 CLAUDE.md 變成一個「活文件」，隨使用者的糾正行為持續演進。兩者理念相通（知識持久化），路徑不同（手工 vs 自動）。
相關概念
強連結（原文明確提及）
- Hooks — claude-reflect 的核心捕捉機制依賴 Claude Code Hooks
- CLAUDE.md（專案手冊） — 糾正最終寫入的目的地
- 反饋循環 — claude-reflect 本質上是一條「糾正 → 學習 → 改善」的閉環
推斷連結（LLM 認為相關，待確認）
- Slash Commands ?? —
/reflect//reflect-skills本身就是 slash commands，且能生成新 slash commands - Boris Cherny 13 條心法 ?? — 同屬「如何讓 AI 工具更好用」的實戰思維流派
延伸主題
- Skills 持續學習 — 更廣義的 Skill 持續進化框架（claude-reflect 是其中一個實作方式）
深入閱讀
- GitHub: BayramAnnakov/claude-reflect
- Hooks — Hook 機制詳解（若已有 entity）
← 回到 wiki