oma-search

検索ルーター

スケジューリング

目的

情報リクエストを適切なチャネルに振り分け、信頼度ラベル付きの関連ソースを返します。

インテントの特徴

• 検索、発見、参照、公式ドキュメントの確認、公式 API の調査、またはリモートコードの検索。
• 別のスキルから、クエリや制約付きでドキュメント、ウェブ、コード、またはローカル検索を依頼された場合。

使用する場合

• ライブラリのドキュメント、ウェブ調査、GitHub/GitLab の実装パターン、または検索チャネルが不明確な場合。

使用しない場合

• ローカルコードだけを調査する場合 -> 共有コントラクトに基づいて設定済みのコードインテリジェンスを使用します。
• Git 履歴／blame の場合 -> oma-scm、アーキテクチャ分析の場合 -> oma-architecture を使用します。

想定される入力

クエリ、任意のルートヒント（docs、web、code、local）、ソース／最新性の制約、およびフラグ。明示的な --docs、--code、または --web でルートを選択します。--strict は信頼度で絞り込み、--wide はラベル付きの結果を保持し、--gitlab はリモートコードのホストを選択します。

想定される出力

URL またはファイル参照、ルート、関連性、信頼度／スコア、および重要なフォールバック上の制限を含む、順位付けされたソース。信頼できる結果が見つからない場合、ソースを捏造してはいけません。

依存関係

ドキュメントには Context7、ウェブにはランタイムのウェブ検索、リモートコードには oma search／gh／glab、ローカル検索には設定済みのコードインテリジェンスまたはネイティブのローカル検索を使用します。

構造的なフロー

ルート

ルート	主な手段	フォールバック	用途
docs	Context7 resolve-library-id → query-docs	ウェブ検索	公式 API／フレームワークのドキュメント
web	ランタイムのウェブ検索	URL が既知の結果には oma search fetch <url>	ウェブ上のソース
code	oma search code	ホスト／認証が利用できないことを報告	リモートリポジトリのパターン
local	設定済みのコードインテリジェンスプロバイダー	ネイティブ検索と対象を絞った読み取り	現在のプロジェクトのファイルとシンボル

失敗時の復旧

• ドキュメント検索結果がない、または空の場合：ウェブ検索を使用し、フォールバックしたことを明記します。
• 既知の URL を取得できない場合：ルートリファレンスに記載された取得方法を使用します。すべての方法が失敗した場合は、認証／ブロックに関するエラーを残します。
• 設定済みのローカルツールを利用できない、またはタイムアウトした場合：../_shared/core/code-intelligence.md に従います。
• 信頼度が不明な場合：スコアを — として結果を unknown のまま保持し、検証済みであるかのように示してはいけません。
• --strict を満たす結果がない場合：その結果を報告し、より広い、またはより絞り込んだクエリを提案します。

終了

証拠に基づく結果を返し、失敗したルートやソースの制限を明示します。ドメインスコアだけでは、個々の主張を検証したことにはなりません。

論理操作

標準的なワークフロー

1. クエリと明示的なフラグを解析します。分類が必要な場合にのみ resources/intent-rules.md を使用し、曖昧さがない限りルートを1つ選択します。
2. ルートに従って処理を振り分けます。選択したチャネルのコマンドフラグ、取得方法、または正規化の詳細については resources/execution-protocol.md を読み込みます。
3. ソース参照を収集し、URL で重複を除去します。ローカル以外の結果については、resources/trust-registry.md でドメインの信頼度を解決し、現在のセッションキャッシュを再利用します。スコア付け後に --strict を適用します。
4. 関連性に基づいて順位付けし、同点の場合は信頼度を考慮します。フォールバックの制限と裏付けとなる参照を添えて、要求された回答またはソース一覧を返します。

CLI エントリーポイント

oma search code "<query>" [--host gitlab] [--language <lang>] [--repo <owner/repo>]
oma search trust <domain>
oma search fetch <url>

CLI では api、api:search、meta、rss、rss:google、media、archive、doctor も利用できます。選択したルートで必要な場合にのみ、プリミティブを使用してください。

ガードレール

• 明示的なルート／ソースの制約は、自動分類より優先されます。
• スコアは URL のパスやページ単位ではなく、ドメイン単位で付けます。CLI のレジストリと、文書化された Context7／公式サイトの例外を使用し、スコアを捏造してはいけません。
• 成功したルートを重複して実行したり、ウェブを使ってローカル検索したりしてはいけません。
• 利用可能なランタイムのウェブツールと設定済みのローカルプロバイダーを使用します。リポジトリを自動的にインストールしたり、追跡したりしてはいけません。

リソースの適用範囲と影響

検索では、外部サービスに接続したり、ローカルコードを調査したり、gh／glab プロセスを起動したりすることがあります。クエリの制約、選択したソース、信頼メタデータはセッションコンテキストです。永続キャッシュはスキル定義ではなく、生成された状態に保存してください。

参照資料

• 意図の分類器：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