Obsidian

• 您希望 AI 代理能夠依照名稱或內容搜尋您的筆記，並找出相關片段。
• 您需要透過 Obsidian 的 URI 處理器，在特定資料夾中建立新筆記，並可選擇預先填入內容。
• 您需要安全地重新命名或移動筆記——obsidian-cli move 會更新整個 vault 中所有的 [[wikilinks]]，而單純使用 mv 指令則會造成連結損毀。
• 您希望自動化 vault 的維護工作（刪除過時筆記、批次建立條目），而無需手動操作 Obsidian。

• 您尚未使用 Obsidian 桌面應用程式 — obsidian-cli 需要安裝 Obsidian 並存在其資料庫登錄檔（obsidian.json）。
• 您需要處理 canvas 檔案（.canvas）或外掛程式設定（.obsidian/）— 這些格式不在此技能的涵蓋範圍內。
• 您使用的是 Linux 或 Windows — obsidian-cli 是透過 Homebrew 安裝的，且所參照的資料庫登錄檔路徑為 macOS 專用（~/Library/Application Support/obsidian/）。

使用 obsidian-cli search 依檔案名稱搜尋筆記，或使用 obsidian-cli search-content 搜尋筆記內容，並回傳符合的片段與行號。

obsidian-cli move 可重新命名或搬移筆記，並且自動更新整個 Vault 中所有參照該筆記的 [[wikilinks]] 及常見 Markdown 連結——這是相較於直接透過檔案系統重新命名的重要優勢。

使用 obsidian-cli create 在任意保管庫路徑建立筆記，並可選擇性地預填內容。此指令透過 Obsidian 的 URI 處理器進行路由，確保新檔案能被正確註冊。

此技能讀取 Obsidian 本身的 obsidian.json 來定位使用中的資料庫，而非硬式編碼路徑，可正確處理多資料庫設定（iCloud、工作/個人等情境）。

對於簡單的讀取或編輯操作，此技能可以直接開啟 .md 檔案——Obsidian 會自動偵測檔案系統的變更，因此直接編輯是 CLI 命令之外一種快速且有效的替代方式。

請您的代理程式尋找所有與特定專案或主題相關的筆記。它會使用 search-content 來回傳相關片段與行號參照，讓您能快速找到散落在數百篇筆記中的資訊。

將會議逐字稿、網路研究資料或任務清單輸入至代理程式，讓它使用 obsidian-cli create 在正確的 Obsidian 資料庫資料夾中自動建立結構化的 Markdown 筆記，包含完整的 frontmatter 與內文。

無需手動搜尋失效連結即可重新命名或重構筆記層級結構——obsidian-cli move 能在整個儲存庫中保持所有內部參照完整無誤。

讓代理搜尋過時或重複的筆記，並使用 obsidian-cli delete 將其刪除，讓知識庫保持整潔，無需手動瀏覽資料夾。