交出几千篇笔记后才发现最该教 Agent 的是不做什么

你会得到什么

把你的 Obsidian 笔记库交给一个 Agent（Claude Code、Codex 或 Grok Bot 都可以）帮你管：先做一次只读体检看清问题，再定好它能碰哪里、不能碰哪里，装上两套现成的 Obsidian Skill，最后让它帮你找相关笔记、清理孤立笔记。文中有 3 段可直接复制的提示词。

这篇的重点不是让 Agent 多干活，而是先写清楚哪些事不让它干。 一位重度笔记用户把五千多篇笔记交给 Agent 管了一个多月，回头看，帮助最大的几条，都是在给它划禁区。

为什么要先定边界

Agent 很擅长"做"：批量建页面、补链接、整理格式，一晚上能改几千个文件。问题在于，笔记库里最缺的往往不是整齐，而是想清楚的内容。让它一键整理，多半只会得到一批更整齐的空壳。

开始之前先记住三点：

笔记是文件，工具可以换。 你的笔记是普通的 .md 文件，Agent 只是来帮忙的，库的结构由你定。
Agent 写的东西和你写的分开放。 以后才分得清哪些是你的想法，哪些是机器的产出。
批量删改先问。 删除、批量加链接、批量移动，没你点头就不动。

第 1 步：先做一次只读体检

第一次只让它数数，什么都不改。把下面这段发给 Agent，路径换成你的库：

请对我的 Obsidian 库 [库的路径] 做一次只读体检，不要修改、移动或创建任何文件。

统计并告诉我：
1. 一共多少篇 .md 笔记，各个顶层文件夹分别多少篇；
2. 有多少"短桩"（小于 50 字节、几乎没有内容的笔记），主要在哪些文件夹；
3. 有多少未解析的链接（[[链接]] 指向不存在的笔记）；
4. 有多少孤立笔记（没有任何笔记链接到它，它也不链接别的笔记）；
5. 用三五句话说说这个库最大的问题是什么，再给三条建议，但先不要执行。

把结果存下来，一个月后用来对比。那位用户第一次体检时，五千多篇笔记里根目录将近四成几乎是空的，悬空的链接有八千个左右，诊断结论是"收集伪装成思考"：收了很多，想明白的很少。

第 2 步：定文件夹和护栏

这一步决定了 Agent 以后的行为。把规矩写成一段话，存进它每次都会读的地方（Claude Code 是项目的 CLAUDE.md，Grok Bot 是 bot 的说明），别指望它记住聊天里说过的话。

这段关键内容需要登录后解锁

新用户注册就送 10 积分，每天签到再领 1 积分。用 1 积分解锁，以后随时回来都能看。

最后两条护栏看起来小，其实最关键：Agent 最容易做的"修复"，就是给每个断链建一个空页面，链接看起来全好了，库里却又多了一批空壳。

第 3 步：装两套现成的 Skill

Skill 是写给 Agent 的操作说明，装上以后它就知道 Obsidian 的笔记格式和规矩，不用每次重新教（不了解的话看 Skill 手册）。在终端里运行：

npx skills add https://github.com/kepano/obsidian-skills
npx skills add https://github.com/Jackywine/jackywine-digital-garden-skills

第一套来自 Obsidian 的 CEO kepano，教 Agent 正确写 Obsidian 的 Markdown、Bases、Canvas，以及使用 Obsidian 官方的命令行工具（CLI）。
第二套是上面那位用户开源的，包括首次设置、剪藏、找相关笔记（related-notes）、找孤立笔记（orphan-notes）等。它和第一套互补，不包含第一套的内容，两套都要装。

装完重启 Agent。第一次对话时，让它运行 digital-garden-onboarding：它会一次问一个问题，带你把称呼、库路径、文件夹约定和护栏都定下来。

再打开 Obsidian 的命令行工具（按官方 CLI 文档开启）。有了它，Agent 查标签、查反向链接只要一条命令，不用每次把整个库扫一遍，又快又省额度。

第 4 步：日常让它做两件事

最值得交给 Agent 的不是"整理"，而是这两件：

我今天想到：[你的一个想法]。
请用 related-notes 在库里找 3 到 5 篇相关的笔记，每篇写一句"为什么现在值得一起看"，附上 obsidian:// 链接。
不要自动加双链，不要复述我刚说的话；找不到真正相关的就直说。

请用 orphan-notes 找出库里的孤立笔记，以及"几乎相关但没连上"的笔记对，列成清单放进 AI outputs/。
只读，不要加链接、不要删除；我挑完再告诉你哪些要连。

第一段的关键是"每篇写一句为什么"：如果它只会把你刚说的话换个说法再说一遍，这个功能就没有价值。

第 5 步：一个月后再体检一次

用第 1 步同一段提示词再跑一次，和上次对比。那位用户一个月后的结果很能说明问题：悬空链接从约八千降到四千多，少了将近一半；但根目录里的短桩比例几乎没变。

链接可以靠工具修，没写出来的想法工具修不了。所以最后那件事不要交给 Agent：从短桩里抽二三十条，自己一条条过，能写成完整观点的补完，写不出来的删掉。

注意

笔记不到一千篇的，用不上这套。 先把内容写出来，比整理更要紧。
指望 Agent 一键把库理整齐的，也不适合。 这套方法的核心恰恰是让它少动手。
令牌和密码不要贴进对话。 那位用户推送仓库时把 GitHub 访问令牌贴进过聊天记录，事后只能吊销重换。
这套是单人库的做法，多人协作的知识库要另外设计权限。
想先把 Obsidian 和 Agent 接起来，看教程把 Obsidian 接到 AI Agent，以及 Obsidian 手册。