开发 Obsidian 的公司 CEO 发布了一份免费的 AI 使用说明书。
你可以在这里找到它：
https://github.com/kepano/obsidian-skills
里面只有 5 个文本文件。安装只需 5 分钟，而且不会破坏你现有的任何笔记。
添加这些文件后，AI 就能理解 Obsidian 特有的格式。这是对"AI 把我的笔记搞乱了"这一问题的官方解答。
当看到这个话题成为热门，我打开自己的 Obsidian 环境准备安装时，发现它早就已经在了……
文件日期是 4 月 26 日。我三个半月前就安装好了，然后完全忘掉了（笑）。
那么，这三个半月里我的 Obsidian 发生了什么变化呢？我很好奇，但结果相当令人失望。
直接说结论：光靠官方说明书是不够的。还有一页，需要你自己来写。
AI 不知道的是 Obsidian 特有的语法
Obsidian 有一些不同于普通笔记应用的独特功能。
要链接笔记，需要用 [[ ]] 把它们括起来。（链接）
要让笔记突出显示，需要使用特定语法创建彩色框。（标注）
文件最顶部有一个用于填写日期和标签的区域。（属性）
AI 写的时候不知道这些。所以文字可能没问题，但在 Obsidian 中打开时，链接没有连上，或者框没有显示出来。
我开头提到的 5 个文件填补了这个空白。它们分为以下几类：
- obsidian-markdown（链接和框的正确语法）
- obsidian-bases（像数据库表格一样整理笔记）
- json-canvas（创建用线条连接笔记的图表）
- obsidian-cli（通过命令搜索整个笔记库）
- defuddle（将网页导入为干净笔记）
你可以从上面的链接免费获取。
它们不针对任何特定 AI 工具，所以用 Claude Code 或 Codex 效果一样。
安装 3.5 个月后，几乎没有任何变化
说实话，我发现它们的时候笑了。我早就有了这份著名的说明书……而且我根本没意识到（笑）。
不过，由于它们只在 Claude Code 里生效，我在 8 月 9 日把同样的 5 个文件复制到了 Codex，这样两边都能用。
现在，重点来了。
三个半月后，我的 Obsidian 有什么变化？
- 使用标注的笔记：1,387 篇中有 32 篇
- 数据库视图：1 个
- Canvas：1 个
几乎没有任何变化。
这倒不是说官方说明书不好。内容当然做得很精良。
我刚安装的时候试了试，觉得"哦，挺方便的"，然后就没了。因为我还没决定好什么时候用它们，结果自然就是这样。
什么都没变，原因很清楚：官方说明书教的是"怎么写"。
知道怎么写，并不会增加你写的内容。也不会决定该把东西放在哪里。
给 AI 的说明书有两种
我觉得这一点非常重要。
给 AI 的说明书有两种。
- 正确的 Obsidian 语法。这对每个人的 Obsidian 来说都一样，所以由官方团队提供。
- 你自己的内部规则。什么东西放哪里。哪些区域可以碰。成品应该放在哪里。
官方团队只提供前者。
而笔记库变乱的根源通常是后者。语法正确但放错了位置，比出现语法错误更麻烦。
没有"内部规则"时，你会遇到这些问题：
- 写好的文章每次都保存到不同的文件夹。
- AI 往你想保持只读的日记里添加内容。
- 明明改了文件夹名称，新笔记却一直出现在旧名称下。
这些情况下语法都没问题。只是放置位置和处理方式不对。
例如，官方说明书说："用链接连接相关笔记。"这没错。
但我的规则正好相反：只有我"以后一定会打开"的笔记才加链接。如果链接增加太多，反而什么都找不到。
这不是谁对谁错的问题，只是官方说明书无法考虑到我的具体情况。
无论你多频繁地使用 AI，资产都不会自己增加。材料你本来就有，缺的只是"容器"。
官方说明书教会你容器的"形状"，但把什么放在哪里，必须由你自己决定。
━━━━━━━━━━━━
如果你在用 AI，却觉得产出内容并没有变轻松：
把材料集中放在一个地方，不要每次都从零开始。
我开设了"Minami 的 Obsidian × AI Agent 实操日志"。
在这里免费阅读 ↓
https://lifebaselab-m.com/p/r/j8MTvDdP?free1=x
━━━━━━━━━━━━
你的内部规则最少需要 4 项
我在 Obsidian 里创建了一个名为"操作规则"的文件，把所有内容都写在里面。Claude 和 Codex 在开始工作前都会先读取它。
以下是最起码能让系统运转起来的 4 项：
- 可触碰区域 vs. 只读区域。 我的情况下，日记、网页剪辑和未分类笔记都是只读的。这是最重要的一项。
- 成品的去处。 固定位置：X 的帖子放这里，Note 文章放那里。这样 AI 就不会每次都来问。
- 拿不定主意时的兜底方案。 如果 3 秒内不确定，就放到"未分类"。这样可以避免在分类上卡住。
- 确定一个修改规则的地方。 不要随手把操作规则写在零散的笔记里。固定主文件。
尤其重要的是第 4 项。没有它，规则会散落各处，你都分不清哪个是最新版本。
我每周检查，确保装完不是终点
前面提到的 5 个文件中有一个 obsidian-cli，它可以用命令检查整个笔记库。能找出孤立笔记、标签使用次数和断开的链接。
它很有用，但不运行就白搭。
所以，我把这个"检查"设置为每周自动运行。每个周日早上自动执行，生成一份包含可疑断链和被忽视笔记的报告。
最大的好处就是不需要记得去做。
"安装了"和"在运行"是两回事。
我作为一个装了三个半月却毫无变化的人这么说，应该没错吧（笑）。
结论
安装官方说明书只需 5 分钟。免费，而且不会破坏你的笔记。做了没有坏处。
但那只是改变语法。
把 Obsidian 交给 AI 后会变乱，不是因为你用得不好。只是你还没有一个 AI 能读取的"内部规则"文件。
所以，不用觉得在委派之前必须把所有东西背下来。官方团队提供语法，你只需要写一页。
如果你打算今天开始，就先写一行，划清 AI 可以触碰和不能触碰的界限。"日记文件夹是只读的，不要改写它"就足够了。
即使只有这一行，也能大幅减少 AI 做完后你需要修修补补的工作量。
━━━━━━━━━━━━
感谢你读到最后！
公告 📢
我在举办 Open Chat！
以增加"Obsidian 同好"为目标，每天分享一些我不会发在 X 上的 Obsidian × AI Agent 的故事。
我还会发放礼物，感兴趣的话来看看 ↓
