mcpField
O
opencli-browser-sitemap

opencli-browser-sitemap

github.com/jackwenerエージェントワークフロー30.7k6.4k 回インストール2 日前に更新
リポジトリ

opencli-browser-sitemap について

ブラウザータスクで OpenCLI のサイトマップを使うエージェント向けスキルです。サイトマップを事前情報として扱い、ライブ状態と照合します。ワークフローやアダプターの古さが判明した場合は、ローカルに記録します。

主な機能

  1. 01関連するサイトマップファイルの選択
  2. 02ワークフローとライブ状態の照合
  3. 03アダプターを優先し失敗時はブラウザーにフォールバック
  4. 04古い情報のローカル記録
  5. 05ローカルのアダプター健全性の更新

活用シーン

  1. 01サイトマップを使ったサイト操作
  2. 02アダプター失敗時のフォールバック
  3. 03サイトワークフローの変更記録

インストール

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

$npx skills add https://github.com/jackwener/opencli --skill opencli-browser-sitemap

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

詳細

opencli-browser-sitemap

このスキルは、opencli browser open または opencli browser analyze が sitemap.available: true を報告した場合、またはユーザーからサイトのサイトマップを使うよう求められた場合に使用します。

サイトマップは事前知識であり、絶対的な正解ではありません。無目的なクリックを減らすために使用しますが、現在のブラウザーの状態より優先してはいけません。

使用の流れ

  1. 現在のページを把握するため、opencli browser <session> state を実行するか、以前の結果を再利用します。
  2. 関連する最小限のサイトマップファイルだけを読み込みます。
    • サイト全体の概要には SITE.md。
    • 現在の状態には、該当する pages/<page-id>.md を1つ。
    • ユーザーの目的には、該当する workflows/<task-id>.md を1つ。
    • ワークフローで問題が発生した場合や警告がある場合にのみ pitfalls.md。
  3. ワークフローの最適な方法を優先します。opencli twitter post のようなアダプターが指定されている場合は、ブラウザーを直接操作する前にそのアダプターを使います。
  4. アダプターを利用できない場合、または失敗した場合は、ブラウザーを使った代替方法に切り替えます。
  5. ナビゲーションや状態を変更する操作のたびに state を更新し、ワークフローの state_signature と比較します。
  6. 実際の状態と食い違う場合は、実際の状態を優先して調査を続け、ローカルの古い情報の注記または修正案を作成します。
  7. 操作のリカバリーに adapter_health_update: <adapter> -> suspect|broken が含まれる場合は、そのアダプターを参照するローカルオーバーレイのワークフローを更新し、今後のエージェントがすぐに代替方法へ進めるようにします。

参照順序

まずローカルオーバーレイを読み、次にグローバルシードを読みます。

~/.opencli/sites/<site>/sitemap/    # local overlay
sitemaps/<site>/                    # repo seed (top-level)

同じ安定 ID を持つファイルがある場合、ローカルファイルがグローバルファイルより優先されます。

大きなサイトマップ全体をコンテキストに読み込まないでください。ディレクトリが大きい場合は、まずファイル名を一覧表示し、必要なページまたはワークフローだけを読み込みます。

実際の状態を優先するルール

サイトマップにボタン、URL、ルート、API があると記載されていても、ブラウザーに表示されない場合：

  • state を再実行するか、セマンティックアンカーを使って find を実行します。
  • ログイン状態、ロケール、ビューポート、A/B テスト、ルートの状態に違いがないか確認します。
  • 安全な経路が表示されている場合は、実際のページに従います。
  • 該当するサイトマップ項目に、ローカルオーバーレイで古い情報の印を付けます。

「サイトマップにあるはずだから」という理由で、クリックを続けてはいけません。

古い情報の注記／修正案

差異を見つけた場合は、該当するページ／ワークフローファイルに短いローカルの注記を追加するか、ローカルオーバーレイに修正案ファイルを作成します。

Stale note:
- observed_at: YYYY-MM-DD
- current_url:
- expected:
- actual:
- next_probe:

タスクがサイトマップの作成またはリポジトリへのプルリクエストであることを明示している場合を除き、グローバルシードファイルを編集しないでください。

アダプターの健全性の書き戻し

アダプターが失敗し、サイトマップのアクションまたはワークフローでアダプターの健全性を更新するよう指示された場合：

  1. Best path でアダプターコマンドを参照している、~/.opencli/sites/<site>/sitemap/workflows/ 内のローカルワークフローファイルを探します。
  2. ローカルワークフローがない場合は、まず該当するグローバルワークフローをローカルオーバーレイにコピーします。ブラウザータスクの実行中にグローバルシードを直接編集してはいけません。
  3. 指示に従って adapter_health: suspect または broken を設定します。
  4. 観測したエラー、現在の URL、タイムスタンプを含む短い古い情報の注記を追加します。
  5. ブラウザーの代替方法に切り替えて続行します。

この書き戻しが記憶のループになります。現在のエージェントは一度だけ代替方法に切り替え、次のエージェントは問題が疑われる既知のアダプターを再試行してターンを無駄にしません。

出力のルール

報告には次の内容を含めます。

  • 選択した経路：アダプターを使った最適な方法、またはブラウザーの代替方法。
  • 到達したチェックポイント：現在の URL／状態シグネチャ。
  • サイトマップの健全性：そのまま使用、古い情報として記録、またはワークフローが見つからなかった。

報告はタスクに焦点を絞ります。サイトマップ全体を要約しないでください。

コメント

Markdown 対応