ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

5 个技能让 AI 替你打理 Obsidian 库:Obsidian-skills 实战指南

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-skillsObsidian-skills 是一套开源的 Agent 技能包让 AI 助手能够直接操作 Obsidian 知识库。它教 Claude Code、Codex、OpenCode 等助手读懂并写出 Obsidian 的四种核心格式——Flavored Markdown、Bases 数据库、JSON Canvas——并提供一套命令行操作能力。装好之后你用自然语言说把这页网页整理成笔记或给所有任务笔记建一个视图格式细节由 AI 处理。为什么 AI 写的 Obsidian 笔记经常是坏的你有没有遇到过这种情况让 AI 往笔记库里写内容出来的 wikilink 只是纯文本callout 变成了普通引用.base和.canvas文件干脆无从下手原因在于大多数 AI 只认标准 Markdown。Obsidian 扩展出的语法——维基链接、嵌入、标注框、frontmatter 属性以及数据库视图和画布文件——它一概不知道。Obsidian-skills 的做法很直接每个技能就是一个SKILL.md文件把对应格式的语法规则、必填字段和常见错误写清楚交给 AI 当操作手册。技能遵循开放的 Agent Skills 规范任何兼容的助手都能加载。5 个技能恰好覆盖了信息在库里流转的几个环节技能格式解决的问题defuddle网页 → Markdown把网页清洗成干净正文省 tokenobsidian-markdown.md用 Obsidian 语法写标准笔记obsidian-bases.base建可筛选、可算公式的数据库视图json-canvas.canvas画节点与连线构成的关系图obsidian-cli命令行通过 CLI 读写库、调试插件三步装好 Obsidian-skillsClaude Code把仓库内容复制进库根目录的.claude文件夹或你当前用 Claude Code 工作的那个目录即可。Codex把skills/目录复制到 Codex 的技能路径通常是~/.codex/skills。OpenCode需要克隆整个仓库注意不要只拷内层的skills/目录否则SKILL.md的路径结构对不上git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skillsOpenCode 会自动发现~/.opencode/skills/下所有SKILL.md无需改任何配置。装完重启助手让它建一条带 callout 的笔记就能验证是否生效。用 defuddle 把网页内容清洗成 MarkdownAI 读网页时默认抓原始 HTML导航栏、侧边栏、广告全占 token。defuddle 技能让助手改用 Defuddle CLI 来提取正文defuddle parse url --md defuddle parse url --md -o content.md defuddle parse url -p title第一条直接在终端输出干净 Markdown第二条存成文件第三条只取单条元数据description、domain 同理。技能里还写了一条边界规则URL 以.md结尾说明本来就是 Markdown直接读就行不必再清洗。让 AI 写出标准的 Obsidian 笔记obsidian-markdown 技能只覆盖 Obsidian 的私有语法——标准 Markdown 它默认 AI 已经会。四个核心规则维基链接库内笔记用[[笔记名]]Obsidian 会自动跟踪重命名外部网址才用文字嵌入给 wikilink 加个!前缀![[文件]]就能把图片、PDF 甚至另一篇笔记整段嵌进来标注框 [!type]开头类型有note、tip、warning、faq等十几种-和可控制默认折叠状态frontmatter文件顶部的 YAML 属性区tags、aliases是内置的默认属性装好技能后AI 产出的笔记会长这样--- title: 项目 Alpha tags: - project --- [!important] 关键节点 第一个里程碑在 1月30日 到期。 算法细节见 [[算法笔记#排序]]。frontmatter 声明元数据正文里标注框和维基链接各占其位——这正是 AI 没有这份手册时最常写错的部分。全部 callout 类型、嵌入方式和属性字段分别列在 CALLOUTS.md、EMBEDS.md 和 PROPERTIES.md 三个参考文件里。用 Bases 数据库把笔记变成可查询的视图.base文件本质是一份 YAML描述从库里筛出哪些笔记、算出哪些字段、用哪种视图展示。让 AI 建一个任务看板生成的大体是这种结构filters: and: - file.hasTag(task) - status ! done formulas: days_until_due: if(due, (date(due) - today()).days, ) views: - type: table name: 进行中的任务 order: [file.name, status, due]这段配置筛出所有打了task标签且未完成的笔记加一条公式算距截止还有几天用表格视图按名称、状态、截止日展示。同一个.base里可以并列定义table、cards、list多种视图也能用![[任务看板.base]]嵌进任意笔记。这里有个高频坑两个日期相减得到的是 Duration 而不是数字必须取.days字段后才能参与算术上面的公式就是这么写的。完整函数列表在 FUNCTIONS_REFERENCE.md让 AI 遇到不认识的函数自己查比凭记忆瞎写可靠得多。用 JSON Canvas 画概念图.canvas文件按 JSON Canvas 规范只含两个顶层数组nodes和edges。最小结构长这样{ nodes: [ { id: 6f0ad84f44ce9c17, type: text, x: 0, y: 0, width: 400, height: 200, text: # 项目启动\n\n明确目标、组建团队 } ], edges: [] }这是一个只含单个文本节点的画布。继续添加节点时技能规定了硬约束节点 ID 必须是 16 位十六进制串且全局唯一节点之间留 50~100px 间距edges里的fromNode/toNode必须指向已存在的节点 ID。节点类型有text、file、link、group四种颜色可用1到6六个预设档区分主题。写完后 AI 会按内置清单自检一遍——ID 是否重复、连线是否悬空、JSON 是否可解析避免画出一个打不开的文件。用 Obsidian CLI 让 AI 直接操作库前四个技能处理的是文件内容obsidian-cli 技能处理的是运行中的 Obsidian 实例obsidian create name会议纪要 content# 要点 silent obsidian search querystatus: todo limit10 obsidian property:set namestatus valuedone file我的笔记三条命令分别建笔记、搜索全文、给单篇笔记更新属性——AI 不用再逐字节改文件而是走官方 CLI结果实时反映在应用里。插件开发者还有专门的循环plugin:reload热重载、dev:errors抓报错、dev:screenshot截图、dev:console看日志一套命令就能替代手动重启应用→肉眼检查的验证流程。容易卡住的三个地方YAML 引号含冒号、方括号等特殊字符的字符串必须加引号公式里嵌双引号时整条公式用单引号包起来。这是.base文件报 YAML 错误的最常见原因。公式缺空值保护不是每篇笔记都有due属性直接写(date(due) - today()).days遇到空值就崩要套一层if(due, ..., )。画布换行JSON 字符串里换行要写\n写成字面的\\n会被 Obsidian 原样渲染成反斜杠加 n 两个字符。把五个技能串起来看其实是一条完整链路defuddle 负责把外部信息干净地请进来obsidian-markdown 负责用对格式写下来obsidian-bases 让沉淀的笔记可筛选、可统计json-canvas 把关系摊开成图obsidian-cli 则让 AI 越过文件直接操作应用本身。对刚接触 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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表