obsidian-wiki

obsidian-wiki

用 LLM 建造並維護個人知識庫（第二大腦）的 Claude Code plugin。構想來自 Karpathy 的 LLM Wiki（完整原文見 karpathy_method.md）。

核心概念

一般 RAG 是「每次提問都從原始文件重新翻找」，知識不會累積。LLM Wiki 反過來：LLM 增量地建構並維護一個持久化的 wiki——一批結構化、互連的 markdown 檔案，夾在你與原始來源之間。每加入一份新來源，LLM 就把它消化進既有的 wiki：更新實體頁、修訂概念頁、標註矛盾、強化總論。知識編譯一次、持續保鮮，而不是每次查詢重新推導。

分工：你負責蒐集來源、探索、提問；LLM 負責摘要、交叉引用、歸檔、記帳。 Obsidian 是 IDE，LLM 是 programmer，wiki 是 codebase——你一邊跟 Claude 對話，一邊在 Obsidian 即時瀏覽成果（graph view、wikilink、頁面演進）。

安裝

從 GitHub 安裝（推薦，任何電腦皆可）

claude plugin marketplace add Bruce762/obsidian_knowledge_build
claude plugin install obsidian-wiki@obsidian-wiki

裝完重啟 Claude Code 即生效。

從本地目錄安裝（開發用）

git clone https://github.com/Bruce762/obsidian_knowledge_build.git
claude plugin marketplace add ./obsidian_knowledge_build
claude plugin install obsidian-wiki@obsidian-wiki

本地安裝的好處：改完 skill 不用 push，直接 claude plugin update obsidian-wiki@obsidian-wiki 就能吃到新版。

更新

claude plugin marketplace update obsidian-wiki   # 拉最新 repo（GitHub 來源才需要）
claude plugin update obsidian-wiki@obsidian-wiki # 更新 plugin，重啟生效

使用方法

在你想放知識庫的資料夾（建議同時是 Obsidian vault）開啟 Claude Code。

統一入口：/obsidian_wiki

不確定該用哪個操作時，一律打這個，它會自動分派：

/obsidian_wiki                          # 不帶參數：回報知識庫現況
/obsidian_wiki 把 raw/ 裡的新文章加進去   # → ingest
/obsidian_wiki 我的筆記對 X 怎麼說？      # → query
/obsidian_wiki 幫我健檢一下              # → lint

專案還沒初始化時，它會先帶你跑一次建庫。

四個核心 skill

Skill	何時用	做什麼
init_wiki	一開始跑一次	問清楚主題與第一份來源，建立 raw/、wiki/、CLAUDE.md schema 與 index／overview／log 三個特殊檔，並示範第一次 ingest
ingest	每加入一份新來源	讀來源 → 跟你討論重點 → 歸檔到 raw/archive/ → 寫摘要頁 → 更新相關實體／概念頁（一份來源動 10–15 頁是正常的）→ 更新 index 與 log。多份來源可批次
query	想從累積的知識找答案	讀 index 與 overview → 鑽相關頁 → 帶 [[引用]] 綜合作答 → 有價值的答案回存成 notes 頁，讓探索也能累積
lint	定期健檢	找矛盾、過時主張、孤兒頁、缺頁、缺連結、資料缺口，先回報清單讓你挑，再動手修

日常對話中不必打指令——說「把這篇加進知識庫」「我讀過的資料對 X 怎麼說」，Claude 會自動觸發對應 skill。

建議的日常循環

1. 用 Obsidian Web Clipper 或手動把來源丟進 raw/ 根層（收件箱）
2. 「幫我 ingest 這篇」——讀 Claude 的 takeaway，引導它強調什麼
3. 在 Obsidian 裡瀏覽更新後的頁面、graph view
4. 有問題就問，好答案回存成 notes 頁
5. 每隔一陣子跑一次 lint

建出來的知識庫長這樣

raw/            原始來源（內容只讀，source of truth）
  （根層）      待處理收件箱：新來源先丟這裡
  archive/      已處理歸檔：ingest 完移入（扁平、不分類）
  assets/       本地圖片
wiki/
  index.md      內容目錄：每頁一行 [[連結]] + 一句話摘要
  overview.md   演進中的總論（synthesis）
  log.md        時序 append-only 紀錄（## [YYYY-MM-DD] <op> | <標題>）
  sources/      來源摘要頁
  entities/     實體頁
  concepts/     概念頁
  notes/        query 回存的分析
CLAUDE.md       schema：這個 wiki 的結構與慣例，與你共同演進

分類會依主題調整（例如讀書筆記可加 wiki/characters/、wiki/themes/）。

Repo 結構

.claude-plugin/
  marketplace.json   marketplace 定義（名稱：obsidian-wiki）
  plugin.json        plugin 定義（名稱：obsidian-wiki）
skills/
  obsidian_wiki/     統一入口（dispatcher）
  init_wiki/         初始化建庫（含 CLAUDE.md 模板）
  ingest/            讀入來源
  query/             提問
  lint/              健檢
prompt.md            Karpathy 的 LLM Wiki 原文（本 plugin 的設計依據）