obsidian-cli-uri-fallback

obsidian-cli-uri-fallback

当无人值守运行中包含 Obsidian CLI 调用，且 URI 执行可能静默失败时，使用此技能确保笔记可靠持久化。

使用时机

• Cron 作业或类似 CI 的运行会尝试执行 obsidian-cli create/open/...。
• 桌面应用是否可用尚不确定（无头环境、远程环境或会话已锁定）。
• CLI 输出包含明确的失败特征，但退出代码仍为零。
• 你需要确定性的回退路径来保留审计笔记。

说明

1. 首先运行预期的 obsidian-cli 命令。
2. 将非零退出代码或已知的失败特征文本视为失败。
   • 最低限度的特征列表：
     • Failed to execute Obsidian URI
     • Cannot find note in vault
3. 失败时，使用确定性的命名方式，直接将笔记写入 Markdown 路径（<vault>/.../*.md）。
4. 在运行产物中记录回退状态：
   • 尝试执行的命令
   • 观察到的特征
   • 回退文件路径
5. 继续工作流，不要循环重试，除非用户明确要求重试。

示例

• obsidian-cli create "queries/hourly-2026-04-27.md" -c "..." 输出 Failed to execute Obsidian URI，但退出代码为 0。
  • 判定为失败
  • 回退：直接写入 queries/hourly-2026-04-27.md
  • 在调查/PR 产物中记录回退路径

最佳实践

1. 在无人值守的 Shell 中，优先使用仅含 ASCII 字符的自动化负载。
2. 使用稳定且带时间戳的回退文件名。
3. 存在失败特征文本时，绝不要声称 Obsidian CLI 执行成功。
4. 将回退证据与运行产物放在一起，以便审查者追溯。

参考资料

• .agent-skills/obsidian-cli/SKILL.md
• .agent-skills/survey/references/keyword-sweep-and-relevance-rescue.md