企业官网建设流程全解析

让AI替你整理Obsidian笔记：obsidian-skills安装与使用完整指南

【免费下载链接】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

周五晚上，你想把这一周的零散笔记理一理：给会议记录补上标签，把读书笔记归进表格，再画一张图理清几个概念的关系。这些事手动做不慢，但枯燥。obsidian-skills 就是干这个的：它是一组给 AI 助手（Claude Code、Codex、OpenCode 等）装的"Obsidian 技能包"，教会 AI 读懂 Obsidian 的三种核心格式——Markdown、Bases 数据库、JSON Canvas，让它直接替你建笔记、改数据库、画图谱。

它是怎么工作的

每个技能就是一个文件夹，里面一份SKILL.md加上若干参考文档，写满了 Obsidian 语法的规范和操作套路。AI 助手启动时会自动发现这些文件，相当于上岗前读完了操作手册。之后你用大白话下指令，AI 就知道该按什么格式写 wikilink、怎么校验一个.base文件、如何生成合法的.canvas坐标。

仓库里目前有 5 个技能：skills/obsidian-markdown/（Obsidian 方言 Markdown）、skills/obsidian-bases/（数据库文件）、skills/json-canvas/（画布文件）、skills/obsidian-cli/（命令行操作笔记库）、skills/defuddle/（把网页转成干净的 Markdown）。

快速开始：从安装到第一条指令

安装分两步。先拿到仓库：

git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills

然后按你用的 AI 工具选一种放置方式：

• Claude Code：把仓库内容放进你的笔记库（vault）根目录下的.claude文件夹
• Codex：把skills/目录复制到~/.codex/skills
• OpenCode：整个仓库克隆到~/.opencode/skills/obsidian-skills，注意要克隆完整仓库，只拷内层skills/文件夹会失效

重启 AI 助手后，技能即生效。可以直接用这条指令验证（需要你的笔记库已安装 Obsidian CLI）：

帮我创建一篇叫"测试笔记"的笔记，正文写"来自AI的第一篇笔记"

AI 会调用obsidian create命令完成创建。看到笔记出现在库里，说明整条链路通了。

三种典型用法

用法一：让AI把读书笔记变成数据库

要做什么：你有一堆带#book标签的笔记，想用一个表格视图集中管理进度。

怎么做：告诉 AI"帮我在笔记库里建一个 Bases 文件，把打了 book 标签的笔记列出来，卡片视图显示封面和作者，表格视图显示待读书单，并算一下预计阅读时长"。AI 会依据 skills/obsidian-bases/SKILL.md 里的规范生成.base文件：用filters筛选#book标签，用formulas定义计算属性（比如按页数估算阅读时间），再配置cards和table两种视图，最后自查一遍 YAML 引号是否合法——这是新手手写时最容易出错的地方，AI 生成时会主动规避。

得到什么：一个开箱即用的.base文件，在 Obsidian 里打开就能看到卡片墙和书单表格。笔记更新标签后，视图自动跟着变，不用你维护任何索引。

用法二：批量规范化一批旧笔记

要做什么：早期随手写的几十篇笔记没有属性、链接混乱，想统一格式。

怎么做：给 AI 一个明确规则，比如"给所有 2024 年之前的会议纪要补上 frontmatter（title、date、tags），并把文里写死的书名号链接改成 wikilink"。AI 会按 skills/obsidian-markdown/SKILL.md 的写法来：库内笔记一律用[[wikilink]]（Obsidian 能自动跟随重命名），外部 URL 才用普通 Markdown 链接；callout、属性、标签都有现成的规范文档可以参考。改之前可以先让它search出涉及的文件清单，你确认范围后再动手。

得到什么：一批属性齐全、链接可追踪的笔记。因为 wikilink 会被 Obsidian 自动维护，之后你重命名笔记时，其他笔记里的引用不会断。

用法三：把想法画成可视化图谱

要做什么：读了一本书，想把几个核心概念和它们的关系画成一张图，方便复盘。

怎么做：对 AI 说"把'知识管理'这个笔记下的三个核心概念画成一张画布，概念之间用箭头标出依赖关系，按重要程度用不同颜色"。AI 会按 skills/json-canvas/SKILL.md 的 JSON Canvas 规范生成.canvas文件：每个节点有 16 位唯一 ID 和坐标位置，节点间距保持 50-100 像素避免重叠，连线的fromNode/toNode指向真实存在的节点，颜色用预设的 1-6 号色。生成后它还会自查一遍 ID 是否重复、连线是否悬空。

得到什么：一张打开即用的画布，节点、箭头、颜色分组都是现成的。想调整布局时，直接用自然语言说"把'第二大脑'节点挪到右上角"，AI 会修改坐标重新写入。

顺带一提，skills/defuddle/ 是这组技能里的辅助工具：当你让 AI 参考某个网页（文章、文档）写笔记时，它会先用 Defuddle 把网页剥成干净的 Markdown，去掉导航栏和广告，省掉大量无意义的 token。

新手避坑

坑一：技能装好了，AI 却装傻不认识 Obsidian 语法。多半是路径放错了。对照上面的目录要求检查一遍：OpenCode 必须是完整仓库结构~/.opencode/skills/obsidian-skills/skills/<技能名>/SKILL.md；Claude Code 的.claude文件夹要放在笔记库根目录。确认路径后重启 AI 助手再试。

坑二：.base文件在 Obsidian 里报 YAML 错误。最常见的两个原因：公式里含双引号但外层也用双引号（应该外层用单引号包起来），以及日期相减后直接调.round()——两个日期相减得到的是 Duration 类型，要先取.days再取整。技能文档的 Troubleshooting 一节列了正反对照，让 AI 参照修复即可，不用自己逐行找。

坑三：画布里的换行显示成字面的\n。JSON 字符串里的换行必须写\n，写成\\n就会被 Obsidian 原样渲染成两个字符。如果你让 AI 画过画布，检查它生成的 JSON 就能避免这个坑。

生态与后续

这些技能遵循 Agent Skills 开放规范，所以不限于某一家 AI 工具——Claude Code、Codex、OpenCode 都能用，未来支持该规范的新工具也可以直接接入。想扩展的话，照着现有技能的结构自己写一份SKILL.md放进skills/目录即可，仓库本身也在持续跟进 Obsidian 官方 CLI 和新格式的版本更新。

下一步

挑一个你手头的真实场景开始：建一个 Bases 书单、批量补一批笔记的属性，或者画一张概念画布。装好之后先下一条最简单的指令跑通链路，再逐步加难度——这是让 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