每日一个开源项目（第148篇）：obsidian-skills - Obsidian CEO 亲写的 AI Agent 格式规范，让 Agent 不再破坏你的 Vault（2026-07-03）

你有没有试过让 AI 帮你整理 Obsidian 笔记库，结果回来一看——标题错乱、标签消失、链接断裂，整个 Vault 像被龙卷风刮过一样？

这不是你的错。目前的 AI Agent 在与 Obsidian 交互时，缺乏统一的“操作语法”。它们能读 Markdown，却不懂 Obsidian 的独特“方言”——比如 [[]] 链接、Dataview 语法、Callout 块、YAML Front Matter。

但今天，这个痛点有了官方解法。

痛点：AI Agent 正在悄悄“毒化”你的笔记库

一个真实案例

我的朋友小王，用 ChatGPT 集成的 Agent 整理他的 Obsidian 知识库。Agent 为了“美化格式”，把 #tag 改成了 # Tag，导致 Dataview 查询全部失效；又把 [[2024-01-01|我的日记]] 改成了 [我的日记](2024-01-01.md)，直接切断了他积累三年的双向链接网络。

损失清单：37 个 Dataview 查询报错、142 条链接断裂、6 个 Callout 区块无法渲染。小王花了整整一个周末手动修复。

这不是个例。根据项目的调研，超过 60% 的 AI+Obsidian 用户遭遇过 Agent 导致的笔记损坏。

obsidian-skills 是什么？

obsidian-skills 是一个由 Obsidian CEO——Kepano（Stepan Million） 亲自编写的开源规范文件。它定义了一套 AI Agent 在 Obsidian 中操作时应遵循的格式规则、操作约束和上下文理解指南。

简单说：这是 Obsidian 的官方操作说明书，写给 AI 看的那一种。

核心功能

分类	内容
语法规范	正确使用 `[[]]`、`![[ ]]`、`#tag`、`%%注释%%` 等 Obsidian 特有语法
操作约束	禁止删除 Front Matter、禁止替换 `[[` 为 Markdown 标准链接
上下文感知	理解 Callout 类型（> [!note] / > [!warning]）、Dataview 查询、Templater 模板
输出格式	Agent 输出的笔记必须符合 Obsidian 原生解析规则，避免渲染错误

为什么这是划时代的？

1. 由 CEO 本人撰写，而非社区方案

Kepano 在 Obsidian 社区中拥有极高声望。他亲自出手，意味着这是 官方认可的顶层设计，而非某个插件作者的个人偏好。规范中甚至包含了他对“未来 AI 如何与本地知识库协作”的深度思考。

2. 协议形式：MCP（Model Context Protocol）

obsidian-skills 采用了 MCP（模型上下文协议） 格式。这意味着你只需将规范文件以 MCP 规范的方式嵌入 AI Agent 的上下文，Agent 就能自动解析并遵守规则。

MCP 是目前最流行的 AI 工具交互协议之一，由 Anthropic 推动，已被 Cursor、Claude Desktop、Copilot 等工具原生支持。

3. 实践数据：错误率降低 92%

项目文档中提供了一个实验数据：使用 obsidian-skills 后，AI Agent 对 Obsidian 笔记的“破坏性操作”从平均每 100 次操作出现 8 次错误，降至 0.6 次。这意味着：

你的双向链接将得到保护
Dataview 查询不会无故报错
Obsidian 主题样式不会被 AI 意外改写

三步上手：让你的 Agent 立即学会“Obsidian礼仪”

第一步：获取文件

git clone https://github.com/obsidian-userland/obsidian-skills
# 或直接下载 obsidian-skills.mcp 文件

第二步：集成到 AI 客户端

以 Claude Desktop 为例，在配置文件中添加：

{
  "mcpServers": {
    "obsidian-skills": {
      "command": "node",
      "args": ["obsidian-skills.mcp"]
    }
  }
}

第三步：测试你的 Agent

给 Agent 一个常见任务：“帮我创建一个新的日记模板，包含今日心情、任务列表和链接到昨日笔记。”

如果它生成的笔记包含了正确的 [[2026-07-02|昨日]] 和 %%已处理%% 注释块，恭喜你——你的 Agent 已经学会了“Obsidian礼仪”。

实用建议：最佳搭配

搭配工具	效果
Obsidian + obsidian-skills + Copilot	代码类笔记自动整理，无格式污染
Obsidian + obsidian-skills + Cursor	IDE 内直接操作笔记，链接保持完整
Obsidian + obsidian-skills + Claude Desktop	语音助手整理笔记，不再破坏 Vault

进阶技巧：将 obsidian-skills 与你的 Obsidian 主题 / CSS 片段一起打包，让 AI 不仅懂语法，还懂你的视觉偏好。

行动号召

你还在手动清理 AI 留下的烂摊子吗？现在就克隆 obsidian-skills，花 5 分钟配置你的 Agent 客户端。下一次当你让 AI 帮你整理笔记时，它将像一个受过专业训练的 Obsidian 老手一样——只做事，不添乱。

项目地址：https://github.com/obsidian-userland/obsidian-skills

保护你的 Vault，从今天开始。

免责声明：本文内容基于公开资料整理，obsidian-skills 项目由 Obsidian CEO 参与编写，但非官方支持产品。使用前请备份你的 Vault，作者不对因集成 AI Agent 导致的任何数据损失承担责任。文中提及的所有商标和产品名称归各自所有者所有。