技能包

Second Brain OS：用 Claude Code 架一個自我整理的知識庫

最適合用 Claude Code 把零散文章自動整理成互連知識庫：安裝需在終端機 clone 儲存庫並複製 vault 與 skills，且只有完成連結才算擷取成功，不想動手設定的人不適合。

官方來源 · undefined-ui/second-brain-os

安裝

git clone https://github.com/undefined-ui/second-brain-os.git && cp -r second-brain-os/vault-template ~/brain && mkdir -p ~/brain/.claude && cp -r second-brain-os/skills ~/brain/.claude/skills && cp -r second-brain-os/commands ~/brain/.claude/commands && cp -r second-brain-os/agents ~/brain/.claude/agents && cd ~/brain && claude

適合誰

  • 適合想用 Claude Code 打造一個自我整理知識庫的人：你平時會收集文章、筆記，希望它們被自動擷取、建立雙向連結並保持整潔，而不是堆成一堆沒人再回頭看的檔案。
  • 它提供完整指南、初始 vault、agent skills 與腳本，圍繞 markdown 檔案、wikilink 和 SKILL.md 運作；也適用於任何會讀檔案的 agent。Obsidian 只是圖譜檢視器，不是依賴。
  • 不適合的情況：如果你想要一個即裝即用的圖形化筆記軟體，而不願在終端機裡 clone 儲存庫、複製目錄、執行 agent，這套流程並不合適。官方證據未說明它支援哪些具體 agent 以外的用戶端、支援哪些文字語言，以及除免費、免註冊之外是否還有其他限制——免費、無需註冊，但其他邊界未知。

3 分鐘完成第一次嘗試

官方給出的主路徑是在終端機安裝到本機 ~/brain，再在該目錄啟動 Claude Code：

  1. 前提：已安裝 git、Claude Code（agent），建議同時安裝 Obsidian 以便檢視圖譜。
  2. 在終端機執行官方安裝指令，把初始 vault 與 skills、commands、agents 一併複製到 ~/brain/.claude：
git clone https://github.com/undefined-ui/second-brain-os.git
cp -r second-brain-os/vault-template ~/brain

mkdir -p ~/brain/.claude
cp -r second-brain-os/skills   ~/brain/.claude/skills
cp -r second-brain-os/commands ~/brain/.claude/commands
cp -r second-brain-os/agents   ~/brain/.claude/agents

cd ~/brain && claude
  1. 副作用與確認點：以上指令會在你的使用者目錄建立 ~/brain 並寫入檔案；如目標已存在，請先自行確認是否覆蓋。
  2. 觸發一個低風險的首次任務：把一篇文章儲存/剪下為 raw/ 目錄下的檔案，然後在 Claude Code 中輸入 /ingest。這是官方核心工作流程：agent 會擷取、提取、建立連結並清理 raw 材料，整理成互連的 wiki。它會讀寫 vault 內的 markdown 檔案；是否會執行指令或存取網路，官方證據未說明，按未知處理。若文章含敏感內容，先去識別化再放入 raw/。
  3. 成功訊號：raw/ 中的文章被整理成 vault 內帶 wikilink 的筆記頁面；官方規則是 "Nothing is ingested until it is linked"——同一輪裡沒有完成連結就等於擷取未完成。所以請檢查新頁面裡是否真的出現指向其他筆記的連結，這是判斷該輪 /ingest 是否結束的標準。官方證據未說明 /ingest 內部包含哪些檢查 pass、或對不同文字類型是否有不同流程，這些不得假設。

使用案例

案例一：文章收藏入庫。你平時用瀏覽器剪藏文章但從不回顧。情境：把一篇文章剪藏儲存到 ~/brain/raw/，在 Claude Code 中執行 /ingest。它會走官方的 ingest 工作流程——提取要點、連結到已有筆記並清理。可期待結果：raw 檔案被轉化為連結化的 wiki 頁面；若你發現新頁面缺少連結，依官方規則該輪擷取視為未完成，可要求 agent 補齊連結。

案例二：用 Obsidian 檢視知識圖譜。情境：完成幾次 ingest 後，想確認筆記之間的連結。做法：用 Obsidian 開啟 ~/brain 這個 vault（Obsidian 是官方說明的圖譜檢視器），瀏覽筆記與 wikilink 形成的圖。可確認的部分：vault 是純 markdown 與 wikilink，Obsidian 能直接開啟並顯示圖譜；官方未說明更深入的自動聯動或同步行為，不要期待超出檢視器之外的整合。

使用邊界

  • 檔案存取：安裝與執行會在本機建立和修改 markdown 檔案（~/brain、raw/、.claude 目錄）；這是流程的核心，而不是可選副作用。
  • 指令與網路：官方證據只給出上述 shell 安裝指令；agent 在 ingest 期間是否執行其他指令或存取網路，證據未說明，屬未知。
  • 確認點：在把敏感資料放進 raw/ 之前自行審查；覆蓋已有 ~/brain 前自行確認。
  • 執行環境：需要本機終端機、git 與一個會讀檔案的 agent（官方主路徑使用 Claude Code）；需要 Obsidian 才能看圖譜檢視，但它不是依賴。除此之外官方未列出其他執行限制。
  • 未確認的關鍵資訊：支援的 agent 名單是否只有 Claude Code（官方只說 works with Claude Code and any agent that reads files）、支援的文字語言、/ingest 之外還有哪些可用指令，均無證據，使用前可先在 skills、commands 目錄中自行查看實際檔案確認。