Obsidian

• 您希望 AI 代理通过名称或内容搜索您的笔记，并呈现相关片段。
• 您需要通过 Obsidian 的 URI 处理器，在特定文件夹中创建新笔记，并可选择预填内容。
• 您需要安全地重命名或移动笔记 —— obsidian-cli move 会更新整个库中所有的 [[wikilinks]]，而普通的 mv 命令会破坏这些链接。
• 您希望自动化库的维护工作（删除过时笔记、批量创建条目），而无需手动操作 Obsidian。

• 您未使用 Obsidian 桌面应用程序 — obsidian-cli 依赖于已安装的 Obsidian 及其库注册表文件（obsidian.json）的存在。
• 您需要处理 画布文件（.canvas）或 插件配置（.obsidian/）— 这些格式不在本技能的涵盖范围内。
• 您使用的是 Linux 或 Windows — obsidian-cli 通过 Homebrew 安装，且所引用的库注册表路径为 macOS 专用路径（~/Library/Application Support/obsidian/）。

使用 obsidian-cli search 按文件名查找笔记，或使用 obsidian-cli search-content 在笔记内容中搜索，并返回匹配的片段和行号。

obsidian-cli move 可重命名或移动笔记，同时自动更新整个库中所有引用该笔记的 [[wikilinks]] 和常规 Markdown 链接——相比直接在文件系统中重命名，这是一项关键优势。

使用 obsidian-cli create 在任意库路径下创建笔记，并可选择预填内容。该命令通过 Obsidian 的 URI 处理程序进行路由，以确保新文件被正确注册。

该技能读取 Obsidian 自身的 obsidian.json 文件来定位活跃的库，而非硬编码路径，能够正确处理多库设置（iCloud、工作/个人等场景）。

对于简单的读取或编辑操作，该技能可以直接打开 .md 文件 —— Obsidian 会自动检测文件系统的变更，因此直接编辑是替代 CLI 命令的一种快速且有效的方式。

让你的智能体查找与某个项目或主题相关的所有笔记。它使用 search-content 返回相关片段和行引用，让你能够快速定位散落在数百条笔记中的信息。

将会议记录、网络调研内容或任务列表输入代理，让其使用 obsidian-cli create 在正确的 Obsidian 库文件夹中创建结构化 Markdown 笔记，包含完整的 frontmatter 和正文内容。

无需手动排查断开的链接即可重命名或重构笔记层级结构——obsidian-cli move 会在整个库中保持所有内部引用完好无损。

让代理搜索过时或重复的笔记，并使用 obsidian-cli delete 将其删除，无需手动浏览文件夹即可保持 Obsidian 库的整洁。