orientation/Antigravity/Tape 03

用 Antigravity 建你的 Obsidian 知識庫

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

1個本地資料夾＝一個 Antigravity 專案，知識庫就住這裡
5個檔組成一個專案包：目標、交接、拍板、任務、來源
AGENTS.md放資料夾根目錄，進專案自動先讀當工作藍圖

把 KB 變成 agent 的地圖

knowledge base

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

第 02 卷你學會把需求寫成任務卡。但如果每次都要重講「這是什麼專案、之前做到哪」，再好的任務卡也累，而且你開一個新的 New Conversation，Antigravity 就從零認識你一次，上次講過的背景這次一概不知道。
解法不是每次重講，而是把背景寫在一個它自己會去讀的地方。Antigravity 剛好天生就適合這件事：它以「專案」為單位，一個專案就是你電腦上的一個本地資料夾。把知識庫做成那個資料夾，任務卡、背景、專案包全收進去，它進這個專案就一路讀得到。這一卷用現成的 CRUCIO 模板庫幫你搭起來，還會教一招 Antigravity 的關鍵設定：AGENTS.md。
整卷都在 Antigravity 2 的桌面 App、用對話框完成，不碰程式。右上角那顆「Open IDE」是給要改 code 的人用的，這一卷用不到。
01

開一個專案＝指一個本地資料夾

Antigravity 做任何事之前，先要有一個「專案」，而專案就是你指給它的一個本地資料夾。在左欄 Projects 旁邊點那顆 folder+ 圖示（Create New Project），挑一個好找的資料夾（例如你的文件夾），這樣它動的就是你本機的檔案，不是雲端。
知識庫的結構你不用自己發明，直接拿現成的模板庫：llamppost/crucio-template-vault。你可以自己下載，但更順手的是用上一卷那招：交辦出去。在專案裡開一個 New Conversation，把下面這段貼進對話框：
貼進 Antigravity 對話框（New Conversation）：幫我把模板庫抓下來

幫我把這個 Obsidian 知識庫模板抓到我電腦上：https://github.com/llamppost/crucio-template-vault 放到我剛剛指定的專案資料夾裡。 完成後，把資料夾的完整路徑印給我，我要在 Obsidian 打開它。

Shane 筆記

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

抓好之後，打開免費的 Obsidian（放這個知識庫、給你自己看的地方），選「開啟資料夾為儲存庫」，挑剛剛那個資料夾。
obsidianopen as vault

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

pick folderCRUCIO vault

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

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

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

關鍵動作：既然 vault 已經抓到本機，就把這個 vault 資料夾本身也 Create New Project 一次。之後所有關於這個知識庫的對話，都在這個專案裡開，Antigravity 一進來就讀得到裡面的檔，包括等一下要放的 AGENTS.md。

02

先看入口檔，一個專案包五個檔

模板庫自己會告訴你從哪開始：人看 START_HERE，Antigravity 看根目錄的 README 和 agent-operating-instructions。先讀入口檔，不要急著到處點。
start herefor humans

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

真正開始一件事時，不是隨手開一個檔，而是複製一份專案包。模板庫在 03_專案中控/_project-template 幫你備好五個檔，一個專案一份。這五個檔，就是 Antigravity 開工時該讀的東西。
README這個專案的目標、完成條件、現狀、下一步。它一眼看懂這件事在幹嘛。
HANDOFF交接：做到哪、改了什麼、驗了沒、卡在哪。換一個 New Conversation、或隔天回來接手，就靠這份接回，不用重講。
DECISIONS拍板紀錄：決定了什麼、為什麼。免得同一件事反覆糾結，也免得它每次給你不一樣的做法。
tasks任務清單，分 Now／Next／Waiting／Done。上一卷那些任務卡就住這裡。
sources來源：相關資料放哪。只記指標（連結／路徑），不要整份貼進來。
一樣不用自己手動複製改檔，寫成一句交辦（換成你自己的專案名，貼進對話框）：
貼進 Antigravity 對話框：幫我開一個專案包（換成你自己的專案名）

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

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

03

放一份 AGENTS.md，它進專案先讀

到這裡都還是通用做法。現在講 Antigravity 的關鍵一招。上一卷說過，你跟 AI 合作有一層是「它看得到的」，寫一次、持續生效。Antigravity 把這層做成一個檔：AGENTS.md。
把 AGENTS.md 放在資料夾根目錄，Antigravity 進到這個專案，會先讀它，當成這件事的工作藍圖和行為指示，不用你貼、不用你每次提醒。你把「這個知識庫長怎樣、東西放哪、我在意什麼、固定要照的做法」寫進去一次，它以後開工都先看過。這就是「它不記得你」的正解：不是每次重講，是寫在它必讀的地方。
備課老師的例子最好懂：把課綱、每學期學生名單的命名慣例、你出題的偏好（情境題要用日常例子、方程式要用 Office Math 格式）都寫進 AGENTS.md。之後你只要說「照慣例幫我出這次的考卷」，它就照著跑，不用每次從頭交代一遍。
貼進 Antigravity 對話框：幫我把 AGENTS.md 寫好

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

還有一份全域的 AGENTS.md，寫進去所有專案都會讀到，適合放「你的習慣」，例如一律用繁中回你、動不確定的事前先問一句。專案那份講「這個專案」的事，全域那份講「你這個人」的事。全域那份會一直吃額度，只放真的重要的。用中文跟它說「把這條做成全域規則」就行。

Antigravity 也讀別家 agent 的檔，如果你資料夾裡本來就有一份 CLAUDE.md（Claude Code 的規則檔），它會試著一起讀進來。所以你不必為了換工具重寫一份，既有的規則檔多半能直接沿用。

04

讓它先給計畫，別急著開 Turbo Mode

最後一件保護你的事。Antigravity 接到任務會先把「要做什麼、怎麼做」寫成一份計畫檔，才動手，規劃是它內建的，不是另外一個要你切的模式。這對你是好事：它落好計畫、你掃一眼、覺得不對就喊停或調整，再放它去做。

專案設定裡有個 Turbo Mode，它的作用是把所有確認選項關掉、一路衝到底。在它會動你檔案的知識庫裡（複製、改寫、刪檔），先別開，開了它就不停下來等你，你就少了「在計畫檔上看一眼、喊停」的機會。要刪檔這種不可逆的事，讓它把待刪的集中到一個資料夾、由你本人確認再刪，別交給它自動執行。

Shane 筆記

對話框上方可以換模型。搭知識庫、跑這些檔案操作，用預設的 Gemini 3.5 Flash 就夠快夠用；真正要它幫你想大架構、做複雜規劃時，再換 Claude Sonnet 4.6。這一卷都算「做事」不算「想事」，Flash 綽綽有餘。

這一卷你要會的

在 Antigravity 用 Create New Project 把 CRUCIO 模板庫的資料夾開成一個專案，用一句話叫它從模板複製一份專案包到 03_專案中控/01_active、填好 README 的目標，再放一份 AGENTS.md 在根目錄，讓它每次進這個專案都先讀得到你的知識庫。

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