Obsidian Knowledge
与用户共享 MyObsidian vault。所有 vault 操作必须通过 obsidian CLI,不要用 Read/Write/Edit 等文件工具直接读写 vault 里的 .md 文件。
首要规则
每个会话首次触及 vault 之前,先读 AGENTS.md 获取当前 vault 的目录、标签、frontmatter 和隐私规范:
obsidian vault=MyObsidian read file="AGENTS"
AGENTS.md 是 vault 规范的唯一来源。本 skill 不重复定义任何目录、标签或 frontmatter 字段。
强制使用 CLI
以下操作必须用 Obsidian CLI,禁止用文件工具替代:
| 操作 | 原因 |
|---|---|
| 读取笔记 | CLI 自动解析 wikilinks 和 file name |
| 搜索 vault | 文件工具无法做全文搜索 |
| 创建/覆写笔记 | CLI 自动处理 frontmatter、触发 Obsidian 索引 |
| 追加内容 | CLI 保证不破坏已有结构 |
| 更新 frontmatter | property:set 安全修改单个字段 |
| 移动/重命名 | move 自动修复所有 wikilinks |
| Daily 读写 | CLI 自动定位到正确的 Daily 文件路径 |
错误示例(不要这样做):
# ❌ 用 Read 直接读 vault 文件
cat /Users/zhuxining/MyObsidian/01_Daily/2026/06/2026-06-25.md
# ❌ 用 Write 直接写 vault 文件
正确做法:
# ✓ 用 CLI 读
obsidian vault=MyObsidian read file="AGENTS"
# ✓ 用 CLI 追加 Daily
obsidian vault=MyObsidian daily:append content="- 记录了某件事"
常用命令
vault=MyObsidian 必须作为第一个参数。
# === 查找 ===
obsidian vault=MyObsidian search query="关键词" limit=20
obsidian vault=MyObsidian search:context query="关键词" limit=20
# === 读取 ===
obsidian vault=MyObsidian read file="笔记名"
obsidian vault=MyObsidian read path="目录/笔记.md"
# === 创建 ===
obsidian vault=MyObsidian create path="目录/笔记.md" content="<内容>" silent
# === 覆写 ===
obsidian vault=MyObsidian create path="目录/笔记.md" content="<新内容>" overwrite silent
# === 追加 ===
obsidian vault=MyObsidian append file="笔记名" content="<追加内容>"
# === 属性 ===
obsidian vault=MyObsidian property:set file="笔记名" name="updated_at" value="YYYY-MM-DDTHH:mm:ss"
# === 移动(自动更新所有 wikilinks) ===
obsidian vault=MyObsidian move file="笔记名" to="目标目录/笔记名.md"
# === Daily ===
obsidian vault=MyObsidian daily:read
obsidian vault=MyObsidian daily:append content="<内容>"
# === 浏览 ===
obsidian vault=MyObsidian files folder="目录"
obsidian vault=MyObsidian folders
更多命令:references/obsidian-cli.md 或 obsidian help。
回退
如果 CLI 不可用(当前环境无法运行 obsidian),先说明原因。用户确认后,才可用文件工具直接操作 vault。