企业官网建设流程全解析

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

你让 AI 帮你写笔记，结果它生成的[[链接]]格式不对，.base文件一打开就报 YAML 错误？obsidian-skills 就是一套给 AI 助手装的技能包，让 Claude Code、Codex、OpenCode 这类助手按 Obsidian 规范创建和编辑 Markdown 笔记、Bases 数据库视图和 JSON Canvas 画布。

一句话定位

它不是 Obsidian 插件，而是放进 AI 助手里的"说明书"：五个 SKILL.md 教会你的 AI 怎么正确操作 Obsidian 的开放文件格式。

三种助手，三种装法

安装只需要把文件放到对应目录，然后重启 AI 助手即可生效。

Claude Code：把仓库内容复制进你的 Obsidian 库根目录下的.claude/文件夹。

Codex：只复制skills/目录到 Codex 技能路径（通常是~/.codex/skills）。

OpenCode：克隆整个仓库到技能目录，注意必须是完整仓库而不是只拷skills/文件夹：

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

怎么验证装好了：重启助手后，对它说"用 Obsidian 语法帮我建一条带标注框的笔记"。如果生成结果里有> [!tip]这样的标注框，说明技能已加载。各技能详情见 skills/ 目录 和 README。

装好后，它能替你干什么

写规范的笔记

能做什么：AI 会正确使用维基链接、嵌入、标注框和 YAML 属性，而不是写成普通 Markdown。

最小例子——它生成的笔记会是这样：

[[项目笔记]] > [!tip] > 这是标注框

什么时候用：你提"建笔记""加链接""加标注框"时，走 obsidian-markdown 技能。

建数据库视图

能做什么：把一堆带属性的笔记变成表格、卡片或列表视图，支持过滤和公式计算。

最小例子——一个"未完成任务"表格：

filters: 'file.hasTag("task") && status != "done"' views: - type: table order: [file.name, status]

什么时候用：你想让 AI 生成.base文件做任务看板、阅读清单时。全部可用函数见 FUNCTIONS_REFERENCE。

画关系图

能做什么：生成可交互的.canvas文件——思维导图、流程图、项目看板。

最小例子——一个带连线的节点：

{ "nodes": [{"id": "a1", "type": "text", "text": "# 目标"}], "edges": [{"id": "e1", "fromNode": "a1", "toNode": "b2"}] }

什么时候用：你说"画个流程图""把这几条笔记做成关系图"。更多布局参考 EXAMPLES.md。

命令行操作库 + 调试插件

能做什么：通过obsidianCLI 让 AI 直接读写你的库，也能帮你做插件开发调试（重载插件、看报错、截屏验证 UI）。

最小例子：

obsidian create name="新笔记" content="# Hello" obsidian search query="重要" limit=10

什么时候用：批量改属性、追加日记、搜库，或你在写 Obsidian 插件需要"改代码→重载→查错"循环时。

清洗网页内容

能做什么：AI 拿到网页链接时，用 Defuddle 工具提取干净 Markdown，去掉导航栏和广告，少花 token。

最小例子：

defuddle parse <url> --md

什么时候用：你丢给它一篇技术文章说"整理进我的库"。未安装时它知道先跑npm install -g defuddle。

一条完整工作流：从网页到知识卡片

给你一个端到端场景，看五个技能怎么串起来：

1. 你把一篇长文 URL 丢给 AI，说"帮我整理进库里"。
2. AI 用 defuddle 技能提取正文，得到干净 Markdown。
3. 用 obsidian-markdown 技能建笔记：顶部加title/tags属性，正文里给核心概念加[[维基链接]]。
4. 用 obsidian-bases 技能更新一个.base文件，把这篇笔记按tags过滤进"待读清单"表格视图。
5. 用 json-canvas 技能把文中的 3 个关键概念画成.canvas关系图，挂在笔记末尾嵌入。

全程你只说了一句话，省掉的是手动复制正文、手写 YAML、对齐 canvas JSON 这几步重复劳动。

常见问题速查

现象：装了技能，AI 还是写错格式。原因：路径结构不对（尤其 OpenCode 只拷了skills/子目录）。解法：确认结构是<技能目录>/obsidian-skills/skills/<技能名>/SKILL.md，然后重启助手。

现象：.base文件打开报 YAML 错误。原因：公式里含双引号但外层没用单引号包裹。解法：写成'if(done, "Yes", "No")'。

现象：canvas 节点里的换行显示成\n两个字符。原因：JSON 字符串转义错误。解法：换行用\n表示，不要写两个反斜杠。

现象：公式列在表格里空白。原因：公式里用了不存在的属性，或引用了未定义的formula.X。解法：用if()做空值保护，确认formulas段有定义。

现象：obsidianCLI 命令没反应。原因：CLI 操作的是正在运行的 Obsidian 实例。解法：先打开 Obsidian 再执行命令。

适合谁，下一步做什么

适合：日常用 Obsidian 且同时用 Claude Code / Codex / OpenCode 的人，以及在做 Obsidian 插件开发的开发者。不适合：不用 AI 编程助手、只想在 Obsidian 里装插件的人——它本身不往 Obsidian 里装任何东西。

下一步建议做两件事：

1. 装好后先让 AI 生成一个"任务追踪".base视图，最直观看到效果。
2. 找一篇长文跑一遍上面的 defuddle 工作流，体会"一句话进库"的流程。

【免费下载链接】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