mcpField
O
obsidian-cli-uri-fallback

obsidian-cli-uri-fallback

github.com/akillness生産性53125 回インストール4 日前に更新
リポジトリ

obsidian-cli-uri-fallback について

無人実行の Obsidian 自動化向けスキルです。CLI 呼び出しや URI 実行の失敗時にノートを Markdown ファイルへ保存し、フォールバックの記録を残します。デスクトップアプリが使えない場合や実行結果の監査が必要な処理に適しています。

主な機能

  1. 01終了コードと既知の失敗テキストを確認
  2. 02失敗時に Markdown ファイルへ直接保存
  3. 03コマンド、失敗シグネチャ、保存先を記録
  4. 04明示的な依頼がない限り再試行を回避

活用シーン

  1. 01定期実行からノートを保存
  2. 02デスクトップセッションなしでノートを永続化
  3. 03自動化実行の監査可能なフォールバック記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/akillness/jeo-skills --skill obsidian-cli-uri-fallback

インストール後、Claude Code で/obsidian-cli-uri-fallbackを入力して読み込まれたか確認します。

詳細

obsidian-cli-uri-fallback

Obsidian CLI の呼び出しを無人実行に含めており、URI の実行が失敗しても通知されない場合に、ノートを確実に保存する必要があるときにこのスキルを使用してください。

このスキルを使用する場面

  • obsidian-cli create/open/... を実行する cron ジョブや CI のような実行。
  • デスクトップアプリが利用できるか不確かな場合（ヘッドレス、リモート、またはロックされたセッション）。
  • 終了コードは 0 のままなのに、CLI の出力に明確な失敗の兆候が含まれている場合。
  • 監査用ノートを保持するための決定的なフォールバック手段が必要な場合。

手順

  1. 最初に、意図した obsidian-cli コマンドを実行します。
  2. 終了コードが 0 以外の場合、または既知の失敗を示すテキストがある場合は、いずれも失敗として扱います。
    • 最低限のシグネチャ一覧：
      • 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 "..." が、終了コード 0 で Failed to execute Obsidian URI を出力します。
    • 失敗として分類する
    • フォールバック：queries/hourly-2026-04-27.md に直接書き込む
    • 調査／PR の成果物にフォールバック先のパスを記録する

ベストプラクティス

  1. 無人実行のシェルでは、ASCII 文字のみの自動化ペイロードを優先します。
  2. フォールバックのファイル名は、安定したタイムスタンプ付きのものにします。
  3. 失敗のシグネチャを示すテキストがある場合、Obsidian CLI が成功したと決して主張しないでください。
  4. レビュー担当者が追跡できるよう、フォールバックの証拠を実行時の成果物と一緒に保管します。

参考資料

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

コメント

Markdown 対応