Obsidian 笔记管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f12a44b7/clawhub-obsidian。
技能介绍
要解决什么问题
Obsidian 把笔记放在本地 Vault 里,文件本质上是 Markdown。当你要在对话里「改某条笔记、查链接、批量整理目录」时,纯靠复制粘贴既慢,也容易和磁盘上的真实文件不同步。这个技能面向的是:在 Agent 对话中,直接对 Obsidian 库里的 .md 做可重复的操作,而不是再建一套平行笔记系统。
技能如何工作
触发词包括 Obsidian、笔记库、Markdown 笔记。技能定位是 Obsidian 笔记库管理:在已配置的前提下,通过 obsidian-cli 与本地库交互,把「打开、检索、编辑、组织笔记」这类动作交给命令行/automation 路径,而不是让模型凭空编造笔记内容。
典型能力边界(以 SKILL.md 描述为准)包括:
- 针对 Vault 内 Markdown 文件 的读写与整理
- 依赖 obsidian-cli 作为自动化入口,与 Obsidian 实际文件树保持一致
- 适合「库已在本地、路径与 CLI 可用」的日常维护场景
适用边界与注意点
- 技能 不能替代 Obsidian 客户端本身的插件生态;复杂 UI 操作、未暴露给 CLI 的能力,需要你在 Obsidian 里手动完成。
obsidian-cli的安装、Vault 路径、权限 必须在环境里事先就绪;否则自动化步骤会失败,Agent 也无法「猜对」你的库结构。- 涉及 删除、移动、批量重命名 时,建议先确认目标路径与备份策略;CLI 操作通常直接作用于磁盘文件。
- 若笔记含 Obsidian 专有语法(wikilink、嵌入、front matter),编辑时要保持格式一致,避免破坏链接与元数据。
使用场景
- 本地 Vault 已用 obsidian-cli 连上时,在对话里指定笔记路径,让 Agent 读取或改写该 Markdown 文件
- 整理知识库目录结构时,通过 CLI 批量移动、重命名 Vault 内的 `.md` 笔记并保持链接可追踪
- 写文献/Zettelkasten 时,需要把对话里整理好的段落追加到 Obsidian 里已有的一篇长期笔记
- 排查 wikilink 或 front matter 时,让 Agent 在真实库文件中检索关键词并给出需修改的具体段落
适合人员
- 用 Obsidian 维护项目/wiki 文档、希望对话里直接改磁盘上 `.md` 而不是再贴一遍的工程师
- 本地笔记库体积大、已配置 obsidian-cli,需要脚本化检索与批量整理 Markdown 的知识工作者
- 做研究笔记/Zettelkasten、经常要把对话结论写回指定 Obsidian 笔记的研究人员
- 负责团队知识库运维、需要在 Agent 协助下做 Vault 内文件级维护(移动、改名、内容更新)的文档管理员