前言¶
維護 Obsidian 倉庫時，日常動作往往很瑣碎：在當前筆記裏插入鏈接、按日期生成每日筆記、把散落的 todo 歸攏、按標籤或屬性篩選筆記、檢查斷鏈和書籤。這些事在圖形界面裏靠點擊完成，重複多次就變成負擔；想腳本化，又得自己對着 CLI 參數反覆試。下面介紹的 obsidian-cli 技能，就是把這套倉庫操作封裝成可直接調用的能力。
這是什麼¶
obsidian-cli 是一個基於通用 SKILL.md 格式的技能，面向官方 Obsidian CLI（v1.12+），定位是「完整的保險庫自動化」。它由 adolago 發佈，來源爲 clawhub，座標 @clawhub_adolago/obsidian-cli，當前版本 2.0.0，分類 knowledge-management，標籤 requires_api_key=false。
也就是說：它不是又一個 Obsidian 插件，而是一層技能封裝，把官方 CLI 的能力整理成結構化的操作入口，供 Cursor、Codex CLI、Claude Code 這類客戶端按需調用。
核心功能¶
依據 Skill 簡介，該技能覆蓋以下能力域：
- 文件操作：對 Vault 內的文件進行讀寫與組織。
- 每日筆記：按日期維度創建或定位筆記。
- 搜索：在保險庫範圍內檢索內容。
- 任務：處理筆記中的任務條目。
- 標籤：按標籤查詢與整理。
- 屬性：讀寫 frontmatter 等元數據屬性。
- 鏈接：處理筆記間的鏈接關係。
- 書籤：管理書籤。
- 基礎：常規基礎操作。
需要注意的是，簡介只給出了能力域的劃分，沒有列出每個域對應的具體命令與參數。具體命令以官方 Obsidian CLI 爲準，技能負責把這些能力暴露給上層 Agent。
安裝與啓用¶
抓取到的 SkillHub 頁面沒有給出安裝命令、目錄路徑或配置字段，因此這裏不推測。可確認的信息如下：
座標：@clawhub_adolago/obsidian-cli
上游倉庫：https://clawhub.ai/adolago/obsidian-cli
SkillHub 頁面：https://www.skillhub.cn/skills/clawhub_adolago/obsidian-cli
啓用方式建議直接打開上述 SkillHub 頁面與上游倉庫，按發佈者給出的說明操作；在沒有核實到命令之前，不建議自行猜測安裝入口。
關於客戶端差異：本次抓取未能覈實該技能在 Cursor、Codex CLI、Claude Code 之間的安裝方式是否存在差異，因此不做分別說明。基於 SKILL.md 通用格式這一點，它通常可被支持該格式的客戶端加載，但具體支持程度請以客戶端文檔爲準。
前置條件是本地已安裝並可用官方 Obsidian CLI（v1.12+）。技能本身不含 CLI 二進制，不會替代官方 CLI。
典型用法¶
由於資料中沒有提供可復現的命令行示例，本節只描述能力調用方向，不虛構具體命令。
1、文件與每日筆記：新建筆記、向已有筆記追加內容、按日期定位每日筆記。適合做日報、週報的自動化落盤。
2、檢索：按關鍵詞在保險庫內搜索，再按標籤或屬性二次篩選。適合「找出所有未完成的、帶特定標籤的筆記」這類查詢。
3、任務與屬性：讀取筆記中的任務條目，寫入或更新 frontmatter 屬性。適合批量整理元數據。
4、鏈接與書籤：檢查筆記之間的鏈接關係，維護書籤列表。適合做倉庫體檢。
使用時先確認本地官方 CLI 能正常執行，再在 Agent 客戶端中調用技能；如果某個能力域的實際表現與預期不符，優先覈對官方 CLI 版本是否達到 v1.12+。
適用場景與注意¶
適合：重度使用 Obsidian、希望把倉庫維護動作交給腳本或 Agent 的開發者；需要在 CI 或定時任務裏批量整理筆記的人；以及正在用 Cursor、Codex CLI、Claude Code 做知識庫自動化的人。
注意：
- 該技能依賴官方 Obsidian CLI，未安裝或版本低於 v1.12+ 時無法工作。
- 它操作的是本地保險庫，注意備份；批量寫入類動作建議先在副本上驗證。
requires_api_key=false表示不需要額外 API key，但仍需保證本地 CLI 已就緒。- 評分與下載量爲抓取時點的頁面數據：SkillHub 顯示評分 100000、下載 19301、安裝 328。這些數字隨時間變化，不構成使用依據。
結尾¶
obsidian-cli 的價值在於把 Obsidian 倉庫的高頻操作從圖形界面搬進命令行與 Agent 調用鏈，省去重複點擊，也讓筆記維護可以腳本化。如果你的日常維護集中在文件、每日筆記、搜索、任務、標籤、屬性、鏈接與書籤這幾類動作上，值得先裝好官方 Obsidian CLI，再按官方頁面說明啓用這個技能。
官方地址：https://api.skillhub.cn/user_46180358/obsidian-cli
