
1 行命令裝好 obsidian-skills教 AI 讀寫 Obsidian 的完整教程【免費下載鏈接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.項目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skillsobsidian-skills 是一套開源 Agent 技能包讓 Claude Code、Codex 等 AI 助手學(xué)會讀寫 Obsidian 筆記、Bases 數(shù)據(jù)庫與 Canvas 畫布解決 AI 不懂 Obsidian 私有語法、容易改壞知識庫的問題。 明確項目定位給 AI 一份 Obsidian 操作手冊obsidian-skills 不是插件而是一組遵循 Agent Skills 規(guī)范的技能文件任何兼容該規(guī)范的客戶端都能加載。機制很直接每個技能由一份 SKILL.md 主文件和若干參考文檔組成AI 接到任務(wù)后照著文件里的語法規(guī)則和工作流操作 Vault。說白了它把 wikilinks、callouts、frontmatter 這些 Obsidian 私有寫法寫成模型能直接執(zhí)行的說明書。 對號入座三類知識庫任務(wù)可以直接交給 AI批量補全筆記元數(shù)據(jù)。一百多條會議紀(jì)要缺 frontmatter、缺標(biāo)簽、彼此不鏈接。讓 AI 給每篇統(tǒng)一加 title、tags、status再用 wikilinks 把相關(guān)會議串起來——規(guī)則明確、重復(fù)度高的活最適合外包。把散落筆記變成數(shù)據(jù)庫。讀書筆記散在十幾個文件里你想按狀態(tài)篩選、按來源分組。AI 可以生成 .base 數(shù)據(jù)庫文件做出表格和卡片兩種視圖還能用公式算出閱讀進度。網(wǎng)頁進庫并建圖譜。收藏的文章要先清洗再入庫用 Defuddle 提取干凈正文存成筆記再把關(guān)鍵概念畫進 Canvas 關(guān)系圖。拆解核心能力筆記語法、數(shù)據(jù)庫、畫布與命令行用 AI 寫對 Obsidian 風(fēng)味 Markdownobsidian-markdown 技能覆蓋 wikilinks、嵌入、callouts、屬性、標(biāo)簽等私有語法并規(guī)定庫內(nèi)鏈接用 [[wikilink]]、外部 URL 才用普通鏈接。一個例子批量給新建筆記套用屬性模板屬性類型規(guī)則見 skills/obsidian-markdown/references/PROPERTIES.md。另一個是修復(fù)斷鏈AI 先定位引用位置再重建指向。配套的 defuddle 技能做網(wǎng)頁清洗defuddle parse url --md -o content.md一行命令去掉導(dǎo)航和廣告只留正文省 token 也省時間。用 Bases 給筆記建可篩選的數(shù)據(jù)庫視圖obsidian-bases 技能讓 AI 會寫 .base 文件filters 圈定范圍formulas 定義計算屬性views 輸出 table、cards、list、map 四種視圖。例子給閱讀清單建庫用status reading過濾出在讀書目表格視圖按來源分組。函數(shù)語法查 skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md。用 JSON Canvas 畫知識關(guān)系圖譜json-canvas 技能處理 .canvas 文件每個節(jié)點生成 16 位十六進制 ID連線必須引用已存在的節(jié)點新增節(jié)點還要避開重疊位置。例子把一篇讀書筆記里的幾個概念畫成關(guān)系圖AI 建完會校驗 ID 唯一性和連線完整性。樣例見 skills/json-canvas/references/EXAMPLES.md。用 Obsidian CLI 批量操作 Vaultobsidian-cli 技能教 AI 驅(qū)動運行中的 Obsidian讀筆記、追加內(nèi)容、改屬性、查任務(wù)。例子obsidian property:set namestatus valuedone fileX一條命令更新筆記狀態(tài)配合模板參數(shù)還能批量建筆記。前提是 Obsidian 處于打開狀態(tài)。 從 0 到跑通一行命令完成安裝與首次調(diào)用第一步安裝npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills支持插件市場的客戶端也可以用/plugin marketplace add kepano/obsidian-skills加/plugin install obsidianobsidian-skills兩條斜杠命令完成。第二步客戶端要求手動放置時按官方說明放對目錄Claude Code 拷到 Vault 根目錄的 .claude 文件夾Codex 把 skills/ 目錄拷進 ~/.codex/skillsOpenCode 必須克隆整倉只拷內(nèi)層 skills/ 文件夾會失敗git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills第三步重啟客戶端先下一個小任務(wù)試試比如給這篇會議筆記加 frontmatter 屬性并鏈到相關(guān)筆記跑通后再加大任務(wù)量。?? 排查 obsidian-skills 常見失效問題技能沒生效AI 仍寫標(biāo)準(zhǔn) Markdown??蛻舳瞬患嫒?Agent Skills 規(guī)范或裝完沒重啟。解決確認所用客戶端在支持列表里重啟一次再試。OpenCode 里技能完全不被發(fā)現(xiàn)。原因是只復(fù)制了內(nèi)層 skills/ 文件夾。解決OpenCode 要求整倉克隆最終目錄必須是~/.opencode/skills/obsidian-skills/skills/技能名/SKILL.md。AI 把 wikilink 寫成普通鏈接像沒觸發(fā)技能。技能靠指令關(guān)鍵詞觸發(fā)。解決指令里帶上Obsidian 筆記、wikilinks、callouts、frontmatter這類詞。obsidian CLI 命令報錯或無反應(yīng)。CLI 技能操作的是運行中的 Obsidian 實例默認指向最近聚焦的 Vault。解決先打開 Obsidian多庫環(huán)境把vaultMy Vault作為第一個參數(shù)。.base 文件打開報 YAML 錯誤。常見于帶特殊字符的字符串沒加引號或引用了未定義的formula.X。解決按技能內(nèi)校驗清單檢查引號與公式定義再讓 AI 修正。進階玩法建閱讀數(shù)據(jù)庫與跑插件調(diào)試閉環(huán)給讀書筆記建完整數(shù)據(jù)庫。思路分兩步先讓 AI 用 markdown 技能批量給筆記補 status、source、開始日期三個屬性再生成 .base——全局過濾掉已歸檔的表格視圖按 source 分組看進度卡片視圖只顯示在讀的書。之后每周說一句刷新閱讀庫視圖AI 基于新屬性更新即可不必重建文件。用 CLI 技能跑插件開發(fā)閉環(huán)。改完插件代碼讓 AI 依次執(zhí)行obsidian plugin:reload idmy-plugin重載、obsidian dev:errors查錯、obsidian dev:screenshot pathscreenshot.png截圖驗證有錯就修完再重載。這個循環(huán)替代手動改—刷新—觀察插件和主題開發(fā)都適用。找到下一步資料從倉庫文檔入手這套技能包適合已有 Vault、日常使用 Claude Code 或 Codex 等 AI 客戶端的知識工作者。各技能的完整語法以倉庫內(nèi)各 SKILL.md 與 references 目錄為準(zhǔn)安裝方式與目錄結(jié)構(gòu)如有變化以倉庫最新 README 為準(zhǔn)?!久赓M下載鏈接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.項目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考