5 分钟让 AI 学会打理 Obsidian:obsidian-skills 完整上手指南-创锋一号

5 分钟让 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 笔记攒多了,查找靠翻、建视图要手敲配置,整理起来很费劲。obsidian-skills 是一组 AI 技能,让 Claude 等助手直接改写你的笔记、Bases 数据库和 JSON Canvas 文件。照做 5 分钟,AI 就能接手重复劳动。

先看这 5 个技能各管什么,再决定用哪几个

仓库一共 5 个技能,对应 Obsidian 的 4 种文件格式加 1 个网页清洗工具:Markdown 笔记、.base 数据库、.canvas 画布、Obsidian CLI 和 Defuddle。适合嫌整理费时的重度用户,也适合要批量维护笔记库的开发者。

5 分钟装好并跑通第一条指令

克隆仓库:git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills
把技能放进助手能找到的位置:Claude Code 放库根目录的.claude文件夹;Codex 把skills/目录拷到~/.codex/skills;OpenCode 克隆整个仓库到~/.opencode/skills/obsidian-skills,只拷内层 skills 目录会找不到
重启助手,不用改其他配置文件
下达第一个任务:在库目录打开助手,说"给 My Note 开头加一个警告标注",它会自动选对技能执行

把笔记汇成库、画地图、洗网页的三个实战场景

把散落任务汇成一张动态总表

给任务笔记写入status、due属性,格式交给 AI 处理
生成一个 .base 数据库文件:按任务标签筛选,按状态分组
用公式自动算出剩余天数和优先级色块,详见 Bases 模块说明

画一张项目知识地图

让 AI 建 .canvas 文件,把文本、文件、分组节点按章节铺开
用带标签的连线连接节点,6 种预设颜色区分进度
按 50-100 像素间距摆放节点,规则见 JSON Canvas 模块说明

把网页正文洗进知识库

让 AI 跑defuddle parse <url> --md,只留正文,去掉导航和广告
用-o存成文件,再让它补上内部链接和标注,改写成本地笔记
用-p抽取标题、描述等元数据,直接当笔记的 frontmatter

四个进阶手法,让技能用得更顺

把数据库嵌进笔记:在 Markdown 里写![[MyBase.base]]显示视图,加#视图名只嵌某一个
用if()给公式加保护:属性可能为空时先判断,少一个字段不会崩掉整个库
给日期相减加.days:相减结果默认是时长类型,取完字段才能套四舍五入这类函数
让 AI 用 CLI 批量维护库:先obsidian search查范围,再property:set批量改,需 Obsidian 处于打开状态

三类报错的三步排查法 ⚠️

现象:.base 文件打开显示 YAML 错误。原因:冒号等特殊字符没加引号,或公式外层双引号里又套了双引号。处理:带特殊字符的字符串加双引号,含双引号的公式整体用单引号包。
现象:画布打不开或节点是空的。原因:连线指向了不存在的节点,或者两个 ID 重复。处理:对照模块里的验证清单逐项核对,ID 唯一、引用有效、字段齐全。
现象:画布文本里出现字面的 "\n" 字符。原因:JSON 字符串里写了双重转义的 \n。处理:文本中的换行统一用 \n。

obsidian-skills 的价值,是把"AI 写 Obsidian 文件"从碰运气变成固定流程,整理笔记、建库视图、维护链接都能交给它。语法细节和完整示例,见 obsidian-markdown 模块说明及各技能下的 references 目录。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析