orientation/Codex/Tape 03

用 Codex 建你的 Obsidian 知識庫

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

5個檔組成一個專案包：目標、交接、拍板、任務、來源
1份 AGENTS.md 放資料夾根目錄，Codex 每次自動先讀
/init一鍵生出 AGENTS.md 腳手架，不用從白紙寫

把 KB 變成 agent 的地圖

knowledge base

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

Codex 有個脾氣你上一卷已經見過：它不回頭問你，拿到方向就直接開幹。但還有一件事新手常忽略：它也不會記得你。你每開一個新對話，它就從零認識你一次；上禮拜跟它講過的專案背景，它這次一概不知道。
解法不是每次都把背景重講一遍（那跟自己做沒兩樣），而是把背景寫在一個它自己會去讀的地方。這就是知識庫。這一卷用現成的模板幫你搭一個 Codex 每次開工都讀得到的知識庫，還會多教 Codex 這一路的關鍵一招：AGENTS.md。
01

知識庫就是它每次開工都會讀的資料夾

知識庫（Knowledge Base）不是什麼高深的東西：它就是一個固定的資料夾，把專案的背景、決定、進度放在裡面。你用免費的 Obsidian 來裝它、來讀它；結構不用自己發明，直接拿現成的模板庫：llamppost/crucio-template-vault。
你當然可以自己下載，但更順手的是用上一卷那招：把事情交辦出去。Codex 不會回頭問你，所以一次把要它做的講清楚，貼進輸入框：
貼進 Codex 輸入框：幫我把模板庫抓下來

幫我把這個 Obsidian 知識庫模板抓到我電腦上：https://github.com/llamppost/crucio-template-vault 放到桌面或文件資料夾這種好找的位置。 完成後，把資料夾的完整路徑印給我，我要在 Obsidian 打開它。

Shane 筆記

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

抓好之後打開 Obsidian，選「開啟資料夾為儲存庫」，挑剛剛那個資料夾。打開後左側會看到一整排 00 到 99 的編號資料夾，這不是要你背，它是一張地圖，讓你和 Codex 都知道東西該放哪、該去哪找。
obsidianopen as vault

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

pick folderCRUCIO vault

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

vault map00–99

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

02

一個專案包，五個檔

真正開始一件事時，不是隨手開一個檔，而是複製一份專案包。模板庫在 03_專案中控/_project-template 幫你備好五個檔，一個專案一份。這五個檔，就是 Codex 開工時該讀的東西。
README這個專案的目標、完成條件、現狀、下一步。Codex 一眼看懂這件事在幹嘛。
HANDOFF交接：做到哪、改了什麼、驗了沒、卡在哪。你晚上把長活丟給 Codex、隔天早上回來，就靠這份接回，它做起來又快又不回頭問你，這份紀錄尤其重要。
DECISIONS拍板紀錄：決定了什麼、為什麼。免得同一件事反覆糾結，也免得 Codex 每次給你不一樣的做法。
tasks任務清單，分 Now／Next／Waiting／Done。上一卷那些任務卡就住這裡。
sources來源：相關資料放哪。只記指標（連結／路徑），不要整份貼進來。
要 Codex 動得了這個資料夾，先讓它看得到：在 App 裡把 vault 資料夾拖進輸入框，或右鍵資料夾複製完整路徑貼給它。設定一次就好。
copy pathfrom system root

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

接著一樣不用自己手動複製改檔，寫成一句交辦給 Codex（換成你自己的專案名，貼進輸入框）：
貼進 Codex 輸入框：幫我開一個專案包（換成你自己的專案名）

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

03

放一份 AGENTS.md，它每次自動先讀

到這裡都還是通用做法。現在講 Codex 這一路的關鍵一招。上一卷說過，你跟 AI 合作有一層是「它看得到的」，寫一次、持續生效。Codex 把這層做成一個檔：AGENTS.md。
把 AGENTS.md 放在資料夾根目錄，Codex 每次進到這個資料夾工作，都會自動先讀它，不用你貼、不用你每次提醒。你把「這個知識庫長怎樣、東西放哪、我在意什麼」寫進去一次，它以後開工都先看過。這就是「它不記得你」的正解：不是每次重講，是寫在它必讀的地方。
不用對著白紙發呆。在資料夾裡打 /init，Codex 會幫你生一份 AGENTS.md 腳手架，你再照自己的情況改。
貼進 Codex 輸入框：幫我把 AGENTS.md 填好

幫我在這個 vault 根目錄建一份 AGENTS.md，寫給你自己每次開工看的。 講清楚：這是我的個人知識庫，專案包放在 03_專案中控/01_active，每個專案有 README／HANDOFF／DECISIONS／tasks／sources 五個檔。 規則：開工前先讀對應專案的 README 和 HANDOFF；動任何檔前先跟我確認一句；一律用繁體中文。

還有一份全域的 AGENTS.md 住在 ~/.codex/，跟全域設定 ~/.codex/config.toml 放一起。專案那份講「這個專案」的事，全域那份講「你的習慣」，例如一律用繁中回你、動不確定的事前先問一句。兩份都會被讀到。

04

設定一次，五種身體都認得

最後一件讓你省力的事：Codex 是一套系統、五種身體：桌面 App、終端 CLI、雲端 Cloud，還有 IDE 和瀏覽器裡的擴展。它們共用同一份 AGENTS.md 和同一份 ~/.codex/config.toml。
意思是你只要設定一次。白天在 App 裡跟它改提案，晚上把一個要跑很久的長活丟給 Cloud，早上回 App 接回，因為背景都寫在 AGENTS.md、每種身體讀的是同一份，你不用對每一個重講一遍。搭一次知識庫，它換哪個身體都認得你。
這一卷你要會的

在 Obsidian 打開 CRUCIO 模板庫，用一句話叫 Codex 從模板複製一份專案包到 03_專案中控/01_active、填好 README 的目標，再打 /init 生一份 AGENTS.md，讓 Codex 每次開工都讀得到這個知識庫。

進第 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 卷