5 个 Obsidian AI 技能模块深度解析：obsidian-skills 如何把 Agent 变成你的"库管家"？
【免费下载链接】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 做了一轮用户反馈梳理。这个项目是一套用 Agent 技能（Agent skills，即教 AI 助手"会某项具体操作"的说明书）来操作 Obsidian 的工具集，覆盖 Markdown 笔记、Bases 数据库视图、JSON Canvas 画布、命令行与网页提取五个模块。这篇文章把用户真实场景下的期待、当前各模块好用与待改进的点、以及我们下一步的规划一次讲清，读完你就能判断哪些功能优先上手、接下来会来什么。
用户声音从哪里来
这次调研的声音主要来自三个渠道：一是社区里用户分享工作流时顺带提出的"要是能……就好了"；二是围绕各 SKILL.md 文档提出的 Issue 讨论，集中在"照着做仍然报错"的细节上；三是我们对照 skills/ 下各技能文档的示例与排错章节，反推哪些地方最容易卡住人。本文不引用任何量化数据，只讲定性的共识与分歧。
三个高频场景下，用户期待 Agent 接管什么
科研与阅读场景：网页丢进去，笔记自动长出来
很多用户做资料收集时的工作是：浏览器里攒一批文章链接，希望 Agent 能把每篇正文抽成干净的 Markdown 存进库，再自动打上 frontmatter 属性、用[[wikilink]]连到已有的概念笔记上。这条链路对应 skills/defuddle/SKILL.md（用 Defuddle 去掉导航栏和广告，只留正文，还能顺带省下 token）和 skills/obsidian-markdown/SKILL.md 里的六步建笔记流程：先写属性，再写正文，然后补 wikilink、嵌入、callout，最后在阅读视图里校验。用户反馈的核心期待是"抽取得更准"——正文完整、标题层级不乱，这样后续 skills/obsidian-bases/SKILL.md 里的 Reading List 示例（按book/article标签过滤出卡片视图）才能直接复用。
任务追踪场景：把库当数据库查
第二类用户把 Obsidian 库当轻量数据库用。他们的期待很具体：给笔记打好status、due、priority属性后，Agent 能生成一个.base文件，用过滤器筛出未完成任务，用公式算出"距截止还有几天"和优先级图标，再同时给出表格和卡片两种视图。这正是 obsidian-bases 技能内置的 Task Tracker Base 示例所演示的能力，视图还支持limit和groupBy，让大库里的查询不至于刷屏。
自动化与可视化场景：终端里跑命令，画布上摆结构
第三类场景偏工程化。有人希望每天用obsidian daily:append往日记追加任务、用obsidian backlinks查某篇笔记被谁引用；做插件的人则依赖"改完代码 →obsidian plugin:reload热重载 →obsidian dev:errors查错 →dev:screenshot截图验证"这一整条循环，全部记录在 skills/obsidian-cli/SKILL.md。还有人希望让 Agent 直接生成思维导图或项目看板，对应 skills/json-canvas/SKILL.md 与 skills/json-canvas/references/EXAMPLES.md 里的心智图、项目看板、流程图等完整示例。
功能体检：哪些被点赞，哪里有槽点
被点赞的功能
- obsidian-cli 的命令面。社区讨论里被反复提到的是
obsidian create name="New Note" template="Template" silent这类一条命令套用模板建笔记的用法，以及property:set改属性、tags sort=count counts统计标签、search query=... limit=10带限量搜索。开发者反馈插件调试循环（plugin:reload→dev:errors→dev:screenshot）显著缩短了"改代码-重启应用"的等待。 - obsidian-markdown 的规范覆盖。该技能只讲 Obsidian 扩展语法，不重复普通 Markdown 内容，参考文档拆成了 references/PROPERTIES.md、references/EMBEDS.md、references/CALLOUTS.md 三份，用户反馈"按清单逐项检查，生成出来的笔记很少出现渲染错误"。
- obsidian-bases 的函数参考。完整函数表放在 references/FUNCTIONS_REFERENCE.md，加上
days_until_due、status_icon这类公式示例，用户表示照着改两行就能做出自己的视图。 - defuddle 的"省 token"。
defuddle parse <url> --md去掉页面杂音后再交给 Agent，比直接抓 HTML 轻量很多，这是用户愿意把它排在 WebFetch 之前的主要原因。
有槽点的功能
- json-canvas 的布局靠手工算坐标。文档给出了固定规则——节点间距 50-100px、文本节点建议尺寸 200-600px 不等——用户反馈这些是"经验值"而非"自适应值"：内容多时节点不够大，内容少时又空着，期待 Agent 能根据文本长度自动定尺寸、避开重叠。
- obsidian-bases 的 YAML 引号坑。SKILL.md 专门设了 Troubleshooting 章节，说明含冒号的字符串必须加引号、公式里嵌套双引号要改用单引号包裹、两个日期相减得到的是 Duration 必须先取
.days才能round。有用户反馈"第一次写 base 文件几乎必然踩中一两条"，期待生成环节内置校验。 - obsidian-cli 依赖前台应用。文档明确写着需要 Obsidian 处于打开状态，且命令默认作用于最近聚焦的库，多库用户容易忘记加
vault=参数，这是社区提到过的一处易错点。 - defuddle 需要额外安装。它依赖
npm install -g defuddle，对不习惯 npm 全局安装的用户是个门槛，有用户建议把它做成可选技能而非默认路径。
改进路线图：下一步往哪走
- 功能增强：Bases 方向，继续扩充过滤器与自定义 summary（目前文档已支持
summaries自定义公式）的组合示例，覆盖团队看板这类多人协作结构；Canvas 方向，在 references/EXAMPLES.md 现有四类示例之外补充更多模板，并研究按内容自动估算节点尺寸的布局策略；Defuddle 方向，在现有-p title、-p description元数据提取基础上，尝试保留更多页面结构信息。 - 性能与体验：大库场景下引导用户用
filters先缩范围、视图加limit控制行数、CLI 列表命令用total只取计数，减少全量扫描；为常见报错（YAML 引号、Duration 运算）沉淀更前置的提示，把"先校验再写入"固化进各技能的流程说明。 - 多端与多 Agent 适配：项目遵循 Agent Skills 规范，目前已适配 Claude Code、Codex、OpenCode（安装方式见 README.md），后续会跟进更多兼容 Agent 的技能发现机制，并补齐各端的安装说明，降低"装完不知道放哪"的困惑。
参与方式与上手命令
欢迎通过四种方式参与：给 skills/ 目录新增技能模块、改进现有 SKILL.md 与 references 文档、贡献使用案例与教程、以及在仓库中报告问题与改进建议。
获取项目：
git clone https://gitcode.com/GitHub_Trending/ob/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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
