用 Obsidian Agent Skills 强化笔记工作流

如果你用 Obsidian 记笔记，kepano/obsidian-skills 能让 AI Agent 原生理解你的库，而不必在 Claude 与 Obsidian 之间来回复制内容。Agent 可以直接读取、创建和整理笔记。

本教程演示真实工作流：用 Claude Code + Obsidian Skills，把会议记录整理成结构化知识。

为什么这套 Skill 重要

Obsidian 使用 Markdown、Bases（数据库格式）和 JSON Canvas（白板格式），都是文本，适合 AI 操作。但 Agent 需要理解各格式的约定与结构才能产出有用结果——这正是本 Skill 提供的。

没有 Skill 时，Claude 能写 Markdown，但通常不知道：

• Obsidian 的双链语法（[[像这样]]）
• 插件期望的 frontmatter 约定
• Bases 查询如何写
• JSON Canvas 文件结构

安装

claude skill add --from-github kepano/obsidian-skills

会安装完整 Skill 集，包括：

• 创建与格式化 Markdown 笔记
• 处理 Obsidian 属性（frontmatter）
• 管理 JSON Canvas
• 查询 Bases

实战：把会议记录整理成知识

问题

开会时记粗糙笔记，会后需要：

1. 清理原文
2. 提取行动项
3. 链接到相关项目与人物
4. 归档到正确文件夹

手工大约 10–15 分钟/场。用 Obsidian Skill，Agent 可在几秒内完成大部分工作。

步骤 1：在库根目录打开 Claude Code

cd ~/my-obsidian-vault
claude

步骤 2：写入原始笔记

粘贴或写入原始会议记录，然后提示：

Take these raw meeting notes and create a proper Obsidian note in the Meetings/ folder with:
- YAML frontmatter with date, attendees, and meeting type
- A summary section
- Action items as a checklist with owners
- Wiki-links to any mentioned projects or people that have existing notes

Skill 会保证输出符合 Obsidian 约定：frontmatter、双链语法、一致的标题结构。

步骤 3：为新增主题建关联笔记

The meeting mentioned Project Phoenix and Sarah Chen. Create stub notes for both if they don't already exist, with basic structure and a backlink to the meeting note.

Skill 会创建结构正确的笔记并建立双向链接，Obsidian 关系图谱会自动显示连接。

实战：构建知识索引

场景

Projects/ 下有 50+ 项目笔记，想用画布展示项目间关系。

Read all files in Projects/ and create a JSON Canvas file at Projects/Map.canvas that shows the relationships between projects based on shared tags, people, and technologies.

Skill 熟悉 JSON Canvas 格式，生成的文件可在 Obsidian 画布视图中正确打开，节点与连线位置合理。

技巧

• 用 git 管理库，便于在提交前审查 AI 改动。
• 在库根目录运行 Claude Code，Skill 才能理解完整目录结构。
• 接受改动前用 git diff 检查——AI 很快，但哪些内容该进库仍由你判断。

何时不必使用

若不用 Obsidian，可跳过。其中的 Markdown 约定（双链、属性语法、画布格式）是 Obsidian 生态专用的。通用 Markdown 工作流用 Anthropic 官方 Skill 通常足够。

还想找更多效率类 Skill？查看 SkillMap 排行榜。