Obsidian CLI 助手
通过命令行读写和管理 Obsidian 仓库，并辅助插件与主题开发调试。
文档明确要求 Obsidian 保持运行，并展示了读写笔记、覆盖文件、执行 JavaScript、调试及开发者命令；能力范围和部分静默选项可见，但没有用户确认策略、最小权限边界、数据流说明、敏感数据处理、回滚方案或外部影响提示，因此从满分大幅扣分。未发现恶意软件、凭据窃取或隐蔽外传等红线证据；发布者身份未验证，仅按未知处理。
命令语法、文件与 vault 定位方式、常见命令及插件调试流程描述较清楚，且提示使用 obsidian help 获取最新命令；但依赖运行中的 Obsidian、CLI 版本和环境状态，未提供测试套件、关键路径复现证据、异常输入处理或可诊断失败信息，因此仅给出静态审查下的中低分。
目标受众和主要场景明确，覆盖 vault 操作以及插件、主题开发；但未明确不适用范围、触发排除条件、版本兼容性、输入输出约定或中文使用支持。核心依赖 Obsidian CLI 和本地运行实例，未证明在中国大陆网络环境中的文档可达性，因此扣分。
SKILL.md 结构清晰，包含安装前提、语法、定位规则、常见模式和开发流程；README 提供多种安装方式，仓库另有 MIT 许可证。但选定技能缺少版本、变更记录、维护责任、更新路径、FAQ、已知限制和更完整的依赖说明，因此未达到高分。
文档直接提供了读取、创建、追加、搜索、属性、任务、反向链接以及插件调试命令，理论上可覆盖核心任务并产生可直接使用的 CLI 操作；但本次仅静态阅读，未验证命令在目标环境中的实际可用性、输出完整性或相对手工操作的收益，按静态上限给分。
命令行为指向 Obsidian 官方 CLI 帮助和文档，且示例可审计；但没有提交的测试、CI 覆盖、版本锁定或第三方执行证据，无法独立复现关键结论，因此低于静态审查可给的高分。
- 在执行 create、append、property:set 或 overwrite 前，应明确向用户确认目标 vault、文件路径、写入内容及覆盖风险，并提供备份或恢复方案。
- obsidian eval 可在应用上下文中执行任意 JavaScript；不要对不可信输入直接传递代码，也不要默认授予超出任务所需的 vault 或插件开发权限。
- 运行前应确认 Obsidian、CLI 命令版本和目标 vault 状态；命令失败时当前文档没有足够的诊断与恢复指引。
这个 Skill 能做什么，适合哪些场景？
这是 kepano/obsidian-skills 仓库中的独立 Obsidian CLI 技能。它让兼容的代理通过 Obsidian CLI 读取、创建、搜索和管理笔记、任务及属性，也能执行部分仓库操作。技能还覆盖插件和主题开发中的重载、错误检查、JavaScript 执行、截图和 DOM 检查。使用前需要 Obsidian 正在运行；命令默认作用于最近聚焦的仓库。
运行 obsidian CLI 命令，读取和创建笔记，追加内容，搜索仓库，读取或追加每日笔记，设置属性，管理任务、标签和反向链接；可使用 file、path 或 vault 指定目标；在插件和主题开发中重载插件、查看错误和控制台输出、运行 JavaScript、截图、检查 DOM 和 CSS，并切换移动端模拟。
- Obsidian 用户想从命令行读取或创建笔记时，使用它执行对应的 vault 操作。
- 需要在仓库中查找特定内容、标签、任务或反向链接时，使用它进行搜索和查询。
- 希望自动追加每日任务或更新笔记属性时，使用它调用 daily 和 property 命令。
- Obsidian 插件开发者修改代码后，使用它重载插件、检查错误并进行视觉或 DOM 验证。
- Obsidian 主题开发者需要检查 CSS 值或模拟移动端界面时，使用它执行开发调试命令。
这个 Skill 有哪些优点和局限？
- 覆盖笔记、任务、属性、标签、每日笔记和反向链接等常见仓库操作。
- 同时提供插件与主题开发调试命令，包括重载、错误检查、截图和 DOM 检查。
- 支持通过名称、精确路径或仓库名称定位目标。
- 仓库采用 MIT 许可证。
- 必须有正在运行的 Obsidian 实例。
- 命令默认面向最近聚焦的仓库，批量操作时需要明确指定 vault。
- 源材料未提供测试套件、平台测试矩阵或失败恢复说明。
- 该技能只覆盖 Obsidian CLI 交互，不应归因于它其他技能提供的 Markdown、Bases、JSON Canvas 或网页内容提取能力。
如何安装这个 Skill？
该技能随 kepano/obsidian-skills 集合安装。可使用 npx skills add https://github.com/kepano/obsidian-skills，或将仓库的 skills/ 目录复制到 Codex 技能路径（通常为 ~/.codex/skills）。也可通过 /plugin marketplace add kepano/obsidian-skills 后运行 /plugin install obsidian@obsidian-skills 安装集合。README 未提供仅安装 skills/obsidian-cli/ 子目录的专用命令。
如何使用这个 Skill？
先打开 Obsidian，再让代理执行具体请求，例如“读取我的 Obsidian 笔记 My Note”或“搜索仓库中包含 test 的内容”。对应命令示例包括 obsidian read file="My Note"、obsidian search query="search term" limit=10 和 obsidian property:set name="status" value="done" file="My Note"。可先运行 obsidian help 查看当前可用命令。