obsidian-skills：技能是说明书，权限来自宿主 Agent
obsidian-skills 是一组遵循 Agent Skills 规范的 Markdown 技能。它教 Agent 写 Obsidian Markdown、Bases、JSON Canvas，调用 Obsidian CLI、Defuddle 和 Knap。仓库不是后台服务，也不会凭空获得权限；真正的读写和联网能力由宿主 Agent 与本机工具决定。
当前状态
截至 2026-09-23，官方 Releases 页面没有正式版本。若团队需要可复现安装，应固定审核过的提交，而不是每次从 `main` 拉最新内容。
六个技能分别做什么
- obsidian-markdown：属性、wikilink、嵌入和 callout。
- obsidian-bases：`.base` 视图、过滤、公式和摘要。
- json-canvas：`.canvas` 节点、边、分组和连接。
- obsidian-cli：笔记读写、搜索、任务、属性，以及插件调试。
- defuddle：访问 URL 并抽取清理后的 Markdown。
- knap：用 JSON/CSV 和模板批量生成 Markdown。
安装与安全起步
npx skills add https://github.com/kepano/obsidian-skills
# Codex 也可审阅后复制 skills/ 到 ~/.codex/skills先查看安装器写了哪些目录，只启用需要的技能。在副本 vault 中测试。调用 Obsidian CLI 时显式给出 `vault="Test Vault"` 和 `path="folder/note.md"`，因为官方技能说明写明，省略 vault 时会使用最近聚焦的 vault。
真正需要防的三类越界
- CLI 可以读、建、改笔记；插件开发命令还能执行 JavaScript、截图和读取 DOM。
- Defuddle 会请求目标 URL。内网地址、带登录状态的页面和含 token 的 URL 不应直接交给它。
- 技能文本会影响 Agent 的工具选择。升级前应查看 SKILL.md 差异，不要把未审阅的 main 当固定依赖。
与 Obsidian Mind 对比
Obsidian Mind 是一套带目录结构、hooks、命令、索引和持久记忆流程的完整 vault。obsidian-skills 只描述格式和工具操作，不要求采用人物、项目、决策等固定结构。保留现有 vault 体系时更适合技能集；准备整体采用工作记忆方法时再评估 Obsidian Mind。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
近期变化与关注原因
它把 Obsidian 的开放格式与 CLI 规则包装成通用 Agent Skills，可通过插件市场、`npx skills add` 或手工复制使用，覆盖的 Agent 比单一厂商插件更广。
适合谁用
适合让编码 Agent 生成符合 Obsidian 语法的笔记、Bases 和 Canvas，或在明确 vault 中做搜索、属性更新、插件调试与批量模板生成。它不能替代权限控制、备份或人工检查。
原教程未展开的系统信息
核心功能
Bases 与 JSON Canvas
分别描述 `.base` 的视图、过滤、公式、摘要，以及 `.canvas` 的节点、边、分组和连接结构。
Obsidian CLI 工作流
要求 Obsidian 正在运行，可从 CLI 读取、创建、搜索和修改笔记，也覆盖插件重载、错误、截图和 DOM 检查。
架构与数据流
仓库以 `skills/<name>/SKILL.md` 为单元，遵循 Agent Skills 规范。Agent 在触发任务时读取对应说明，再调用本地文件工具、正在运行的 Obsidian CLI，或 Defuddle/Knap 等外部 CLI。技能文件不提供独立权限隔离：能读写哪些 vault 文件、能否联网和能否运行开发命令，取决于宿主 Agent 的工作目录、工具授权与 Obsidian 当前焦点。
常见问题
obsidian-skills 有正式版本号吗？
截至 2026-09-23，官方 Releases 页面没有发布版本。需要可复现安装时应记录具体 Git 提交，而不是只写 `main`。
安装 obsidian-skills 后 Agent 能读整个 vault 吗？
技能文件不会自行授权，但宿主 Agent 和 Obsidian CLI 能访问的范围决定实际权限。CLI 默认使用最近聚焦的 vault，操作时应显式写 vault 与 path。
obsidian-skills 的 Defuddle 会把内容发到外部服务吗？
技能指示本地 Defuddle CLI 访问指定 URL 并提取页面。请求会到目标网站；内网页面、带凭据 URL 和敏感内容需要先做网络与日志审查。
obsidian-skills 和 Obsidian Mind 是同一个东西吗？
不是。obsidian-skills 是格式与工具说明集合；Obsidian Mind 是带目录结构、hooks、命令、索引和记忆流程的完整 vault 模板。
官方来源：仓库、CLI skill、Defuddle skill。