use-my-browser

このスキルを汎用的なブラウジングのデフォルトとして扱わないでください。ツールの好みではなく、必要な証拠から経路を選択してください。

すべてのタスクは経路を選択する前に分類する必要があります:

• static-capable: ライブブラウザの状態、可視確認、ページインタラクションなしに証拠を生成できる
• browser-required: 証拠がレンダリング状態、インタラクション、ライブセッション動作、またはブラウザ専用の構造に依存している

static-capable タスクのみが静的取得、curl またはその他の非ブラウザのパスにフォールバックできます。タスクが browser-required となったら、ブラウザパスに留まり、欠落している機能を暗黙的にダウングレードするのではなく blocked としてマークしてください。

前提条件の確認

このスキルはユーザーのライブブラウザセッション内での作業を対象としており、別の独立した自動化ブラウザを起動するためのものではありません。

ブラウザオートメーションを実行する前に、ページインベントリ、タスク所有ページの作成、ページ選択、スナップショットまたは可視状態の読み取り、DOM検査、テキストまたはフォーム入力、アップロード、ダイアログ、コンソール検査、ネットワーク検査など、タスクが依存する機能を提供できるライブブラウザスタックにすでにアクセスできることを確認してください。ここで重要なのは正確なスタック構成ではなく、機能を確認することです。

ライブブラウザスタックが利用できない場合は、このスキルを通じてブラウザオートメーションを試みないでください。static-capable な作業のみが静的取得にフォールバックできます。

ライブブラウザオートメーションは、一部のサイトでアンチボットまたはアンチオートメーションの防御をトリガーする可能性があります。ブラウザインタラクションは、タスクが本当に必要とする場合にのみ使用し、必要な証拠が得られたら不要な繰り返しアクションを避けてください。

エクスペリエンスループ

サイトパターンをオプションの背景読み物ではなく、ブラウザプロトコルの一部として扱ってください。

browser-required な作業については、このループを実行してください:

1. ターゲットドメインがわかったら、すぐに references/site-patterns/ の下に対応するメモがすでに存在するかどうかを確認してください。
2. メモが存在する場合は、そのドメインで最初の意味のあるブラウザ変更を行う前に、それを読んでください。
3. 実行中は、将来の実行がどのように動作すべきかを変更する検証済みのサイト固有の事実を観察してください。
4. タスク完了を検討する前に、実行が再利用可能な事実を生成したかどうか、既存の事実を反証したか、または再利用可能なサイト固有の学習を生成しなかったかを決定してください。
5. 実行が何か再利用可能なものを検証したか、既存の主張を反証した場合は、完了する前に対応するメモを更新してください。

一度限りのノイズのためにドメインメモを作成しないでください。タスク自体が成功したからといって、実行終了のレビューをスキップしないでください。

次のいずれかが検証された場合、ライトバックが期待されます:

• 安定したルート形状または必要なクエリパラメータ
• ログイン、セッション継承、または isolatedContext の癖
• ホバー、キーボード入力、アップロードシーケンス、またはセレクタブリッジパターンなどの信頼性の高いインタラクションプリミティブ
• DOM生成リンクは信頼性が高いがハンドメイドURLが信頼性の低いドメイン
• 予測可能なアンチオートメーションの摩擦または誤解を招くプラットフォームエラー状態
• 再利用可能なメディア抽出またはiframe / Shadow DOMアクセスパターン

判定ガイド

ツールではなく結果から始めてください。ユーザーの目標を明示的にし、完了とは何かを定義し、正しい証拠を生成できる最も安価な経路を選択してください。

この経路の順序を使用してください:

1. タスクが static-capable であるか browser-required であるかを決定してください。
2. タスクが static-capable の場合は、references/task-routing.md を読み込み、証拠ターゲットを満たす最も安価な経路に留まってください。
3. タスクが browser-required の場合は、references/browser-playbook.md を読み込んでください。
4. 新しいホストセッションでブラウザ必要機能に不確実性がある場合は、references/browser-capability-matrix.md も読み込んでください。
5. ユーザーがすでに選択されたインスペクタ要素またはネットワークリクエストなどのアクティブなブラウザデバッグコンテキストを持っている場合は、references/debug-handoff.md も読み込んでください。
6. ブラウザ必要タスクがログイン済みダッシュボード、管理画面、CMS、エディタ、またはセーブ/パブリッシュ/アップデートフロー に触れる場合は、references/control-plane-workflows.md も読み込んでください。
7. 現在の失敗形状がソフト404、コンテンツ利用不可状態、疑わしいノーオペレーションインタラクション、認証ウォール、レート制限、またはアンチオートメーション防御を示唆している場合は、references/anti-automation-friction.md も読み込んでください。
8. ブラウザ必要タスクがiframe、Shadow DOM、折りたたまれたコンテンツ、またはレイジーロードされた証拠を含む場合は、references/deep-dom.md も読み込んでください。
9. 重要な証拠が画像、オーディオクリップ、またはビデオにある場合は、references/media-inspection.md も読み込んでください。
10. ブラウザ作業を独立したページ所有者またはサブエージェント間で分割できる場合は、references/parallel-browser-ownership.md も読み込んでください。
11. すでに信頼性の高いセレクタがわかっているが MCP ネイティブな uid ターゲットが必要な場合は、references/selector-bridge.md も読み込んでください。
12. ページアクションが状態を曖昧にしたまま残す場合、ページが予期せずナビゲートする場合、古い uid が古い可能性がある場合、またはコンソール/ネットワーク検査が次のブラウザ判定を説明するために必要な場合は、references/browser-recovery.md も読み込んでください。
13. ターゲットサイトに references/site-patterns/ の下の対応するドメインメモがある場合は、サイトで操作する前にそのメモを読んでください。

次のものを デフォルトで browser-required として扱ってください:

• localhost, 127.0.0.1, またはベンチマークスタイルのローカルフィクスチャ
• アップロード、ダウンロード、ドラッグアンドドロップ、ホバー、キーボードネイティブ入力、または可視確認状態
• 同一オリジンiframe検査、Shadow DOM検査、details /折りたたまれた証拠、またはレイジーロードされたコンテンツ
• 「ページが見えている内容」そのものが証拠であるタスク

一般的なタスクの通常のハッピーパスは、このエントリーポイントと1~2の参考資料です。参考資料セット全体ではありません。

ハードルール

• ライブブラウザ状態が証拠の一部であるか必要なアクションである場合にのみ、ブラウザインタラクションを使用してください。
• タスクが browser-required となったら、暗黙的にダウングレードしないでください。
• このファイルをエントリーポイント、各参考資料ファイルを単一目的の権威として扱ってください。ファイル間でルールを重複させないでください。
• 参考資料の読み込みは1レベル深くしてください。ある参考資料を複数の参考資料にリンクするハブに変えるのではなく、このエントリーポイントから次のファイルを決定してください。
• ページが制限されているように見えるというだけの理由でユーザーにログインするよう求めないでください。最初にターゲットコンテンツまたはアクションが実際にブロックされているかどうかを確認してください。
• ハンドメイドURLより、ページが期待するパスを示してくれたら、ページ生成DOMリンクを優先してください。
• タスクが本当にインブラウザアクションである場合は、スクリプト駆動インタラクションより MCP ネイティブアクションを優先してください。
• あなたが作成したページだけを閉じてください。
• 集約者または繰り返された二次報告より、一次情報源を優先してください。
• 対応するサイトパターンメモが存在する場合は、そのドメインで最初の意味のあるブラウザ変更を行う前に、それを読んでください。
• browser-required タスクを完了する際に、実行がサイトパターン主張を作成、更新、ダウングレード、または削除すべきかどうかを明示的に確認せずに終了しないでください。
• 既存のサイトパターン主張が同等の条件下で失敗した場合は、それを信頼することを停止し、古い前提を再試行するのではなく、メモを更新しながら汎用ワークフローにフォールバックしてください。
• browser-required タスクに対して curl, Invoke-WebRequest, またはシェルHTTP取得を使用しないでください。
• 汎用的なページオープニングツールを、localhost深層インタラクションが利用可能であることの証拠として扱わないでください。
• ブラウザ機能プローブが失敗したというだけの理由で経路を切り替えないでください。欠落している機能を記録して停止してください。
• ユーザーがアクティブなブラウザデバッグコンテキストを示している場合は、スクラッチからの新規再現より、その現在のコンテキストからのハンドオフを優先してください。

参考資料インデックス

• references/task-routing.md: 静的取得 vs ライブブラウザ経路
• references/browser-playbook.md: コアページアクションプロトコルとベースブラウザループ
• references/browser-capability-matrix.md: 不確実なホストセッションの機能証明
• references/debug-handoff.md: アクティブデバッグコンテキストのハンドオフ
• references/control-plane-workflows.md: ログイン済みダッシュボード / CMS セーブ・パブリッシュ規律
• references/anti-automation-friction.md: ソフト404 / 認証 / アンチオートメーション分類
• references/deep-dom.md: iframe、Shadow DOM、折りたたまれた、またはレイジーロードされた証拠
• references/media-inspection.md: 画像、オーディオ、およびビデオ証拠
• references/parallel-browser-ownership.md: マルチオーナーブラウザ調整
• references/selector-bridge.md: セレクタ-uid ブリッジング
• references/browser-recovery.md: 古い uid、ナビゲーション乖離、およびコンソール/ネットワークエスカレーション
• references/site-patterns/README.md: サイトパターンメモメンテナンスルール
• site-patterns/{domain}.md: 既存のドメイン固有の操作知識