ReflexioAI/claude-smart

Turns corrections into Preferences, Project-specific skills, and Shared skills for Claude Code, Codex, and OpenCode.

What it solves

claude-smart 是一個針對 AI 程式碼助理（Claude Code、Codex 與 OpenCode）的自我改進外掛，能防止助理重複相同的錯誤。它不僅僅是記錄發生過的歷史（記憶），而是從使用者的修正與成功路徑中抽取可執行的規則與持久的技能，確保 AI 在未來的會話中遵循這些規則。

How it works

此外掛利用生命週期鉤子捕捉每一次使用者回合、工具呼叫與助理回應。這些互動會交由 reflexio 引擎處理，抽取三種類型的產物：

  1. Preferences：專案層級的設定（例如「使用 pnpm 而非 npm」）。
  2. Project-specific skills：從特定儲存庫內的修正中學習的規則（例如「永遠將 --run 傳遞給 npm test」）。
  3. Shared skills：從專案特定技能彙總而成的通用模式，可在不同專案間重複使用。

這些產物會本地儲存在 SQLite 資料庫，並透過混合搜尋（向量 + BM25）由內部的 ONNX embedder 取得。相關規則會在新提示產生時注入 AI 的上下文，以指導其行為。

Who it’s for

使用 Claude Code、Codex 或 OpenCode 的開發者，想要讓 AI 助理記住專案特有的怪癖、程式碼標準與修正，而不必手動更新文件或產生提示膨脹。

Highlights

  • Automatic Learning：從互動中抽取規則，無需手動輸入，雖然仍提供 /claude-smart:learn 指令供手動標記。
  • Self-Tuning：隨著新證據累積，持續精煉、合併與歸檔規則，保持技能庫的銳利度。
  • Local-First Privacy：所有資料，包括嵌入向量與偏好設定，皆儲存在使用者本機，且不會對外部 API 進行語意搜尋呼叫。
  • Management Dashboard：提供一個 Web UI（localhost:3001）供瀏覽會話歷史、編輯已學習的技能與偏好設定。