用途:当用户希望从终端操作 Obsidian 仓库,或任务涉及笔记、Markdown、日记、反向链接、标签、任务、仓库搜索时使用本技能;也适用于把仓库当作编码工作的外部工作记忆,记录项目上下文、决策、进度或交接状态。
主要能力:通过 Obsidian CLI 读取、搜索、创建、更新和检查笔记,处理日记、链接、任务与标签;支持先只读发现,再沿链接与反向链接扩展。
使用方式:运行笔记命令前先确认目标仓库,不清楚时执行 obsidian vaults;若只显示一个已打开仓库,默认使用它。命令或语法不确定时先查帮助:obsidian help、obsidian help <command> 或 obsidian <command> --help。优先只读搜索或读取,找到相关笔记后再扩展。更新已有笔记时优先用 append 或 prepend,而非重写整篇或新建;写入影响操作时事后重新读取。日记操作先用 daily:path 解析或 daily:read 查看再写入。CLI 支持时显式指定仓库。直接返回或总结 CLI 输出,除非用户要求否则不打开 GUI。
限制与安全:删除、移动、重命名、history:restore 或 sync/history 恢复等破坏性操作前须询问用户。除非用户要求重写,保留现有 frontmatter、标题、wikilink 和笔记结构。若帮助输出中没有所需操作,应假定 CLI 可能不直接支持,改用其他流程,不要臆造语法。本技能可能被安装到其他项目,不要假设仓库本地布局,需从运行环境询问或发现仓库路径。在 WSL 上 obsidian 可能不在 $PATH,可调用 Windows CLI 入口,例如 "/mnt/c/Program Files/Obsidian/Obsidian.com" vaults。涉及笔记选择、编码上下文或记录何种更新时,可读 references/coding-workflows.md;需要起草笔记文本时读 references/voice.md;从 references/REFERENCE.md 开始选择支持文件。