5 个 Obsidian AI 技能模块深度解析：obsidian-skills 如何把 Agent 变成你的“库管家“？

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 nameNew Note templateTemplate silent这类一条命令套用模板建笔记的用法以及property:set改属性、tags sortcount counts统计标签、search query... limit10带限量搜索。开发者反馈插件调试循环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），仅供参考