尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

obsidian-skills 完整指南:如何三步教会 AI 管理你的 Obsidian 笔记库

obsidian-skills 完整指南:如何三步教会 AI 管理你的 Obsidian 笔记库 obsidian-skills 完整指南如何三步教会 AI 管理你的 Obsidian 笔记库【免费下载链接】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 整理过 Obsidian 库结果它把内部链接全写成了普通 Markdown、Bases 文件报语法错误、Canvas 画布打不开obsidian-skills 就是一个为 Obsidian 准备的开源 Agent 技能包它把 Obsidian 特有的语法——Flavored Markdown、Bases、JSON Canvas、Obsidian CLI 的操作方式——打包成 5 个现成技能让 Claude Code、Codex、OpenCode 这类 AI 助手装完就能正确写 wikilinks、callouts、属性能建数据库、画知识图谱。本文带你走一遍完整流程三步装好跟一个任务流把它跑起来再解决新手最常碰到的问题。 先说一个熟悉的场景周五晚上的乱摊子周五晚上你面前是三堆东西白天攒的几篇文章还没存档一周的会议记录散在各个日期文件里上次的读书笔记也迟迟没建索引。你打开 AI 助手说了一句帮我整理一下这个库。它确实动手了但交出来的结果让你头疼新建笔记的 frontmatter 里 tags 写成了字符串内部链接用了[](.)而不是[[wikilinks]]你让它建的任务表在 Obsidian 里直接报 YAML 错误让你画张关系图生成的文件连画布都打不开。问题不在 AI 不够聪明而在于它不知道 Obsidian 的家规。Obsidian 的 Markdown 是扩展过的[[双链]]、![[嵌入]]、 [!note]标注块、frontmatter 属性再加上.base数据库文件和.canvas画布文件这套语法标准大模型训练语料里见得不算多AI 只能靠猜。obsidian-skills 干的事就是把这套家规写成 AI 能读的操作手册装进你的 AI 助手里。 它到底教给 AI 什么仓库里是一个skills/目录每个技能一个文件夹里面有SKILL.md定义文件和对应的参考文档。五个技能各管一摊技能管的事你什么时候会用到obsidian-markdownObsidian 特有语法wikilinks、嵌入、callout、属性、标签新建、编辑笔记obsidian-bases.base数据库文件筛选、公式、表格/卡片视图做任务表、书单、索引json-canvas.canvas画布文件节点、连线、分组、颜色画知识图谱、项目看板obsidian-cli通过obsidian命令行读、建、搜笔记管理属性和任务批量操作、插件开发defuddle从网页提取干净的 Markdown去掉导航和广告把文章内容存进库注意它只教 Obsidian 的方言标准 Markdown 的标题、列表、代码块这些 AI 本来就会不重复教。这也是技能文件保持精简的原因——obsidian-markdown 技能 开头就写明标准 Markdown 视为已知。 最快上手三步装完即用第一步装技能。按你用的 AI 平台三选一支持 marketplace 的平台直接在命令面板里加仓库、安装obsidian技能包即可用npx skills add的方式一行命令指向仓库地址手动安装先把仓库克隆下来——git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills然后按平台放好位置Claude Code把仓库内容放到你的 Obsidian vault 根目录或你常用的工作目录下的.claude文件夹里Codex把skills/目录拷进~/.codex/skills/OpenCode注意要克隆整个仓库到~/.opencode/skills/obsidian-skills不要只拷内层skills/文件夹因为它靠目录结构自动发现每个SKILL.md。第二步重启你的 AI 助手。技能是启动时加载的不重启等于没装。第三步先拿一个小任务验证。别上来就交代大活先说一句在我这个库里新建一条笔记标题随意加上 tags 属性并用 wikilinks 链接到另一条已有笔记。 打开笔记看一眼链接是[[ ]]形式、属性在 frontmatter 里正常显示就说明装好了。️ 跟我走一遍一个完整的知识管家任务流装好之后功能点最好别孤立看跟着下面这个流程走一遍你会发现五个技能其实是同一条流水线上的五个环节。环节一先干净地把内容存进库。周一早上你攒了几篇文章要读让 AI 把链接里的正文存成笔记。装了 defuddle 技能 后它会用defuddle parse url --md这类命令把网页转成干净的 Markdown——导航栏、广告、评论区都去掉只留正文再顺手存成文件。你得到的是一条没有杂音的笔记而不是塞满 HTML 标签的垃圾文本。环节二让笔记符合库里的规矩。存档完接着说按我的库的格式整理一下。这时 obsidian-markdown 技能 接管它给笔记补上 frontmattertitle、tags、aliases正文里把相关概念写成[[wikilinks]]连到已有笔记关键结论用 callout 块标出来插图用![[嵌入]]放进来。它内部有一套固定的工作流先加属性、再写内容、后建链接、最后建议你在阅读视图里检查渲染效果。环节三把散笔记变成能查的表。攒了两周之后你受够了翻文件夹。让 AI 给所有带book标签的笔记建一个阅读清单obsidian-bases 技能 会生成一个.base文件用filters圈定范围按标签、文件夹、属性筛用formulas算字段比如根据页数估算阅读时间再配 table 或 cards 视图展示。之后你新建一本带book标签的笔记它自动出现在清单里不用手动维护。环节四把网状关系摊开画。笔记越攒越多哪些文章和哪些项目相关已经记不清了。让 AI 给这个主题画一张画布json-canvas 技能 会生成合法的.canvas文件每个概念一个 text 节点引用文件用 file 节点关系用带箭头的 edge 连起来还能按主题分组、上色。它要求所有节点 ID 唯一、连线的两端必须指向已存在的节点所以生成的文件是能直接打开的不会给你一个打不开的坏 JSON。环节五日常维护交给命令行。流程跑通之后剩下的琐事——批量改状态、查某篇笔记的反链、看标签使用统计、往每日笔记里追加任务——都可以走 obsidian-cli 技能。它教会 AI 用obsidian命令行和正在运行的 Obsidian 打交道比如obsidian search query关键词先搜再改property:set批量更新字段backlinks查引用关系。做插件开发的还附了一整套调试命令重载插件、看报错、截图、查控制台。整条链路是网页进来 → 格式整理 → 入库建表 → 画布总览 → 命令行维护。每个环节 AI 都知道该用什么语法、该避开哪些坑你只需要说人话。 怎么跟它说一套好使的指令几个让命中率明显提高的说法习惯一次一个环节。把这篇文章存进来并整理 比 把这个库全部理一遍 稳得多。分步走每步结果你都能肉眼验收。点名文件和文件夹。说清存到 Reading 文件夹只处理带#book标签的笔记AI 就不用猜范围。让它先说计划再动手。对批量操作先问你打算改哪些文件、怎么改确认了再执行。要求它在 Obsidian 里验证。技能里内置了验证步骤比如检查 Bases 的 YAML 是否合法、Canvas 的 ID 是否唯一但你可以主动加一句改完打开给我看渲染效果。想自己翻规则原文的话入口都在这几个文件里Markdown 语法定义、Bases 完整函数参考、画布示例集。这些同时也是 AI 读取的技能源你照着它写的东西检查标准是一致的。❓ 遇到问题先查这三个地方技能完全没生效九成是路径或重启问题。按上面最快上手三步核对文件夹放对位置了没有OpenCode 用户特别注意别只拷内层skills/SKILL.md是否真实存在于对应目录下最后重启 AI 助手。AI 写的 Bases 文件报 YAML 错误去 obsidian-bases 技能的故障排查部分 对一下新手最常踩两个坑字符串里含冒号却没加引号公式里有双引号却没用单引号包裹整个公式。另外日期相减得到的是 Duration 类型要先取.days再参与数值运算。生成的画布打不开按 json-canvas 技能里的校验清单 过一遍JSON 能不能解析、ID 有没有重复、连线的fromNode/toNode是否都指向存在的节点、文本里的换行是否用了\n。链接在库里点了没反应检查是不是被写成了普通 Markdown 链接。库内笔记应该用[[wikilinks]]只有站外 URL 才用[](url)——这条规则在 Markdown 技能 里写得很明确。库很大AI 动作慢或超时用 CLI 先搜后改分批处理大批量筛选加limit控制返回量。别一次把上千条笔记丢给它。 从今天的一条笔记开始别指望装完技能库就自动变整齐。有效路径是挑一个最小的真实任务——比如把今天的三篇文章存进库、给一条老笔记补属性、建一张三行数据的表——跑通一条完整链路再逐步扩大范围。技能文件里的语法细节、工作流、校验清单都是按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),仅供参考
返回列表