Obsidian Skills 实测报告：哪些能用，哪些是坑

前言：全网吹捧的工具，真的好用吗？

最近全网都在推荐 Obsidian Skills，说它能让 AI 完美操作 Obsidian 笔记，简直是"第二大脑"的神器。

但实际体验如何？我花了一上午时间实测，结果让人大跌眼镜。

这篇文章不跪舔、不吹捧，只讲实测结果：

✅ 哪些功能真的能用
❌ 哪些功能只是看起来美好
🤔 是否值得你花时间折腾

如果你正在考虑使用 Obsidian Skills，这篇文章能帮你避坑，节省时间。

什么是 Obsidian？

$!info\] Obsidian 简介 Obsidian 是一款基于本地 Markdown 文件的知识管理工具，被誉为"你的第二大脑"。$

核心特点

双向链接 ：通过 [[笔记名称]] 建立笔记之间的关联
图谱视图：可视化展示知识网络
插件生态：丰富的社区插件扩展功能
数据安全：所有数据存储在本地，完全掌控

$!warning\] 格式兼容性问题 Obsidian 有一个独特的语法体系（维基链接、Callout、Frontmatter 等），这让普通 AI 工具很难生成符合格式的内容。$

Obsidian Skills：AI 与笔记系统的完美结合

核心价值

Obsidian Skills 是 Obsidian 团队开发的一组开源工具，专门帮助 AI 工具（如 [[Claude Code]]）理解和生成符合 Obsidian 格式的内容。

三大核心技能

$!tip\] obsidian-markdown 让 AI 生成符合 Obsidian 格式的增强型 Markdown **支持的语法**： * 维基链接：`[[笔记标题]]` * 嵌入内容：`![[图片.png]]` * Callout 块：`> [!note]` 提示框 * Frontmatter 属性：YAML 格式的元数据 \[!warning\] obsidian-bases ⚠️ 实测不可用专注于 Obsidian 的数据库功能支持 **核心功能**（理论上）： * 过滤器和排序 * 公式计算 * 数据汇总 * 视图管理 **实测结果**：经过多次测试，该 skill 只显示加载成功，但无法生成任何实质性输出。建议使用 obsidian-markdown skill 或 Dataview 插件替代。 \[!tip\] json-canvas 让 AI 直接编写 Obsidian Canvas 文件 **应用场景**： * 思维导图 * 流程图 * 知识图谱$

安装 Obsidian Skills：两种方式

前置条件

$!important\] 安装要求 1. 已安装 \[\[Claude Code\]\]（Claude 官方命令行工具） 2. 已安装 \[\[Obsidian\]\] 并创建了笔记库 \[!info\] 仓库地址 Obsidian Skills 官方仓库： https://github.com/kepano/obsidian-skills 这是 Obsidian 团队维护的开源项目，包含三个核心 skill： * obsidian-markdown * obsidian-bases * json-canvas$

方式一：市场安装（推荐）

第一步：打开 Claude Code

在终端中启动 Claude Code：

bash 复制代码

# Windows PowerShell
claude

# macOS/Linux
claude

第二步：添加插件市场

在 Claude Code 对话框中输入：

bash 复制代码

/plugin marketplace add kepano/obsidian-skills

第三步：安装插件

bash 复制代码

/plugin install obsidian@obsidian-skills

$!success\] 安装成功安装成功后，你会看到类似提示： ✓ 已成功安装 obsidian-markdown skill ✓ 已成功安装 obsidian-bases skill ✓ 已成功安装 json-canvas skill$

方式二：手动安装

适用场景：如果市场安装失败，可以尝试手动安装。

步骤：

克隆或下载 Obsidian Skills 仓库：
bash 复制代码
```
git clone https://github.com/kepano/obsidian-skills.git
```

将仓库内容复制到 Obsidian vault 根目录的 .claude 文件夹：

复制代码

你的Obsidian笔记库/
└── .claude/
    └── obsidian-skills/
        ├── obsidian-markdown/
        ├── obsidian-bases/
        └── json-canvas/

重启 Claude Code，技能会自动加载。

$!tip\] 官方文档更多安装细节请参考： https://docs.anthropic.com/claude-code \[!warning\] 实测警告虽然显示"安装成功"，但根据实测，**obsidian-bases skill 实际无法正常使用**。安装后只有 obsidian-markdown 和 json-canvas 真正可用。$

实战体验：让 AI 帮你整理笔记

场景一：批量生成读书笔记

你的需求 ：

"使用obsidian skill 帮我为《原则》这本书创建一套笔记结构，包括核心观点、金句摘录和个人思考"

AI 的输出（自动符合 Obsidian 格式）：

markdown 复制代码

---
title: 原则 - 读书笔记
author: 瑞·达利欧
tags:
  - 读书笔记
  - 管理
  - 决策
created: 2026-01-12
---

# 原则 - 读书笔记

## 核心观点

> [!important] 核心理念
> 原则是应对现实的基本准则，帮助你在相似情境下做出更好的决策。

### 1. 极度求真
- [[极度求真的五个层次]]
- [[如何建立反馈循环]]

### 2. 极度透明
- [[透明文化的建立]]
- [[可信度加权决策]]

## 金句摘录

> [!quote]
> "痛苦 + 反思 = 进步"

相关笔记：[[成长型思维]]

## 个人思考

![[原则思维导图.canvas]]

场景二：创建知识图谱

你的需求 ：

"JSON Canvas skill 帮我创建一个关于 AI 技术栈的 Canvas 思维导图"

AI 会自动生成 .canvas 文件：

结构化的 JSON Canvas 文件
包含节点、连线、分组
可直接在 Obsidian 中打开编辑

$!example\] Canvas 示例生成的 Canvas 文件会包含： * 文本节点：核心概念说明 * 文件节点：链接到相关笔记 * 链接节点：外部资源引用 * 分组节点：逻辑分类$

场景三：数据库管理 ⚠️ 待确定（验证不通）

$!danger\] 实测警告：obsidian-bases skill 无法正常使用 **经过多次实际测试验证，obsidian-bases skill 存在严重问题：** * ✅ 显示：`Successfully loaded skill` （加载成功） * ❌ 实际：没有任何实质性输出，无法生成 `.base` 文件 * ❌ 结果：只是表象成功，实际功能完全不可用 * ❌ 验证状态：**本人实测验证不通过，功能无法使用** **测试环境**： * Claude Code 最新版本 * Windows 11 + PowerShell * 多次重复测试，结果一致 **疑问**：全网博主都在推荐 obsidian-bases skill，但实测根本无法使用。可能是个人环境问题，也可能是该 skill 本身存在 bug。如果你成功使用过，欢迎指正！ **替代方案** ：建议直接使用 obsidian-markdown skill 手动创建 `.base` 文件，或使用 Obsidian 的 Dataview 插件。$

你的需求（理论场景） ：

"使用obsidian-bases skill 帮我创建一个项目管理数据库，包含任务名称、优先级、截止日期和状态"

理论上 AI 应该自动创建 .base 文件（但实测无法实现）：

yaml 复制代码

---
filters:
  and:
    - file.hasTag("project")
    - 'status != "archived"'

formulas:
  days_until_due: 'if(due, ((date(due) - today()) / 86400000).round(0), "")'
  is_overdue: 'if(due, date(due) < today() && status != "done", false)'

properties:
  status:
    displayName: 状态
  formula.days_until_due:
    displayName: "剩余天数"

views:
  - type: table
    name: "进行中的任务"
    filters:
      and:
        - 'status == "in-progress"'
    order:
      - file.name
      - priority
      - due
      - formula.days_until_due
---

永远都是Successfully loaded skill，我已经调用了 obsidian-bases skill 来为你创建项目管理数据库，就没下文了。我要的不是一个.base的文件，我此时此刻就是在测试验证obsidian-bases skill能否成功创建一个数据库.base文件，事实证明，他永远只会Successfully loaded skill，他是真的在后台运行创建吗，还是就死掉了

效果对比：有无 Obsidian Skills 的差异

对比维度	普通 AI	使用 Obsidian Skills
链接格式	`[笔记](笔记.md)` ❌	`[[笔记]]` ✅
Callout 支持	不支持 ❌	`> [!note]` ✅
Frontmatter	格式错误 ❌	YAML 格式正确 ✅
Canvas 生成	无法生成 ❌	直接生成 JSON ✅
数据库操作	不理解 ❌	⚠️ 理论支持，实测不可用
批量重构	手动修改 ❌	自动化处理 ✅

适用场景：谁应该使用 Obsidian Skills？

个人知识管理者

$!check\] 适用场景 * 快速构建知识体系 * 自动整理读书笔记 * 生成学习路线图$

内容创作者

$!check\] 适用场景 * AI 辅助写作，格式自动规范 * 批量生成文章大纲 * 管理创作素材库$

项目管理者

$!check\] 适用场景 * 创建项目数据库 * 可视化项目进度 * 自动生成会议纪要$

研究人员

$!check\] 适用场景 * 文献笔记整理 * 知识图谱构建 * 研究思路可视化$

进阶技巧：让 AI 更懂你的笔记

1. 自定义 Prompt

在 Claude Code 中添加项目级配置文件 CLAUDE.md：

markdown 复制代码

# 我的 Obsidian 笔记规范

## 笔记命名规则
- 使用中文标题
- 日期格式：YYYY-MM-DD
- 标签体系：#领域/子领域

## 常用模板
- 读书笔记：包含核心观点、金句、思考
- 项目笔记：包含目标、进度、问题
- 会议纪要：包含时间、参与者、决策事项

2. 批量重构笔记库

复制代码

帮我检查笔记库中所有的外部链接，将 Markdown 格式转换为维基链接格式

3. 自动生成索引

复制代码

帮我为 "AI 学习" 文件夹生成一个 MOC（Map of Content）索引页面

注意事项与最佳实践

⚠️ 使用前必读

$!warning\] 重要提醒 1. **备份笔记库**：在让 AI 批量操作前，务必备份你的 Obsidian 笔记库 2. **逐步验证**：先在测试笔记上尝试，确认效果后再批量应用 3. **版本控制**：建议使用 Git 管理笔记库，方便回滚$

✅ 最佳实践

$!tip\] 使用建议 1. **明确指令**：告诉 AI 你的笔记规范和格式要求 2. **分步执行**：复杂任务拆解为多个小步骤 3. **人工审核**：AI 生成的内容需要人工审核和调整 4. **持续优化**：根据使用体验不断优化 Prompt$

总结：理想很丰满，现实很骨感

经过一上午的实测，Obsidian Skills 的真实情况是：

✅ 真正能用的

$!success\] obsidian-markdown skill * **实测可用**：能生成符合 Obsidian 格式的 Markdown * **核心价值**：维基链接、Callout、Frontmatter 格式正确 * **推荐指数**：⭐⭐⭐⭐⭐（强烈推荐） \[!success\] json-canvas skill * **实测可用**：能生成 Canvas 文件 * **核心价值**：自动化创建思维导图和知识图谱 * **推荐指数**：⭐⭐⭐⭐（值得尝试）$

❌ 看起来美好，实际不能用的

$!danger\] obsidian-bases skill * **实测结果**：只显示加载成功，无任何实质输出 * **浪费时间**：花了一上午调试，完全无法使用 * **推荐指数**：⭐（不推荐，浪费时间）$

🤔 我的建议

如果你是 Obsidian 用户：

✅ 可以尝试 obsidian-markdown skill，确实能提升效率
✅ json-canvas skill 也值得一试
❌ obsidian-bases skill 暂时别碰，等官方修复

如果你时间有限：

不如直接用 Claude Code 的原生工具 + 手动调整格式
Dataview 插件可能比 obsidian-bases 更靠谱

总体评价：Obsidian Skills 不是神器，只是一个半成品工具。有用的部分确实有用，但别指望它能"彻底改变"你的笔记体验。

结语

技术工具的价值在于实用，而不是概念包装。

Obsidian Skills 有它的价值，但远没有全网吹的那么神。obsidian-markdown 确实好用，json-canvas 也不错，但 obsidian-bases 就是个坑。

写这篇文章的目的：

帮你节省时间，避免像我一样浪费一上午
提醒你保持独立思考，不要盲目跟风
分享真实体验，而不是复制粘贴官方文档

如果你有不同的使用体验，欢迎交流。也许是我的环境问题，也许是工具本身的 bug，但至少我的实测结果是这样的。

欢迎关注公粽号FishTech Notes，一块交流使用心得！

Obsidian Skills 实测报告：哪些能用，哪些是坑