AI的隐秘咒语：Obsidian如何被一位CEO亲手唤醒

想象一下，你推开一扇尘封已久的图书馆大门，里面不是泛黄的纸页，而是一座由无数相互链接的笔记组成的活体迷宫。这就是Obsidian——无数知识工作者心中的“第二大脑”。2026年1月6日，这座迷宫突然亮起了新的光芒：Obsidian的CEO Steph Ango（网名kepano）在GitHub上开源了一个名叫obsidian-skills的项目。短短几天，这个仓库就冲上了4.8k星，增速之快，甚至让一些大厂的AI模型发布都相形见绌。它究竟藏着什么魔力？让我们一起走进这场知识管理与人工智能的浪漫邂逅。

🌟 一场意外的爆火：4.8k星背后的社区心声

故事要从一个普通的周一说起。kepano在X上发了一条推文：“I'm starting a set of Claude Skills for Obsidian...”，配图是几行简洁的代码。谁也没想到，这条推文像投进湖面的石子，激起层层涟漪。几天之内，仓库星标突破4800，评论区挤满了来自世界各地的Obsidian用户。他们不是在追逐炫酷的Demo，而是在为一个真正“懂自己工具”的AI欢呼。

Obsidian是什么？ Obsidian是一款基于本地Markdown文件的笔记软件，它的最大特点是“双向链接”和“图谱视图”，让零散的笔记像神经元一样相互连接，形成一个可不断生长的知识网络。它没有云端订阅，完全离线，却拥有堪比Notion的扩展性，因此被无数研究者、作家、程序员奉为“第二大脑”。

为什么爆火？因为大多数AI在面对Obsidian时，就像一个只会说普通话的游客闯进了方言密布的古镇——它能看懂文字，却完全抓不住那些[[双向链接]]、> [!INFO] 呼出框、Canvas白板之间的微妙关系。kepano的obsidian-skills，相当于给AI递了一本“Obsidian方言速成手册”，让它终于能说一口地道的“Obsidian话”。

🔮 技能的本质：让Claude学会Obsidian的“母语”

obsidian-skills并不是一个插件，而是一组“技能文件”（skills），专供Anthropic的Claude Code使用。Claude Code本身是一个终端AI代理，擅长读写文件、执行代码任务。但当它面对Obsidian的vault（笔记库）时，常常会把[[内部链接]]写成普通超链接，或者胡乱发明一些Obsidian根本不认识的语法。

kepano的解决方式简单而优雅：把Obsidian的官方文档、语法规则、常见模式，全部写成结构化的指令文件，塞进Claude的上下文。当Claude检测到你在操作Obsidian文件时，这些技能就会自动激活，就像手机切换到Wi-Fi时自动连接熟悉的网络。

Claude Code是什么？ Claude Code是Anthropic推出的一款终端版AI代理（类似Cursor或Claude Desktop），可以直接读写本地文件、运行脚本、操作Git，甚至控制浏览器。它特别适合“Vibe Coding”——一种凭感觉、凭直觉驱动的编程方式，而非严密的工程流程。

🎭 第一项技能：obsidian-markdown——让AI写出“原汁原味”的笔记

第一项技能obsidian-markdown，堪称整套工具的基石。它教Claude正确处理Obsidian独有的Markdown扩展：

• 双向链接：[[笔记名]] 和 [[笔记名#章节^块引用]]
• 嵌入内容：![[图片.jpg]] 或 ![[另一篇笔记.md]]
• 呼出框（callouts）：> [!NOTE]、> [!WARNING]、> [!TIP] 等15种类型，还能自定义颜色和折叠
• Frontmatter YAML：用于存放tags、aliases、cssclass、created日期等元数据

想象一下，你让AI帮你整理一周的阅读笔记。过去，AI可能会给你一堆普通的Markdown标题和列表。现在，它会自然地插入[[来源文章]]链接，在关键段落加上> [!QUOTE] 呼出框，并在文件顶部生成整齐的YAML元数据。你打开Obsidian，一切完美契合，无需再手动调整。

🗃️ 第二项技能：obsidian-bases——数据库不再是AI的禁区

Obsidian的Bases（原Dataview升级版）是一个轻量级数据库功能，可以对笔记进行过滤、排序、公式计算、汇总统计。很多用户用它做项目管理、习惯追踪、文献库。

但Bases的公式语法极其严格，稍有差池就会报错。obsidian-bases技能内置了完整的函数参考手册（filter、map、reduce、date、link等），并教Claude如何写出合法的过滤器和汇总表达式。

举个例子：你告诉Claude“帮我建一个阅读清单数据库，只显示2026年读完的书，并按评分排序”。AI会直接生成一个.bases文件，包含正确的formula字段和summary设置。打开Obsidian，你立刻就能看到一张动态表格——完全不需要自己敲公式。

🖼️ 第三项技能：json-canvas——把想法直接画成思维导图

这可能是最受欢迎的一项技能。Obsidian的Canvas是一个无限白板，可以放置笔记卡片、图片、连线、群组。底层是JSON格式。

json-canvas技能让Claude彻底掌握了Canvas的JSON结构：节点（node）的坐标、大小、颜色、类型（text/file/image）；边（edge）的路径、标签、箭头；群组（group）的背景色和边框。

社区里最经典的例子莫过于：“/json-canvas draw a beautiful mindmap on how to get rich”。几秒钟后，一个结构清晰、颜色协调、节点自动排版的.canvas文件就躺在你的vault里了。打开Obsidian，思维导图已赫然在目。

有人甚至用它画系统架构图、故事板、人物关系图。配合社区的Excalidraw或Mermaid插件，视觉效果更是锦上添花。

📝 上手其实很简单：三步走进AI笔记时代

1. 在Claude的技能市场直接搜索“obsidian-skills”一键安装，或
2. 把kepano仓库里的文件手动复制到vault根目录的 /.claude 文件夹
3. 打开终端，对着你的vault路径，输入自然语言指令即可

不需要写复杂的prompt前缀，Claude会自动识别文件类型并加载对应技能。对新手来说，最友好的入门方式可能是先试几个社区流行的模板提示，比如“帮我总结最近10篇笔记的核心观点，并画成思维导图”。

🔥 社区的狂欢：从模仿到超越

项目发布后，社区迅速沸腾。@AxtonLiu开源了自己对Canvas、Excalidraw、Mermaid的可视化技能，并承诺推出视频教程对比官方实现与个人风格的差异。@shaomeng分享了如何用Claude Code + obsidian-skills做项目管理、代码审查、每日复盘。@sychou直言“这彻底改变了我的Obsidian使用方式”。甚至有人用它重建CRM、做投资分析、汇总GitHub PR趋势。

下面这张表格，汇总了三项核心技能的实际应用场景与潜在限制（基于社区反馈整理）：

🌅 写在最后的展望：AI与个人知识管理的未来

obsidian-skills不仅仅是一组技能文件，更是一种信号——当工具的创造者亲自为AI“翻译”自家产品的语言时，意味着AI正在从外来访客，变成生态里的原住民。kepano作为CEO直接下场开源，既体现了Obsidian一贯的社区优先哲学，也预示着未来可能有更多官方AI能力深度整合。

对我们普通用户来说，这或许是迄今最接近“AI第二大脑”的体验：它不喧哗、不烧钱，却能安静地帮你整理思路、连接知识、视觉化思考。当你下次打开Obsidian，看到AI刚刚为你画好的一张思维导图时，也许会会心一笑——原来，知识管理也可以这么浪漫。

参考文献

1. GitHub - kepano/obsidian-skills: Claude Skills for Obsidian

https://github.com/kepano/obsidian-skills

1. X Post by @kepano: I'm starting a set of Claude Skills for Obsidian

https://x.com/kepano/status/2008578873903206895

1. Reddit r/ObsidianMD: Kepano released obsidian-skills repo - what custom skills are you building?

https://www.reddit.com/r/ObsidianMD/comments/1q8gn9c/kepanoreleasedobsidianskillsrepowhat_custom/

1. X Post by @AxtonLiu: 开源了一套针对Canvas、Excalidraw、Mermaid的可视化skills

https://x.com/AxtonLiu/status/2010143669668720825

1. The Verge: Obsidian's CEO on why productivity tools need community more than AI

https://www.theverge.com/decoder-podcast-with-nilay-patel/760522/obsidian-ceo-steph-ango-kepano-productivity-software-notes-app