尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

如何让你的 AI 助手学会 Obsidian 语法:obsidian-skills 与 OpenCode 集成完整指南

如何让你的 AI 助手学会 Obsidian 语法:obsidian-skills 与 OpenCode 集成完整指南 如何让你的 AI 助手学会 Obsidian 语法obsidian-skills 与 OpenCode 集成完整指南【免费下载链接】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 编写的开源 Agent Skills。它教会 AI 助手正确书写 Obsidian 风格的 Markdown、Bases 数据库和 JSON Canvas 画布还能通过命令行直接操作正在运行的 Obsidian。把它接入 OpenCode 之后你让 AI 处理笔记库时它不会再写坏文件、造出打不开的数据库。AI 处理 Obsidian 笔记时容易踩的坑普通的 AI 助手会写标准 Markdown但 Obsidian 在 CommonMark 之上加了不少自己的东西[[双括号]]指向库内的另一篇笔记改标题时 Obsidian 会自动跟随更新普通 Markdown 链接做不到这一点![[嵌入]]能把另一篇笔记、图片或 PDF 直接嵌进正文.base文件是 YAML 写成的数据库.canvas文件是由节点和连线构成的画布AI 没学过这两种格式写出来大概率打不开。更隐蔽的问题在效率上把一篇网页文章丢给 AI 阅读整页的导航栏和广告都会被吃进上下文token 白白消耗。obsidian-skills 解决的就是这两类问题——它给 AI 一份怎么写对、写完怎么自查的操作说明覆盖 Obsidian 的五种核心格式和交互方式。3 分钟装好 obsidian-skills 一句话定位五个技能的集合遵循 Agent Skills 开放规范。规范之外没有平台绑定支持该规范的代理都能加载。下面以 OpenCode 为例讲接入方式。一条 clone 命令完成 obsidian-skills 安装把整个仓库克隆到 OpenCode 的技能目录git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills这里有个容易出错的细节要克隆完整仓库不要只把里面的skills/文件夹拷过来。这样做最终目录结构才是~/.opencode/skills/obsidian-skills/skills/技能名/SKILL.md。配置什么都不用改OpenCode 会扫描~/.opencode/skills/下的全部SKILL.md文件克隆完重启一次技能就全部可用了。快速验证技能是否生效重启后提个具体要求试试比如在库里新建一篇笔记带标签和一个提示框。如果 AI 产出的是带 frontmatter 属性的笔记、 [!tip]形式的提示框、指向库内笔记的 wikilinks说明技能已经接上了。反过来如果它给你写了普通 Markdown 链接和纯文本引用先检查仓库是否克隆完整。五大技能分别能做什么 obsidian-markdown负责.md文件。写笔记时它会先放 frontmatter再填正文库内引用一律走 wikilinks重点内容包进提示框。技能自带 references 子目录属性、嵌入、提示框的语法各自成篇AI 动笔前可以逐条对照。obsidian-bases负责.base文件。帮你搭过滤器、公式以及表格、卡片、列表、地图四种视图还会替你避开两类经典错误YAML 里的特殊字符忘加引号、引用了没定义的公式。json-canvas负责.canvas文件。往画布里加节点和连线时它会给每个节点生成不重复的 16 位十六进制 ID并校验每条边的两端都指向已存在的节点——画完的思维导图、流程图不会结构断裂。obsidian-cli通过obsidian命令行与正在运行的 Obsidian 实例打交道读取、创建、搜索笔记也覆盖插件和主题开发的调试动作比如重载插件、跑 JavaScript、截图。前提是先打开 Obsidian。defuddle从网页里抽出干净的 Markdown 正文去掉导航和广告。给 AI 喂链接时明显省 token。它依赖一个 CLI 工具首次使用前运行npm install -g defuddle装好即可。实战把一篇网页文章变成可检索的笔记 用 OpenCode 跑一遍完整流程你会发现任务拆得有多顺把文章链接发给它。defuddle 只取正文导航栏不进上下文让正文存进库。obsidian-markdown 接手frontmatter 里填标题和标签相关概念改成 wikilinks 连到已有笔记关键结论包进提示框建一个.base数据库按标签过滤出所有阅读中的笔记用卡片视图展示。以后新笔记只要打上标签就会自动出现在这个库里画一张.canvas画布文章的各章各节变成节点用连线标出依赖关系。全程你只说了任务文件类型、校验步骤都是技能里写好的。这就是这套技能的价值所在不是给 AI 加新功能而是让它一次写对。进阶用法与保持技能更新 靠描述触发每个 SKILL.md 的 description 就是触发条件。你提到 wikilinks、提示框、Bases、画布这些词对应技能会自动进入工作状态不需要手动指定。组合干活上一节的四步实际是一个 defuddle 加三个技能接力完成的。真实项目里把目标说清楚就行不用一步步指挥。定期拉新项目更新比较频繁技能内容以仓库为准。在技能目录下运行下面的命令拿到最新版重启 OpenCode 后生效cd ~/.opencode/skills/obsidian-skills git pull装好这套技能后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-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表