orientation/Claude Code/Tape 03

用 Claude 建你的 Obsidian 知識庫

用 CRUCIO 模板庫建立一個 agent 讀得懂的知識庫。你不用自己發明結構,先照模板知道入口在哪、地圖怎麼看、專案包怎麼開、agent 從哪讀。

1份模板庫,不用自己從零設計結構
5個檔組成一個專案包:目標、交接、拍板、任務、來源
00–99編號資料夾,folder 是路由、metadata 才是真相

把 KB 變成 agent 的地圖

knowledge base

Agent 最怕每次都要你從頭講一遍背景。知識庫就是那個「它自己會去讀」的地方。

02 卷你學會把需求寫成任務卡。但如果每次都要重講「這是什麼專案、之前做到哪」,再好的任務卡也累。
知識庫(Knowledge Base)就是解這件事:把背景、決定、進度放在一個固定的地方,讓 agent 自己去讀。這一卷用現成的 CRUCIO 模板庫,你不用自己發明結構。
01

拿到模板,在 Obsidian 打開

先安裝 Obsidian(免費),它是放這個知識庫的地方。模板庫本身放在 GitHub:llamppost/crucio-template-vault
你可以自己下載,但更省事的還是上一卷那招:叫 agent 幫你抓下來。把下面這段貼給你的 agent:
貼給 agent:幫我把模板庫抓下來

幫我把這個 Obsidian 知識庫模板抓到我電腦上:https://github.com/llamppost/crucio-template-vault 放到一個好找的位置(例如我的文件夾)。 完成後,把資料夾的完整路徑給我,我要在 Obsidian 打開它。

Shane 筆記

想在 iPhone 上也看得到?把這個 vault 放進 iCloud 的 Obsidian 資料夾,手機裝 Obsidian 就會自動同步。macOS 上的位置是 ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/,clone 到這裡(或之後再搬進來)就好。

抓好之後,打開 Obsidian,選「開啟資料夾為儲存庫」,挑剛剛那個資料夾。
obsidianopen as vault

圖示:第一次打開 Obsidian,選「開啟資料夾為儲存庫」的開啟,把模板庫資料夾打開成 vault。

pick folderCRUCIO vault

圖示:選到 CRUCIO-Template-Vault 這個資料夾,按打開,它就成為你的 vault。

打開後,左側欄會看到一整排 00 到 99 的編號資料夾。這不是給你背的,它是一張地圖,讓你和 agent 都知道東西該放哪、該去哪找。
vault map00–99

圖示:打開後左側就是整張地圖,00 入口、03 專案、05 Agent 工作區是最常用的三塊。

02

先看入口檔,不要急著到處點

模板庫自己會告訴你從哪開始:人看 START_HERE,agent 看根目錄的 README 和 agent-operating-instructions。
  • START_HERE(在 00_入口與總控/00_快速啟動):給人的起手四步,補基本背景、開第一個領域、開第一個專案、把零散東西丟進 inbox。
  • vault-map(在 00_入口與總控/01_地圖與路由):每個編號資料夾放什麼,一頁看完。
  • READMEagent-operating-instructions(根目錄):給 agent 的開工守則,它一進來就先讀這些。
start herefor humans

圖示:START_HERE 給人的起手四步,補背景、開領域、開專案、把零散東西丟進 inbox;上方的屬性就是 agent 在讀的 metadata。

03

開一個專案包

真正開始一件事時,不是隨手開一個檔,而是複製一份「專案包」。模板庫在 03_專案中控/_project-template 備好了五個檔,一個專案一份。
README這個專案的目標、完成條件、現狀、關鍵檔、下一步。一眼看懂這件事在幹嘛。
HANDOFF交接:做到哪、改了什麼、驗了沒、下一步、卡在哪。換人或隔天接手不用重問。
DECISIONS拍板紀錄:決定了什麼、為什麼、有什麼影響。避免同一件事反覆糾結。
tasks任務清單,分 Now/Next/Waiting/Done。第 02 卷的任務卡就住這裡。
sources來源:相關資料放哪。只記指標(連結/路徑),不要整份貼進來。
但你不用自己手動複製、改檔,這正是上一卷學的:把它寫成任務,叫 agent 去做。只要設定一次:第一次先讓 agent 認得你的知識庫,把這個 vault 資料夾開給你的 agent 工作,或複製一次它的路徑(在 Obsidian 左側右鍵資料夾 → 複製路徑 → 從系統根目錄)貼給它。
copy pathfrom system root

圖示:第一次右鍵資料夾 → 複製路徑 → 從系統根目錄,貼給 agent 一次就好;之後提到「我的 vault」它就會自己讀。

之後就不用每次貼路徑了。設定好一次後,你只要在話裡提到「我的 vault」或「我的 obsidian 筆記」,agent 就知道去哪讀、往哪寫。

貼給 agent:幫我開一個專案包(換成你自己的專案名)

幫我在我的 obsidian vault 開一個新專案包:從 03_專案中控/_project-template 複製一份到 03_專案中控/01_active,資料夾命名為「客戶提案」。 打開新的 README,把這個專案的目標和完成條件填好;其他四個檔(HANDOFF、DECISIONS、tasks、sources)先保留模板。 完成後,把你建立了哪些檔列給我。

04

告訴 agent 從哪讀

知識庫的重點不是整齊,而是 agent 真的會去讀。05_Agent工作區/00_agent_routing 就是放這個:哪個 agent(Codex、Claude Code…)負責什麼、開工前讀哪些檔。

一條重要規則:資料夾位置只是路由,frontmatter 的 metadata 才是真相。一個檔是不是任務、要不要同步,看它開頭的標籤,不是看它放在哪個資料夾。剛剛 START_HERE 上方那排屬性(object_type、agent_access…)就是 agent 在讀的東西。

這一卷你要會的

在 Obsidian 打開 CRUCIO 模板庫,用一句 prompt 叫 agent 從模板複製一份專案包到 01_active、填好 README 的目標,並讓你的 agent 讀得到這個知識庫。

進第 04 卷前,確認三件事

ready check

下一卷會把第 02 卷的任務卡放進這個知識庫真的跑一次:交代、執行、回報、驗證。

01
我在 Obsidian 打開了 CRUCIO 模板庫
看得到 00–99 的資料夾結構,知道 START_HERE 和 vault-map 在哪。
required
02
我複製了一份專案包到 01_active
用一件真的事(提案、報告都行),至少把 README 的目標填好。
required
03
我知道 metadata 才是真相、folder 只是路由
判斷一個檔是什麼,先看 frontmatter,不是看資料夾。
next
next tape

第 04 卷:跑完第一條 agent flow

下一卷把任務卡放進這個知識庫,讓 agent 先給計畫、再執行、最後把結果回寫進專案包。

前往第 04 卷