oma-search

Search Router

Scheduling

Goal

リクエストに必要な検索または取得チャネルを選択し、根拠となる証拠と取得上の制限を添えてソースを返します。

Intent signature

• 外部ドキュメント、ウェブ情報、リモート実装の例を探します。
• 既知の外部 URL を読み取るか、別のスキルに外部ソースを提供します。

When to use

ライブラリのドキュメント、ウェブ調査、リモートコード検索、既知の URL の読み取り、外部ソースのチャネル選択が必要なリクエストに使用します。

When NOT to use

• ローカルコードのみの調査 -> ../_shared/core/code-intelligence.md に従って、設定済みのコードインテリジェンスを直接使用します。このスキルを呼び出さないでください。
• Git の履歴／blame -> oma-scm、アーキテクチャ分析 -> oma-architecture。

Expected inputs

クエリまたは既知の URL、任意のルートヒント（docs、web、code、fetch）、バージョン、新しさ、ホスト、リポジトリ、ソースに関する制約、任意のウェブプロバイダーの上書き指定を入力します。--docs、--code、--web を明示すると、検索ルートが選択されます。--gitlab はリモートコードのホストを選択します。--strict は、適切な一次資料または公式ソースを、内容を確認した裏付けとともに必要とします。--wide は、制限事項を添えてより幅広い結果を含めます。これらの修飾子を使用しても、リクエストのソース制約は維持されます。

Expected outputs

回答、または関連するソースの一覧を返します。ソースの URL／ファイル参照、ルート、実際のプロバイダー、ソースの種類、内容の読み取り状況、裏付けとなる証拠、重要な制限事項を含めます。確認できた場合は、公開日、取得日、バージョンの詳細も含めます。結果、日付、ソース、確実性を捏造しないでください。

Dependencies

ドキュメントには Context7、ウェブ検索には設定済みの providers.web（native、brave、exa）、リモートコードには oma search code／gh／glab、既知の URL にはランタイムの取得ツールまたは oma search fetch を使用します。oma search providers は登録、選択、認証情報のメタデータを報告します。oma doctor は認証情報の有無を確認しますが、有効性や API への到達可能性は検証しません。

Structural Flow

Routes

Route	Execution	Scope
docs	Context7 によるライブラリの解決とクエリの実行。必要に応じて公式サイトを検索	リクエストされたバージョン制約内の公式ドキュメント
web	選択されたウェブプロバイダー：native ではランタイムツール、brave または exa では CLI アダプター	クエリに関連する URL の検索
code	選択されたコードホストを通じた oma search code	ホスト／リポジトリの制約内でのリモート実装の一致
fetch	利用可能な URL リーダー／ブラウザー、または oma search fetch <url>	すでに提供または検索済みの URL の読み取り

Failure and recovery

• ドキュメント検索で結果がない、または空の場合：ドキュメントルートのバージョンとソースの制限を維持したまま、公式サイトを検索します。
• 選択したウェブプロバイダーが利用できない、認証されていない、またはレート制限されている場合：その失敗を報告します。明示的に選択されたプロバイダーを、通知なしにネイティブ検索へ置き換えないでください。
• 検索で候補 URL が見つからない場合：元の制約内で検索条件を調整するか、結果がないことを報告します。URL の取得で検索結果の不足を補うことはできません。
• 既知の URL を読み取れない場合：取得固有の復旧リファレンスを使用し、アクセス／認証エラーとアーカイブの来歴を保持します。
• --strict に適合するソースがない場合：ソースまたは証拠の不足を報告します。より幅広い結果が得られても、それだけで厳格なリクエストを満たすことにはなりません。

Exit

裏付けのある結果を返し、失敗したルート、未読のソース、古いコンテンツやアーカイブされたコンテンツ、バージョンの制限を明示します。プロバイダー名やドメイン表示だけでは、個々の主張を検証したことにはなりません。

Logical Operations

標準ワークフローの流れ

1. 要求された結果と制約を確認します。純粋なローカルコードに関する依頼は、設定済みのコードインテリジェンスに直接引き継ぎます。外部での作業では、主要なルートを1つ選択します。選択が不明確な場合にのみ、resources/intent-rules.md を使用します。
2. resources/execution-protocol.md に従って、そのルートを実行します。設定またはリクエストのオーバーライドからウェブプロバイダーを解決します。残る証拠の不足を補う必要がある場合にのみ別のルートを追加し、デフォルトでは複数のルートに分散させないでください。
3. 回答を裏付けるために必要な関連コンテンツを読みます。URL と確認状況を保持し、結果の重複を排除して、ソースやバージョンの制約を適用します。出典のルール、または明示的に必要とされる任意のドメイン診断には resources/trust-registry.md を使用します。通常の結果では、数値の照会は必要ありません。
4. 質問との関連性とソースの適切性に基づいて順位付けします。証拠、実際に使用したルート／プロバイダー、および重要な制限事項を添えて、要求された回答またはソースを返します。

CLI のエントリーポイント

oma search providers
oma search web "<query>" [--provider <id>] [--limit <n>]
oma search code "<query>" [--host gitlab] [--language <lang>] [--repo <owner/repo>]
oma search fetch <url>
oma search trust <domain>

選択した操作でその基本機能が必要な場合にのみ、api、rss、meta、media、archive または doctor を使用します。trust は引き続き任意のドメイン診断です。

ガードレール

• 明示されたルート、プロバイダー、ソース、ホスト、バージョン、日付の制約を保持します。
• クエリの探索と既存 URL の読み取りは分けて行います。
• 検索スニペットや抜粋は限定的な証拠として扱い、未読のソースを明示します。
• 信頼スコアを捏造したり、プロバイダーやホスティングドメインだけを根拠に Context7/GitHub の結果を主張を裏付ける検証済み情報として扱ったりしないでください。
• 成功したルートを繰り返したり、ウェブ経由でローカルのプロジェクトファイルを検索したり、プロバイダーをインストールしたり、リポジトリを自動的に追跡したりしないでください。

リソースの範囲と影響

検索では外部サービスに接続し、設定済みのプロバイダーやコードホストのプロセスを起動する場合があります。取得では利用可能なブラウザーを起動する場合があります。クエリの制約と出典情報はセッションコンテキストとして扱います。永続キャッシュはスキル定義ではなく、生成された状態に保存します。ローカルソースのナビゲーションは、設定済みのコードツールが担当します。

参考資料

• ルートの選択：resources/intent-rules.md（外部リクエストが不明確な場合）
• 実行：resources/execution-protocol.md（選択したルートのみ）
• 出典情報と任意のドメイン診断：resources/trust-registry.md（ソース／証拠の解釈）
• 復旧：resources/error-playbook.md（ルートの失敗時）
• 結果の確認：resources/checklist.md（該当するソースと証拠の確認）
• 例：resources/examples.md（不慣れな入力や境界ケース）
• ローカルコードへの引き継ぎ：../_shared/core/code-intelligence.md（ローカルの依頼）