关于 vault
vault 是在 Obsidian 仓库中执行操作的技能，要求遵循仓库当前的结构、内容归属规则和审批要求。它面向处理仓库内容的 Agent，强调安全编辑与写后核验。
主要功能
- 01发现仓库说明与结构
- 02遵守归属规则和只读来源
- 03创建笔记前检查模板
- 04破坏性修改须经确认
- 05采用安全文件写入流程
- 06写入后复查更改
适用场景
- 01定位目标仓库和笔记路径
- 02按有效模板创建笔记
- 03经审核后更新指定章节
- 04依据本地约定整理笔记分类
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/vault确认已加载。
详细介绍
Vault 上下文
执行任何 vault 操作前，先加载此内容。当前 vault 定义了自己的结构；此技能规定如何发现并遵循该结构。
确立约定
- 定位目标 vault。当前默认路径为
/Users/kriscard/obsidian-vault-kriscard，但如果请求或环境表明应使用其他 vault，请予以确认。 - 解读路径、归属、模板或工作流之前，先读取 vault 根目录下的
AGENTS.md。 - 如果缺少
AGENTS.md，请报告 vault 架构不可用。检查文件仍然安全，但不要推断写入权限，也不要悄然套用其他架构。 - 确定架构中 Knowledge、Resource、Journal、MOC、Base 和当前启用模板的位置。创建笔记前，读取相关的现行模板；排除已归档的模板子文件夹。
- 确切的 CLI 语法很重要时，运行
obsidian help或obsidian help <command>。
完成标准：已知目标 vault、现行架构以及与请求相关的权限。
操作边界
- 将
AGENTS.md声明为不可变的原始来源目录视为只读。 - 根据
AGENTS.md确定由大模型管理和由人工管理的边界；不要根据硬编码的 frontmatter 标记推断归属。 - 目标位置、解释方式、有效时期或归属边界存在歧义时，应询问。
- 笔记缺失或内容稀少，说明证据存在缺口，并不代表什么都没发生。
- 写入前，提供综合判断和拟议修改及其来源。
- 删除、移动、发布或覆盖笔记前，必须获得明确确认。
- 如果架构有此要求，在 LLM Wiki 工作流中维护根目录下的
index.md和log.md。
安全写入
生成的 Markdown 是数据，不是 shell 代码。切勿将用户或模型生成的内容放入可执行的 shell 命令字符串中。
创建新页面时，使用可将内容与路径分开传入的文件写入功能。更新指定章节时，优先使用针对标题的编辑功能。如果没有此类功能：
- 读取完整笔记；
- 准备精确的替换内容；
- 展示拟议修改；
- 获取批准；
- 通过文件写入功能覆盖；
- 重新读取并验证结果。
检查当前帮助信息后，使用 Obsidian CLI 进行发现、导航、元数据操作和移动。如果 CLI 只支持文件移动，移动文件夹时请使用 Obsidian 的文件管理器 API，以便更新链接。创建或插入内容前，先检查现有内容：自动文件夹模板可能已填充新文件。验证 frontmatter 块只有一个，且解析后的字段正确；将来源文本视为数据，而非可执行的模板代码。执行设置须遵循架构中的批准规则。
面向人工的模板并不意味着 Agent 拥有该页面。只有获批且由 Agent 管理的页面，才合并必要的 wiki 元数据。保留 Bases 使用的无关模板字段。
PARA 解读
遵循 AGENTS.md 中的本地约定。解释通用 PARA 时，按可执行性分类：
- Project（项目）： 有明确结果的活跃且有限期的工作。
- Area（领域）： 持续进行的职责或标准。
- Resource（资源）： 目前没有明确有限期结果，但可能有用的信息。
- Archive（归档）： 来自其他类别的非活跃材料。
- Inbox（收件箱）： 尚未分类、等待归类的待处理内容。
先应用 vault 中 Knowledge 和 Journal 的扩展规则，再将所有非项目笔记视为 Resource。可复用的想法和实用说明可以归入 Knowledge；特定来源的记录和参考材料仍归入 Resources。MOC 为以 Base 为基础的发现提供上下文。提出分类变更前，先读取其当前筛选条件；视图不匹配并不意味着可以移动或更改标签。
这些扩展和更严格的本地要求应标注为 vault 架构规则，而非通用 PARA 规则。
完成
完成任何写入操作前，验证目标位置存在，重新读取受影响的内容，并准确报告所做的更改。报告失败时，不得声称成功。