obsidian-skills 集成 OpenCode 完整指南：让 AI 直接操作笔记、数据库与画布

obsidian-skills 集成 OpenCode 完整指南让 AI 直接操作笔记、数据库与画布【免费下载链接】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 是面向 Obsidian 的开源 AI 技能集与 OpenCode 集成后AI 助手能按 Obsidian 规则读写带属性和 wikilink 的笔记、Bases 数据库与画布文件。适合正在用 Obsidian 管知识、想把整理工作交给 AI 的你。 上手前你应知道的 3 件事安装只有两步先把这三点确认掉装完就能直接用。自动发现不用注册OpenCode 默认扫描~/.opencode/skills/下的所有SKILL.md仓库克隆到位后 5 个技能全部可见不需要在别处登记。零配置不用改opencode.json也不用动其它设置文件装完重启一次就生效。技能本质是 Markdown每个技能是一个目录核心是一份说明文件如 skills/obsidian-markdown/SKILL.md里面写清 AI 该怎么处理对应的文件格式你可以随时打开它看 AI 到底被教了哪些规则。 两步完成安装整个安装就两条命令加一次重启过程里不需要碰任何配置。第一步克隆仓库到技能目录git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills这一条命令把完整仓库放进~/.opencode/skills/下末尾路径决定技能集在目录里的名字。注意要保留完整仓库不要把内层的skills/文件夹单独拷出来。OpenCode 期望的结构是~/.opencode/skills/obsidian-skills/skills/技能名/SKILL.md只拷内层目录会让层级少一级SKILL.md就对不上了。第二步重启 OpenCode关掉再启动 OpenCode 即可不需要修改任何配置重启时它会重新扫描技能目录把新的SKILL.md全部加载进来。验证方法问它帮我建一个.canvas画布如果 AI 按nodes/edges结构生成并自查 ID 与连线引用说明技能已加载。️ 五大技能按用途看5 个技能不用逐个记按用途归成 3 类处理笔记、管数据库和画布、操作库并取网页内容。处理笔记obsidian-markdown让 AI 写出Obsidian 味的 Markdown把官方扩展语法的坑都替你避开。批量生成带 frontmatter 属性title、tags、aliases的笔记内部引用写[[wikilink]]、外部 URL 写普通链接不会混用正确插入 callout、![[image.png|300]]这类嵌入、块引用与高亮语法规则全文见 skills/obsidian-markdown/SKILL.md属性、嵌入、标注框各有单独参考文档放在它的 references/ 目录里管理数据库与画布obsidian-bases、json-canvas一个管.base数据库文件一个管.canvas画布文件都能从零创建也能在已有文件上增改。Bases写过滤条件按标签、属性、日期组合 and/or、公式如距截止日还有几天、表格与卡片视图和汇总见 skills/obsidian-bases/SKILL.md完整函数表在 FUNCTIONS_REFERENCE.mdCanvas给节点生成 16 位 ID、用fromNode/toNode拉连线、用 group 分区上色写完后自查 ID 唯一性和连线引用完整性见 skills/json-canvas/SKILL.md思维导图、流程图等成品示例在 EXAMPLES.md操作库与取网页内容obsidian-cli、defuddle前者让 AI 直接向运行中的 Obsidian 实例发指令后者把网页清理成干净 Markdown少喂给模型一堆导航和广告。cli搜索、建笔记、追加内容、改属性、查反链做插件时还能重载插件、跑 JS、截图查 DOM见 skills/obsidian-cli/SKILL.md需要 Obsidian 处于打开状态defuddle一条命令只留下正文defuddle parse url --md这一行把任意网页转成纯 Markdown加-o还能存成文件没装过 defuddle 就先npm install -g defuddle用法见 skills/defuddle/SKILL.md✅ 三个可直接试的工作流不用等全部弄懂再动手挑一个场景先跑通一遍。批量规范化旧笔记你来做——指一个缺少属性的旧笔记文件夹AI 完成——逐份补上 frontmattertitle、tags、aliases把外部网址改成 Markdown 链接、内部引用保持 wikilink最后列出改动过的文件清单。自动搭建数据库视图你来做——用大白话描述标签是 book 且 status 不是 done 的笔记按表格展示加一列剩余天数AI 完成——生成合法.base文件配好过滤、公式和视图并检查 YAML 引号这类常见错误。生成思维导图画布你来做——丢一段会议纪要或读书笔记AI 完成——拆成节点和连线用 group 分区、预设色板上色按 50–100 像素间距排布再自检每条连线都指向存在的节点。常见问题与进阶调整装完之后卡住的点大多集中在这几类按问题 → 做法对照着查。技能没生效先查目录结构问题重启 OpenCode 后AI 还是不会处理.base或.canvas文件。 做法确认SKILL.md位于~/.opencode/skills/obsidian-skills/skills/技能名/SKILL.md。如果之前只拷了内层skills/目录造成层级错位删掉后按完整仓库重新克隆。技能更新命令问题上游加了新技能或修了规则本地怎么同步。 做法在克隆的目录里执行更新然后重启 OpenCodecd ~/.opencode/skills/obsidian-skills git pull这一行从远端拉取最新技能文件拉完重启一次新内容就生效。多技能冲突与优先级问题同时装了其它技能集行为不确定或互相抢活。 做法写提示词时点名技能如用 obsidian-bases 建这个视图让匹配更精确也可以按 OpenCode 的配置机制调整技能加载优先级让 obsidian-skills 排在前面。自定义技能路径问题不想把技能放在默认的~/.opencode/skills/。 做法把仓库克隆到任意目录让 OpenCode 的技能扫描路径指向它即可前提是obsidian-skills/skills/技能名/SKILL.md这个层级保持完整。 去哪里深入想往下挖先看仓库里的参考文档再按功能名去对应官方资料里查。项目说明与全部安装方式README.mdBases 公式的完整函数参考FUNCTIONS_REFERENCE.md画布成品示例思维导图、项目板、流程图EXAMPLES.md技能格式遵循 Agent Skills 规范语法细节可查 Obsidian 官方帮助中心的 Flavored Markdown、Bases、CLI 等条目装完这套技能后AI 在你的库里能做的事从会说变成会做补属性、建视图、排画布都直接落在文件上。下次有整批笔记要整理直接丢进对话里就行。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考