obsidian-official-cli-skills
指导AI代理安全使用Obsidian CLI，避免静默错误
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：obsidian-official-cli-skills。 它的用途是：指导AI代理安全使用Obsidian CLI，避免静默错误 完整的 Skill 内容见：https://321skill.com/skills/obsidian-official-cli-skills/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
当你对AI代理说：“帮我找出Obsidian库中所有待办任务并总结”，技能会指导它使用正确的命令`obsidian tasks all todo`，而非默认的错误命令，从而确保返回完整准确的任务列表。当你想让AI创建一篇新笔记时，技能会确保它使用`obsidian create name="新笔记" content="内容" silent`，避免打开图形界面中断流程。
介绍
这是一个专为AI编码代理设计的指导技能，旨在解决Obsidian CLI（1.12+版本）使用中的高风险静默失败问题。许多CLI命令看似执行成功（返回退出码0），但实际上返回了错误或空数据，导致AI代理在不知情的情况下给出错误答案。
该技能通过提供34个命令的正确语法、陷阱警告、安全规则和错误处理指南来指导AI代理。例如，它会指导代理在查询任务时使用tasks all todo而非默认的tasks todo，在搜索时指定format=json以获得结构化数据，以及在创建文件时添加silent标志以避免打开Obsidian UI。
它主要服务于使用AI编码助手（如Claude Code、Cursor、Codex等）进行知识库管理、笔记整理和内容创作的开发者和知识工作者。这些用户依赖AI代理与Obsidian进行自动化交互，对数据准确性要求高。
与市面上其他仅提供基础Obsidian CLI命令说明的技能或文档不同，本技能的核心价值在于其基于详尽的测试（57个场景测试，发现22.8%的静默失败率），直接针对AI代理的认知盲区进行预防性指导，提供了经过验证的安全使用模式，而非简单的API罗列。
核心特点
本技能基于对Obsidian CLI 1.12+的57个场景测试，精准识别并规避了高达22.8%的静默失败陷阱（命令成功但数据错误），提供了经过实战验证的安全命令模式。它并非简单的命令手册，而是针对AI代理认知盲区设计的防错指南。
注意事项
本技能仅适用于Obsidian 1.12及以上版本，且需要用户已启用并配置好Obsidian CLI。
常见问题
为什么我的AI代理用Obsidian CLI查不到任务？
默认`tasks todo`命令作用域是当前活动文件（通常为空），需要使用技能指导的`tasks all todo`来查询所有文件中的任务。
如何让AI代理创建的Obsidian文件不弹出界面？
在`create`命令后必须添加`silent`标志，否则会打开Obsidian UI并中断自动化流程。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/obsidian-official-cli-skills/raw/index.md 读取 obsidian-official-cli-skills 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/obsidian-official-cli-skills/raw/index.md（查看排版版本）