Obsidian 与 Obsidian Skills 小白入门

文章目录

[Obsidian 与 Obsidian Skills 小白入门](#Obsidian 与 Obsidian Skills 小白入门)
- 一、基础概念说明
- - [1. Obsidian 是什么](#1. Obsidian 是什么)
  - [2. Obsidian Skills 是什么](#2. Obsidian Skills 是什么)
- 二、使用前需要先明确的两点
- - [1. Skills 不是给用户直接点击使用的功能](#1. Skills 不是给用户直接点击使用的功能)
  - [2. 生成文件后，真正使用结果的人是用户](#2. 生成文件后，真正使用结果的人是用户)
- 三、手动安装教程应如何理解
- [四、用户与 agent 的分工方式](#四、用户与 agent 的分工方式)
- - [1. 用户如何使用](#1. 用户如何使用)
  - [2. agent 如何使用](#2. agent 如何使用)
- 五、五个技能的实际使用方式
- - [1. `obsidian-markdown`：生成和维护规范笔记](#1. obsidian-markdown：生成和维护规范笔记)
  - [2. `defuddle`：将网页整理为可保存的笔记内容](#2. defuddle：将网页整理为可保存的笔记内容)
  - [3. `obsidian-bases`：将多篇笔记组织为可浏览视图](#3. obsidian-bases：将多篇笔记组织为可浏览视图)
  - [4. `json-canvas`：将内容组织为可编辑画布](#4. json-canvas：将内容组织为可编辑画布)
  - [5. `obsidian-cli`：让 agent 与运行中的 Obsidian 直接交互](#5. obsidian-cli：让 agent 与运行中的 Obsidian 直接交互)
- [六、何时需要明确提到 Obsidian](#六、何时需要明确提到 Obsidian)
- - [1. 通常无需特别强调的情况](#1. 通常无需特别强调的情况)
  - [2. 建议明确说明的情况](#2. 建议明确说明的情况)
- 七、五类常用场景的推荐表达
- - [1. `obsidian-markdown`：撰写笔记](#1. obsidian-markdown：撰写笔记)
  - [2. `defuddle`：整理网页](#2. defuddle：整理网页)
  - [3. `obsidian-bases`：查看任务总表](#3. obsidian-bases：查看任务总表)
  - [4. `json-canvas`：查看流程图](#4. json-canvas：查看流程图)
  - [5. `obsidian-cli`：直接操作 Vault](#5. obsidian-cli：直接操作 Vault)
- 八、结论

Obsidian 与 Obsidian Skills 小白入门

Obsidian 官网：https://obsidian.md/zh/
Obsidian 中文帮助：https://obsidian.md/zh/help/
GitHub 仓库：https://github.com/kepano/obsidian-skills
Quick Start（zread）：https://zread.ai/kepano/obsidian-skills/2-quick-start

一、基础概念说明

1. Obsidian 是什么

Obsidian 是一款本地优先的笔记工具，你写下来的内容本质上是本地 Markdown 文件。它最核心的价值不是排版，而是把笔记长期保存下来，并通过 [[双链]] 把笔记连成知识网络。

背景上，Obsidian 由 Dynalist Inc. 开发，创始人是 Shida Li 和 Erica Xu。如果你之前听说过 Dynalist，这两款产品出自同一团队。

这里的 [[双链]]，小白可以先这样理解：

普通链接：只是从 A 跳到 B
Obsidian 双链：不仅能从 A 链到 B，B 也更容易知道"谁链接了我"

例如你在"周会记录"里写 [[项目A]]，意思就是把这篇笔记和"项目A"那篇笔记连起来。以后你看"项目A"时，也更容易反过来找到哪些笔记提到过它。

所以双链的本质不是"花哨写法"，而是帮你把零散笔记慢慢织成网。

2. Obsidian Skills 是什么

obsidian-skills 不是 Obsidian 里的普通插件，也不是给你点按钮用的界面功能。它是一组给 agent 用的技能说明，让 agent 更懂 Obsidian 的文件格式和工作流。

这组技能的 GitHub 仓库是 kepano/obsidian-skills。kepano 是 Steph Ango 在 GitHub 上的账号名，他也是 Obsidian 的 CEO。这里可以合理理解为：这是一套由 Obsidian 核心团队背景下产出的技能资源，用来帮助 agent 更准确地处理 Obsidian 内容。

一句话理解：

Obsidian 负责存你的知识，Obsidian Skills 负责让 agent 更会处理这些知识。

二、使用前需要先明确的两点

1. Skills 不是给用户直接点击使用的功能

你作为用户，通常不是直接去打开某个 SKILL.md 文件使用。

正确方式是：

你用自然语言提需求
agent 判断该调用哪个 skill
agent 生成对应文件或内容
你回到 Obsidian 里查看、阅读、继续编辑

所以，skills 更像"agent 的专业说明书"，不是"用户的操作面板"。

2. 生成文件后，真正使用结果的人是用户

agent 的工作是"生成合适的 Obsidian 文件"。

你真正的使用动作是"在 Obsidian 里打开这些文件、阅读它们、继续维护它们"。

不同文件的使用方式不一样，后面会分别说清楚。

三、手动安装教程应如何理解

手动安装说明：

手动安装：将 https://github.com/kepano/obsidian-skills 直接提供给 agent，由 agent 自动完成安装，并在安装完成后说明安装目录，以及提供一份适合新手理解的使用教程。

重点：让 agent 代替你完成安装，并顺便把"装到哪里了"和"装完怎么用"讲清楚。

你给的手动安装教程核心意思是：对于 Codex CLI，需要把 obsidian-skills 仓库里的 skills/ 内容放进 Codex 的技能目录。

教程里的目标目录是：

~/.codex/skills

在你的电脑上，对应到实际路径就是：

C:\Users\xiaod\.codex\skills

你这次已经装好的 5 个技能目录是：

C:\Users\xiaod\.codex\skills\obsidian-markdown
C:\Users\xiaod\.codex\skills\obsidian-bases
C:\Users\xiaod\.codex\skills\json-canvas
C:\Users\xiaod\.codex\skills\obsidian-cli
C:\Users\xiaod\.codex\skills\defuddle

如果你只想判断"装没装成功"，最简单的方法不是看源码，而是直接问 agent：

text 复制代码

你现在有哪些 Obsidian skills？

如果它能正确列出上面这 5 个，通常就说明 Codex 已经识别到了这些技能。

四、用户与 agent 的分工方式

1. 用户如何使用

你只需要做两件事：

告诉 agent 你要什么
回到 Obsidian 里使用生成结果

2. agent 如何使用

agent 会根据你的需求，自动挑合适的 skill 来处理。

通常不需要你每次都明确说出 skill 名称，但下面几种情况，显式提到会更稳：

你明确要 Obsidian 笔记
你明确要 .base 文件
你明确要 .canvas 文件
你希望"把网页整理成适合 Obsidian 的笔记"

也就是说：

如果你的需求已经非常像 Obsidian 场景，agent 往往会默认识别
如果你想减少歧义，直接说出 Obsidian、.base、.canvas、Vault 这些词会更可靠

五、五个技能的实际使用方式

下面这一部分最重要。每个 skill 我都分成三层来说：

你怎么提需求
agent 会做什么
文件生成后你怎么用

1. `obsidian-markdown`：生成和维护规范笔记

（1）用户如何提需求

text 复制代码

请帮我创建一篇 Obsidian 笔记，标题叫《周会记录》，加上日期、标签、待办事项和一个 warning callout。

（2）agent 会做什么

agent 会生成一篇符合 Obsidian 习惯的 .md 文件，通常会包含：

标题
属性区
标签
[[双链]]
callout
适合阅读视图的结构

（3）文件生成后如何使用

.md 文件本质上就是给你读、改、链接、沉淀知识用的。

你在 Obsidian 里打开它之后，通常会这样用：

直接阅读
继续补内容
给它加 [[双链]]
把它放进文件夹
通过标签和属性参与后续检索

所以答案是：对，md 文件本来就是主要给用户读和持续维护的。

2. `defuddle`：将网页整理为可保存的笔记内容

（1）用户如何提需求

text 复制代码

请提取这篇网页内容，生成一篇适合放进 Obsidian 的中文笔记，并附上摘要和要点：
https://example.com/article

（2）agent 会做什么

agent 会先把网页正文提纯，去掉导航、广告和杂乱结构，再整理成适合存进 Obsidian 的 Markdown 内容。

（3）文件生成后如何使用

最后你拿到的通常仍然是一篇 .md 笔记。

你在 Obsidian 里会这样用：

阅读网页摘要
保存长期资料
在文末补上自己的理解
链接到已有项目笔记或主题笔记

所以 defuddle 不是给你一个"新文件类型"，而是帮你把网页变成更适合阅读和沉淀的笔记内容。

3. `obsidian-bases`：将多篇笔记组织为可浏览视图

（1）用户如何提需求

text 复制代码

请帮我创建一个 .base 文件，把所有带 task 标签的笔记做成表格，按 status 分组，并显示截止日期。

（2）agent 会做什么

agent 会生成一个 .base 文件，里面定义筛选条件、显示字段和视图结构。

（3）文件生成后如何使用

.base 文件不是给你"读文章"的，它更像一个"视图配置文件"。

你在 Obsidian 里打开它之后，看到的不是普通正文，而是一个表格、卡片或列表视图。它的用途是：

统一查看一批笔记
按状态、日期、标签筛选
把零散笔记组织成任务面板或资料面板

所以它的正确使用方式不是"阅读 .base 源码"，而是：

在 Obsidian 里打开 .base
看它呈现出来的视图
回去修改原始笔记的属性
让这个视图自动更新

一句话理解：.base 主要是"用来看一批笔记"，不是"用来读它自己"。

4. `json-canvas`：将内容组织为可编辑画布

（1）用户如何提需求

text 复制代码

请创建一个 Obsidian Canvas，主题是"专利交底书写作流程"，包含 5 个步骤节点，并用箭头连接。

（2）agent 会做什么

agent 会生成一个 .canvas 文件，里面包含节点、位置、颜色和连接关系。

（3）文件生成后如何使用

.canvas 文件也不是给你读源码的，它是给 Obsidian 的 Canvas 视图打开的。

你在 Obsidian 里打开之后，通常会这样用：

看流程图
拖动节点
补充说明
增加更多节点和连接
链接到其他笔记或文件

一句话理解：.canvas 是"给你看图和继续编辑图"的，不是"给你逐行读 JSON"的。

5. `obsidian-cli`：让 agent 与运行中的 Obsidian 直接交互

（1）用户如何提需求

text 复制代码

请在 Obsidian 里搜索所有带 research 标签、这个月创建的笔记。

或者：

text 复制代码

请在我的 Obsidian Vault 里新建一篇日报。

（2）agent 会做什么

agent 会尝试调用 obsidian CLI，直接和正在运行的 Obsidian 实例交互。

（3）结果如何使用

这个 skill 和前面几个不一样，它不一定产出一个新文件给你看。它更像"操作能力"。

你会这样使用它：

让 agent 搜索你的 Vault
让 agent 创建笔记
让 agent 追加内容
让 agent 查任务、标签、反向链接

注意一点：

这类能力通常需要 Obsidian 桌面版正在运行

六、何时需要明确提到 Obsidian

不是每次都必须提。

1. 通常无需特别强调的情况

如果你已经在一个明确的 Obsidian 上下文里，例如：

你一直在讨论 Vault
你正在让 agent 改 .md、.base、.canvas
你给的是 Obsidian 帮助站或 Vault 路径

这时 agent 往往会默认按 Obsidian 场景理解。

2. 建议明确说明的情况

下面这些情况，建议你明确说出 Obsidian：

你说"帮我写篇笔记"，但没说是普通 Markdown 还是 Obsidian 笔记
你说"帮我做个表格"，但没说是 Excel、Markdown 表格，还是 .base
你说"帮我做个流程图"，但没说是图片、Mermaid，还是 Canvas

所以更稳的说法不是：

text 复制代码

帮我做个表格

而是：

text 复制代码

请帮我创建一个 Obsidian .base 文件，作为任务总表使用。

七、五类常用场景的推荐表达

下面这些说法更适合小白，因为它们同时说明了"要什么结果"和"放到哪里用"。

1. `obsidian-markdown`：撰写笔记

text 复制代码

请帮我创建一篇适合放进 Obsidian 的项目笔记，包含标题、日期、标签、待办事项和一个 warning callout。

用完后：

到 Obsidian 里打开这篇 .md
继续补内容
和其他笔记建立双链

2. `defuddle`：整理网页

text 复制代码

请提取这篇网页内容，整理成一篇适合保存到 Obsidian 的中文笔记，并附上摘要和要点。

用完后：

到 Obsidian 里阅读整理后的笔记
补上自己的结论
链接到相关主题笔记

3. `obsidian-bases`：查看任务总表

text 复制代码

请帮我创建一个 Obsidian .base 文件，把所有带 task 标签的笔记做成表格，按 status 分组，并显示截止日期。

用完后：

在 Obsidian 里打开 .base
用它查看所有任务笔记
修改原始笔记的属性来驱动视图变化

4. `json-canvas`：查看流程图

text 复制代码

请帮我创建一个 Obsidian Canvas，把"专利交底书写作流程"做成 5 个步骤的流程图。

用完后：

在 Obsidian 里打开 .canvas
拖动节点
继续补步骤和说明

5. `obsidian-cli`：直接操作 Vault

text 复制代码

请在我的 Obsidian Vault 里搜索所有带 project 标签的笔记，并按修改时间排序。

用完后：

查看 agent 返回的结果
让它继续创建、追加、搜索或整理内容

八、结论

md 笔记是给你读和长期维护的。
.base 和 .canvas 不是给你读源码的，而是给 Obsidian 打开成视图和画布的。
你负责提需求，agent 负责生成正确格式，你再回到 Obsidian 里真正使用结果。

Obsidian 与 Obsidian Skills 小白入门

文章目录