企业官网建设流程全解析

obsidian-skills 完全指南：3 分钟让 AI 替你写 Obsidian 笔记、搭数据库视图和画思维导图

【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills

obsidian-skills 是一套 Obsidian 智能体技能包：把它装进 Claude Code、Codex 或 OpenCode，你就可以用自然语言让 AI 创建符合 Obsidian 语法的笔记、生成 Bases 数据库视图、绘制 JSON Canvas 思维导图，并通过 Obsidian CLI 直接操作你的库。适合已经在用 Obsidian 管理知识、又想让 AI 上手干活的笔记用户。

它是什么、怎么工作

obsidian-skills 不是 Obsidian 插件，也不依赖任何 Obsidian 扩展。它的本质是若干份遵循 Agent Skills 规范的说明文档，每个技能目录下有一份SKILL.md，把某项 Obsidian 能力的语法规范和正确用法"教"给 AI。AI 接到任务时先读对应的技能文档，再按规范产出文件或执行命令——你得到的是语法正确、能直接在 Obsidian 里打开的文件，而不是需要手工修补的半成品。

五个技能各管一件事：

• obsidian-markdown：写 Obsidian 风味 Markdown，涵盖[[维基链接]]、![[嵌入]]、> [!type]标注框和 frontmatter 属性，参考文档见 skills/obsidian-markdown/SKILL.md
• obsidian-bases：写.base数据库文件，支持过滤器、公式、表格/卡片/列表/地图四种视图
• json-canvas：写.canvas画布文件，支持文本、文件、链接、分组四类节点和连线
• obsidian-cli：通过obsidian命令行与正在运行的 Obsidian 实例交互，读写笔记、搜索、管理属性和任务，也支持插件开发调试
• defuddle：用defuddle parse <url> --md把网页正文提取成干净的 Markdown，去掉导航和广告

📝 按你的日常任务，看它能帮你做什么

写笔记和改笔记的时候

你说"帮我写一篇项目笔记，关联另外两篇笔记，加一个警告框"，AI 会按 Obsidian 规范产出文件：内部关联用[[维基链接]]（重命名笔记时链接自动跟随），外部网址才用文本；关键信息用标注框突出；文件顶部带 frontmatter 属性。结果是一篇在阅读视图下渲染正确、和现有笔记天然连通的.md文件。

想把一堆笔记变成可筛选的表格时

笔记攒多了，手动维护清单很痛苦。obsidian-bases 技能让 AI 生成.base文件：用过滤器按标签、文件夹、属性圈定范围，用公式从现有属性算出"还剩几天到期""预计阅读时长"这类动态字段，再挑表格或卡片视图展示。结果是一个自动反映最新状态的视图，新增笔记打了对应标签就会自动出现，不需要手动维护。完整函数列表见 skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md。

想画概念图、流程图的时候

让 AI 生成.canvas文件，它按 JSON Canvas 规范 1.0 生成节点和连线，自动生成不冲突的节点 ID，按 50-100px 间距排布避免重叠。结果是一个直接能打开的画布文件，画完还能让 AI 往里追加节点或改连线。完整范例见 skills/json-canvas/references/EXAMPLES.md。

想让 AI 直接操作正在运行的 Obsidian 时

obsidian-cli 技能让 AI 学会用obsidian命令：读取和创建笔记、全文搜索、设置 frontmatter 属性、追加到日记、列出今日待办、查反链。结果是你说一句"把这篇笔记的状态改成 done"，属性就改好了，不用切到应用里手动点。

想把网页存进库的时候

用 defuddle 技能，AI 会执行defuddle parse <url> --md拿到干净的正文 Markdown，再按你的要求整理成笔记。结果是没有导航栏和广告污染、token 消耗更少的研究素材。

🚀 三步从安装到第一次跑通

第一步：按你用的平台安装技能。

以 OpenCode 为例：

git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills

OpenCode 会自动发现所有SKILL.md，无需改任何配置文件，重启 OpenCode 后技能即可用。

第二步：打开 Obsidian 应用。所有 CLI 命令都是和"正在运行的实例"对话，应用没开，命令就没有反应。

第三步：跑最小命令验证。让 AI（或自己）执行：

obsidian create name="My First Note" content="# Hello" obsidian daily:append content="- [ ] 第一个任务" obsidian search query="hello" limit=10

三条命令分别验证创建、日记追加和搜索。命令完整列表随时用obsidian help查看，它会跟随版本更新；更多用法细节在 skills/obsidian-cli/SKILL.md。

真实案例：把一堆读书笔记变成可查询的数据库

任务：你有一个"读书笔记"文件夹，每篇笔记的 frontmatter 里记了author、pages、status（to-read / reading / done），想知道"现在在读什么、每本预计多久读完"。

做法：

1. 让 AI 生成一个.base文件：过滤器锁定#book和#article标签的笔记；公式里用if(pages, (pages * 2).toString() + " min", "")算出预计阅读时长，再用if()给不同状态配上图标。
2. 配置两个视图：卡片视图当"书架"（封面、书名、作者、状态图标），表格视图只看status == "to-read"的待读书单，按预计时长排序。
3. 在 Obsidian 里打开.base文件确认渲染无误，再用![[MyBase.base]]把它嵌进你的仪表盘笔记。

结果：一个按标签自动收录新笔记、自动计算阅读时长的视图。之后每读完一本书，你只需把该笔记的status属性改成done（可以让 AI 用obsidian property:set代劳），视图就自动更新，不需要手动搬行。

踩坑与技巧：这 4 个问题最容易遇到

1. CLI 命令没有反应：先确认 Obsidian 应用已打开。CLI 操作的是运行中的实例，不是磁盘文件。
2. .base文件在 Obsidian 里报 YAML 错误：多半是引号问题。含冒号、{}、[]等特殊字符的字符串必须加引号；公式里含双引号时，整个公式用单引号包裹。
3. 日期公式算出错误结果：两个日期相减得到的是 Duration（时长）而不是数字，不能直接.round()，要先取字段：(now() - file.ctime).days才是天数。另外属性可能不存在于所有笔记，用if(due, ...)做判空保护。
4. 画布文本里出现字面的\n字符：JSON 字符串里换行必须写\n，写成\\n会被 Obsidian 当成两个可见字符渲染。

另外提醒一句：库内笔记之间永远用[[维基链接]]，只有外部 URL 才用标准 Markdown 链接——这是保证重命名后链接不失效的关键。

装好之后，先试一句最实用的指令："帮我给带#book标签的笔记生成一个卡片视图的.base文件"，跑通它，你就拿到了自己的第一个 Obsidian 自动化。

【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills