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的可视化技能,并承诺推出视频教程对比官方实现与个人风格的差异。@shao__meng分享了如何用Claude Code + obsidian-skills做项目管理、代码审查、每日复盘。@sychou直言“这彻底改变了我的Obsidian使用方式”。甚至有人用它重建CRM、做投资分析、汇总GitHub PR趋势。
下面这张表格,汇总了三项核心技能的实际应用场景与潜在限制(基于社区反馈整理):
| 技能 | 关键能力 | 常见使用场景 | 潜在限制 |
|---|
| obsidian-markdown | 双向链接、嵌入、呼出框、Frontmatter YAML | 批量重构笔记、生成带标签的新笔记 | 复杂YAML仍需精确prompt |
| obsidian-bases | 过滤器、公式、汇总、函数完整参考 | 项目看板、阅读清单、习惯追踪 | 公式仍建议手动验证 |
| json-canvas | 节点、边、群组、颜色、布局 | 思维导图、系统架构图、故事板 | 视觉美观度高度依赖prompt细节 |
🌅
写在最后的展望: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
2. X Post by @kepano: I'm starting a set of Claude Skills for Obsidian
https://x.com/kepano/status/2008578873903206895
3. Reddit r/ObsidianMD: Kepano released obsidian-skills repo - what custom skills are you building?
https://www.reddit.com/r/ObsidianMD/comments/1q8gn9c/kepano_released_obsidianskills_repo_what_custom/
4. X Post by @AxtonLiu: 开源了一套针对Canvas、Excalidraw、Mermaid的可视化skills
https://x.com/AxtonLiu/status/2010143669668720825
5. 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