企业官网建设流程全解析

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 的"方言"，标准 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 技能 接管：它给笔记补上 frontmatter（title、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 都知道该用什么语法、该避开哪些坑，你只需要说人话。

💬 怎么跟它说：一套好使的指令

几个让命中率明显提高的说法习惯：

1. 一次一个环节。"把这篇文章存进来并整理" 比 "把这个库全部理一遍" 稳得多。分步走，每步结果你都能肉眼验收。
2. 点名文件和文件夹。说清"存到 Reading 文件夹""只处理带#book标签的笔记"，AI 就不用猜范围。
3. 让它先说计划再动手。对批量操作先问"你打算改哪些文件、怎么改"，确认了再执行。
4. 要求它在 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