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