name: obsidian-vault description: "使用 wikilink 和索引笔记搜索、创建、管理 Obsidian 知识库笔记。用户希望在 Obsidian 查找、创建或整理笔记时使用。"
第 49 课 / obsidian-vault
历史对照：识别作者个人环境假设
这份历史技能直接写入作者自己的 Obsidian 路径和组织约定，是学习“开源技能不能原样套用”的好案例。
历史文件，不在当前目录
本课使用下方注明的历史提交原文，帮助理解旧文章和旧提示词。请勿据此认定当前版本仍能直接调用该名称。
还不清楚 Skill、Agent、安装和调用？先读 从零开始的6节入门课。
在关系图中查看 obsidian-vault 与其他技能的关联 →
一 / 读这一课之前
先把必要的概念讲清楚
这份历史技能描述作者的个人笔记习惯。可迁移的是通过链接组织知识的方法，不是照搬他的磁盘路径和所有命名偏好。
下面是老师补充的入门说明；原作者的要求保留在中英对照正文中。所有例子均为帮助理解而构造的教学情境。
CLI｜命令行界面
通过输入文字命令操作程序，例如运行测试或检查 Git 状态。它与点按钮一样是操作入口，只是参数更容易记录、重复执行。读命令时先分清程序名、子命令、选项和目标路径；看懂命令不等于已执行它。
context pointer｜上下文资料指引
告诉 Agent 在什么条件下去读哪份材料的短指引。例如“新增或修改数据写入时，先读权限规则文档”。它同时承担地址与触发条件两项作用。只有“见文档”太模糊，可能找不到或不知道何时需要；一股脑放入所有内容又会占用上下文。
context｜Agent 当前可用的上下文
模型这一轮实际能使用的请求、对话、指令和已读文件内容。它不是电脑上所有资料，也不是永久记忆。文件存在但没被读到，就不一定参与推理。交接文档应指明当前目标、进度、关键证据位置和下一步，让新会话能够恢复必要背景。
二 / 中英全文对照与精讲
读原文，理解每一步为什么这样做
左右内容按小节对应；窄屏先中文、后英文。两种语言均完整展示，对应讲解紧接在小节之后。译文传达原文要求；老师讲解补充概念、原因、例子与适用边界。
译注
知识库路径是作者的本地环境示例，不是你的路径。
中文译文English · 英文原文
name: obsidian-vault description: Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
在 Obsidian 笔记库中工作
Obsidian Vault
笔记库位置
作者使用的目录是 /mnt/d/Obsidian Vault/AI Research/。
大多数笔记直接放在根目录，整体采用较平铺的结构。
Vault location
/mnt/d/Obsidian Vault/AI Research/
Mostly flat at root level.
老师讲解 · 对应上方原文 · 含教学举例
路径属于作者环境，知识结构才是学习重点
vault 是 Obsidian 存放笔记的目录。原文的 /mnt/d/... 是作者本机路径，不能据此判断你的电脑有相同目录。
作者采用较平铺的文件结构，通过索引笔记与链接组织主题。另一种深目录方式也可能合理；这里没有证明所有知识库都应禁止文件夹。
在任何工具中先找到真实资料位置，是操作前提。凭记忆向不存在的路径写文件，可能创建一套与实际笔记库无关的新目录。
命名约定
- 索引笔记用来汇集相关主题，例如
Ralph Wiggum Index.md、Skills Index.md、RAG Index.md。 - 所有笔记名称使用英文标题式大小写。
- 不靠不断增加文件夹分类，改用链接和索引笔记组织。
Naming conventions
- Index notes: aggregate related topics (e.g.,
Ralph Wiggum Index.md,Skills Index.md,RAG Index.md) - Title case for all note names
- No folders for organization - use links and index notes instead
如何链接
- 使用 Obsidian 的
[[wikilinks]]写法，例如[[Note Title]]。 - 在笔记底部链接它所依赖或相关的其他笔记。
- 索引笔记本身是一组
[[wikilinks]]列表。
Linking
- Use Obsidian
[[wikilinks]]syntax:[[Note Title]] - Notes link to dependencies/related notes at the bottom
- Index notes are just lists of
[[wikilinks]]
老师讲解 · 对应上方原文 · 含教学举例
双向链接让概念之间建立可追踪关系
[[Note Title]] 是 Obsidian 的内部笔记链接。索引笔记把相关主题聚在一起，反向链接帮助看哪些笔记引用当前概念。
例如“测试接入点”笔记可以被 TDD、排错和架构设计共同引用。以后澄清这个概念时，你也能找到哪些学习记录受影响。
链接本身不证明内容正确，也不自动解决同名不同义。笔记应该围绕一个可理解的学习单元，写清定义与应用情境。
索引和链接怎样代替越来越深的文件夹？
假设你有“测试接入点”“收藏案例”“上下文交接”三篇笔记。一篇“软件工程学习索引”可以链接三者；“收藏案例”还可以链接“测试接入点”。读者能从不同主题进入同一份内容，不必复制多份文件。
[[测试接入点]] 表示链接到这个名称的笔记。反向链接则回答“谁引用了它”，有助于找到相关学习场景。
这里的固定路径属于作者自己的电脑，不是你的设备默认就有的目录。实际使用必须确认你自己的笔记库位置和访问权限。Markdown 文本说明组织方法，读取或修改文件仍由具备文件工具的 Agent 执行。
一个学习单元应能清楚解释一个主题，并引用必要背景；它不意味着必须短到只有定义。你的笔记仍可以保留完整例子和理解过程。
常用流程
Workflows
老师讲解 · 对应上方原文 · 含教学举例
搜索文件名与搜索正文回答不同问题
按文件名找，是寻找你记得标题的笔记；按内容找，是寻找某词出现在哪里。grep 的递归搜索和 find 的文件枚举是作者提供的命令方式，也可用相应工具完成。
创建笔记后链接相关资料，比单独堆一个孤立文件更利于复用。编号只在确实属于序列时使用，别为了形式给所有概念强行排序。
这份 skill 不会自动把你的学习材料转成高质量知识库。高质量来自具体认识、准确关系和后续使用中的修订。
搜索笔记
下面的第一条按文件名查找，第二条按正文查找：
# Search by filename
find "/mnt/d/Obsidian Vault/AI Research/" -name "*.md" | grep -i "keyword"
# Search by content
grep -rl "keyword" "/mnt/d/Obsidian Vault/AI Research/" --include="*.md"
也可以直接对笔记库目录使用 Grep 或 Glob 工具。
Search for notes
# Search by filename
find "/mnt/d/Obsidian Vault/AI Research/" -name "*.md" | grep -i "keyword"
# Search by content
grep -rl "keyword" "/mnt/d/Obsidian Vault/AI Research/" --include="*.md"
Or use Grep/Glob tools directly on the vault path.
创建新笔记
- 文件名采用标题式大小写。
- 按笔记库约定，将正文写成一个独立的学习单元。
- 在底部添加相关笔记的
[[wikilinks]]。 - 如果属于带编号的系列，采用层级编号规则。
Create a new note
- Use Title Case for filename
- Write content as a unit of learning (per vault rules)
- Add
[[wikilinks]]to related notes at the bottom - If part of a numbered sequence, use the hierarchical numbering scheme
找到相关笔记
在整个笔记库搜索 [[Note Title]]，就能找到哪些笔记引用了它，也就是反向链接：
grep -rl "\\[\\[Note Title\\]\\]" "/mnt/d/Obsidian Vault/AI Research/"
Find related notes
Search for [[Note Title]] across the vault to find backlinks:
grep -rl "\\[\\[Note Title\\]\\]" "/mnt/d/Obsidian Vault/AI Research/"
找到索引笔记
find "/mnt/d/Obsidian Vault/AI Research/" -name "*Index*"
Find index notes
find "/mnt/d/Obsidian Vault/AI Research/" -name "*Index*"
三 / 你问我答
先作答，再看参考思路
Q1 · 理解
用自己的话说明：它解决什么问题，完成后会留下什么？
请各用一句话回答。若它只做规划或解释，不要把“已开发”“已部署”写成产物。
Q2 · 判断
从这份技能中最值得迁移的是路径还是方法？
我已思考，查看参考思路
方法：先查已有笔记，以链接建立关系，用索引帮助导航。路径与命名应适配你自己的真实环境。
Q3 · 追问
原文中哪条要求在你的环境下可能不成立？
说出具体一句及其前提，例如工具不可用、资料缺失、已有项目约定冲突，或它只是作者偏好。把你的答案带回课堂，我们据此继续讨论。
课堂回传格式：第 49 课 / 我的理解 / Q2 回答 / 仍不理解的原句。这里是阅读教材；实时问答在我们的对话中进行。
四 / 应用场景讨论
把方法放进一个具体情境
教学案例：把课堂知识写入你已有笔记系统时，应复用实际存储方式。不能看到开源路径就照抄，也不能把缺目录误判成笔记丢失。
边界与容易误读的地方
它是个人约定，不是 Obsidian 的强制规范。禁止文件夹也是作者选择，不能推广为所有知识管理的最佳实践。
讨论后再实践：先判断上述情境是否适用，再选择真实任务。现在无需安装、运行命令或修改现有项目。