開發 Obsidian 的公司 CEO 發布了一份免費的 AI 使用說明書。
你可以在這裡找到：
https://github.com/kepano/obsidian-skills
裡面只有 5 個文字檔。安裝只需要 5 分鐘，而且不會破壞你現有的任何筆記。
加入這些檔案後，AI 就能理解 Obsidian 特有的格式。這是對「AI 弄亂我的筆記」這個問題的官方解答。
當我看到這個話題變熱門，打開自己的環境準備安裝時，才發現它早就已經在那裡了……
檔案日期是 4 月 26 日。我早在三個半月前就安裝了，然後徹底忘了這回事（笑）。
那麼，這三個半月來我的 Obsidian 有什麼改變呢？我很好奇，但結果相當令人失望。
直接說結論：只有官方說明書是不夠的。你還需要再寫一頁屬於自己的內容。
AI 不知道的是 Obsidian 特有的語法
Obsidian 有幾個不同於一般筆記 App 的獨特功能。
要連結筆記時，用 [[ ]] 把筆記名稱包起來。（Links）
要讓某則筆記特別醒目，可以用特定語法建立彩色區塊。（Callouts）
檔案最上方有存放日期和標籤的區塊。（Properties）
AI 在不知道這些規則的情況下寫筆記。所以雖然文字內容看起來沒問題，但當你在 Obsidian 打開時，會發現連結沒有串起來，或是彩色區塊沒有顯示出來。
我在開頭連結的那 5 個檔案，就是來填補這個空缺的。它們的內容如下：
- obsidian-markdown（連結和區塊的正確語法）
- obsidian-bases（像資料庫表格一樣整理筆記）
- json-canvas（用線條連接筆記來建立圖表）
- obsidian-cli（透過指令搜尋整個 Vault）
- defuddle（將網頁匯入為乾淨的筆記）
你可以從上面的連結免費取得。
這些檔案不限定特定的 AI 工具，所以在 Claude Code 或 Codex 上都能以同樣方式運作。
安裝 3.5 個月後，幾乎沒有任何改變
我發現這件事時，說實話笑了。我早就安裝了這個很有名的說明書……而且自己完全沒發現（笑）。
不過，因為這些檔案只在 Claude Code 裡運作，所以我在 8 月 9 日把同樣的 5 個檔案複製到 Codex，讓兩邊都能使用。
接下來才是重點。
三個半月後，我的 Obsidian 有什麼改變？
- 使用 Callout 的筆記：1,387 則中有 32 則
- 資料庫檢視：1 個
- Canvas：1 個
幾乎完全沒有改變。
這不是說官方說明書不好。內容當然做得很好。
剛安裝時，我試用了一下，覺得「哦，還蠻方便的」，然後就結束了。因為我沒有決定「什麼時候」要用它們，所以這是很自然的結果。
什麼都沒改變的原因很明確：官方說明書教的是「怎麼寫」。
知道怎麼寫，並不會增加你寫出來的內容。它也不會決定東西該放在哪裡。
給 AI 的說明書有兩種
我認為這一點非常重要。
給 AI 的說明書有兩種。
- 正確的 Obsidian 語法。這對每個人的 Obsidian 來說都是一樣的，所以由官方團隊提供。
- 你自己的內部規則。什麼東西放哪裡。哪些區域可以動。完成品應該放到哪裡。
官方團隊只提供前者。
而 Vault 變亂的原因，通常是後者。比起語法錯誤，「寫得正確但放錯位置」更麻煩。
沒有「內部規則」時，你會在這裡遇到麻煩：
- 完成文章每次都被存到不同的資料夾。
- AI 在你想要保持唯讀的日記裡新增內容。
- 即使你改了資料夾名稱，新筆記仍然不斷出現在舊名稱下。
在這些情況下，語法都是完美的。只有擺放位置和處理方式錯了。
舉例來說，官方說明書說：「用連結串起相關的筆記。」這是對的。
但我的規則正好相反：只有「之後一定會打開」的筆記才建立連結。如果連結增加太多，我會什麼都找不到。
這不是誰對誰錯的問題，只是官方指南無法涵蓋我的個人狀況。
不管你再怎麼用 AI，你的資產都不會自動增加。你早就擁有材料了，只是缺少那個「容器」。
官方說明書教你容器的「形狀」，但你必須自己決定什麼東西要放在哪裡。
━━━━━━━━━━━━
給那些使用 AI 卻發現內容創作沒有變簡單的人：
把材料集中放在同一個地方，別再每次都從零開始。
我開設了「Minami 的 Obsidian x AI Agent 實作日誌」。
點這裡免費閱讀 ↓
https://lifebaselab-m.com/p/r/j8MTvDdP?free1=x
━━━━━━━━━━━━
建立內部規則最低限度的 4 個項目
我在 Obsidian 裡建立了一個名為「Operation Rules」的檔案，把所有規則都寫在裡面。Claude 和 Codex 在開始工作前都會先讀取這個檔案。
以下 4 個項目就能讓一切至少動起來：
- 可動區域 vs. 唯讀區域。 以我來說，日記、網頁剪貼和未分類筆記都是唯讀。這是最重要的部分。
- 完成品的去處。 把位置固定下來：X 貼文放這裡，Note 文章放那裡。這樣 AI 就不會每次都要問。
- 無法決定時的逃生路線。 如果猶豫超過 3 秒，就放進「未分類」。這樣就不會卡在分類上。
- 決定一個固定的規則存放處。 不要把操作規則寫在隨機的筆記裡。固定在主檔案中。
尤其是第 4 點。沒有這條的話，規則會散落在各地，你會搞不清楚哪個才是最新版本。
為了不讓它只停在安裝階段，我每週檢查一次
前面提到的 5 個檔案中，obsidian-cli 可以讓你用指令檢查整個 Vault。它能找出孤立筆記、標籤使用次數和失效連結。
它很有用，但你不執行的話它就不會運作。
所以，我把這個「檢查」設定為每週自動執行一次。它會在每週日早上自動運行，並產出疑似失效連結和長期被忽略筆記的報告。
最大的好處就是不需要記得去做這件事。
「安裝了」和「有在運作」是兩回事。
這可是裝了三個半月卻什麼都沒改變的我說的，所以我大概是對的（笑）。
總結
安裝官方說明書只需要 5 分鐘。免費，而且不會弄壞你的筆記。做了沒有任何壞處。
但那改變的只有語法。
Obsidian 交給 AI 後之所以會變亂，不是因為你不擅長使用。只是因為你還沒有一個 AI 可以讀取的「內部規則」檔案。
所以，不需要等到自己記住所有東西才開始交給 AI。官方團隊提供了語法；你只需要寫一頁。
如果你今天就要動手，先寫一行來區分 AI 可以碰和不能碰的地方。「日記資料夾是唯讀的，不要改寫它」這樣就夠了。
光是這樣，就能大幅減少 AI 做完之後你需要修正的工作量。
━━━━━━━━━━━━
感謝你閱讀到最後！
公告 📢
我正在舉辦 Open Chat！
以增加「Obsidians」為目標，我會分享一些沒有發在 X 上的 Obsidian x AI Agent 日常故事。
我也會發送禮物，有興趣的話歡迎來看看 ↓
