smart-search-cli

Smart Search CLI

Web 調査では、ローカルの smart-search コマンドをデフォルトの実行レイヤーとして使用します。このエントリーポイントでは、ルーティング、境界、参照先の選択のみを扱います。コマンドの詳細やプロバイダーとの契約が重要な場合は、該当するリファレンスファイルを読み込んでください。

このスキルについて

smart-search-cli は、AI ツール向けの指示一式です。ローカルの smart-search 実行ファイルを呼び出すタイミング、ユーザーの意図に合ったコマンド、ソースの根拠の保持方法、プロバイダーのステータスとフォールバックのフィールドの解釈方法を説明します。

• このスキル自体は検索機能を提供しません。設定済みの smart-search CLI とそのプロバイダーが処理を実行します。
• このスキルは MCP サーバーではなく、プロバイダーの API キーを保存せず、Trellis、フック、エージェント、コマンドも作成しません。
• smart-search setup --install-skills ... は、選択したエージェントを接続します。インストールされたスキルでは短いブートストラップを使用します。この CLI の最新の指示を確認するには smart-search agent-guide を、参照ドキュメントを確認するには smart-search agent-guide references/<name>.md を実行してください。
• アプリの Update Skills ページには、選択した CLI のカタログが表示されます。明示的な同期では変更されたファイルがバックアップされ、Remove Skills では選択したターゲットをバックアップして接続を解除します。自動メンテナンスは CLI が担い、アプリを閉じていても動作し、個人の編集内容を保持します。接続された各ターゲットには、それぞれの CLI インストールと設定プロファイルが保持されます。
• CLI のアップグレード後、通常の使用時に管理対象のスキルが確認されます。skills status は引き続き読み取り専用で、skills update は明示的な更新を行います。変更を反映するには、エージェントのセッションを再度開いてください（Gemini の場合は /skills reload）。
• スキルの更新によってプロバイダーの設定や API キーが変更されることはありません。オプションのキーが未設定の場合、ライブチェックが成功したものとは扱わず、スキップしたままにします。

デフォルトのワークフロー

1. 設定や利用可否が不明な場合は、smart-search doctor --format json を実行します。
2. doctor で設定の不足が報告された場合は、ユーザーからキーが提供されていれば smart-search setup または smart-search config set KEY VALUE を使用します。デフォルトでは、ユーザーにグローバル環境変数の編集を求めないでください。
3. doctor の成功後に OpenAI 互換の search がハングしたりタイムアウトしたりする場合は、smart-search diagnose openai-compatible --format markdown を実行し、その概要を使用します。
4. 名前が指定されたリレーが公式の Responses サブセットプローブに合格していない限り、OPENAI_COMPATIBLE_API_MODE=chat-completions を維持します。responses を設定するのはそのリレーのみとし、診断の根拠を保持してください。
5. doctor が ok: true を返した場合、Web 調査には smart-search CLI のサブコマンドのみを使用します。同じタスクで Codex のネイティブ Web 検索を呼び出さないでください。
6. インストール済みのグローバルスキルが古くなっている可能性がある場合は、smart-search skills status --targets codex --format json を使用します。セットアップを再実行せずに更新するには、smart-search skills update --targets codex --format json を使用します。
7. CLI またはプロバイダーのアーキテクチャを変更した後は、smart-search smoke --mock --format json を使用します。--live は、実際のキーが利用可能で、ユーザーがライブチェックを期待している場合にのみ使用してください。
8. TAVILY_ENABLED=false は、意図的にネットワークアクセスを行わない境界として扱います。Tavily への直接呼び出しや map 呼び出しで回避しないでください。無効化またはスキップされた Tavily の状態は、doctor とライブスモークテストで確認してください。Firecrawl は独立して設定されます。
9. 結果の provider_notices にプロバイダーの機能低下が報告されている場合、またはプロバイダーの試行が skipped になっている場合は、smart-search providers status --format json を実行します。このチャネルには、永続化された障害クールダウンが適用されています。同じ失敗中のプロバイダーを再試行するのではなく、認証情報を修正するか、smart-search providers reset PROVIDER を実行してください。
10. 回答にはコマンドラインとソース URL を保持します。取得済みのページを優先して引用し、モデルの引用や未読の検索結果は、発見候補として扱ってください。

ルーティング

• search：単一パスで検索します。Jev またはローカルルールが適切なチャネルを1つ選択し、そのチャネルが結果とソースを返します。自動評価、追加検索、フィルタリング、統合は行いません。
• route：プロバイダーを実行せずに、ローカルで機能のルーティングを説明します。--router-mode jev --remote を指定すると、課金が発生する可能性のある TypeSafe の判定を明示的に利用します。
• research：Jev またはローカルルーティングを使って、補完的な情報の発見、取得・読解、エビデンスの不足への対応、任意の統合を行う、制限付きの共通ループです。
• deep：オフラインの Deep Research プランナーです。プロバイダーの実行やページの取得は行わず、デフォルトの search を置き換えるものでもありません。
• zhipu-search：中国語、中国国内、政策・規制、発表、最新ニュース、または中国国内のソースの発見に使用します。
• context7-library / context7-docs：ライブラリ、SDK、API、フレームワーク、またはドキュメントに関する意図に使用します。通常の検索では、Context7 のランキング候補のうち最初のライブラリを使用します。research では、Jev に候補の選択を依頼する場合があります。Jev が失敗した場合、またはスコアがしきい値に達する候補がない場合は、最初の候補を使用します。ライブラリが解決できない場合は、同じ機能の範囲内でフォールバックできます。明示的なコマンドでは、候補リストと指定されたライブラリ ID が保持されます。
• exa-search：公式ドメイン、論文、製品ページ、信頼できるページ、日付やドメインで絞り込んだノイズの少ない情報の発見、および exa-similar を介した関連ソースの発見に使用します。
• fetch：ユーザーが指定した URL、またはページの内容に依存する主張に使用します。
• map：1つのサイトから多数のページを取得する前に、ドキュメントサイトやドメインの構造を把握するために使用します。
• anysearch-*：実験的な垂直検索を明示的に行う場合にのみ使用します。まずドメインを確認し、AnySearch をデフォルトのフォールバックとして使用しないでください。繰り返し指定する --param key=value による上書きの前に、JSON パラメーターを解析します。anysearch-extract --max-length は URL のみを上流に送信し、正常に取得したテキストをローカルで切り詰めます。
• sciverse-*：実験的な学術検索を明示的に行う場合にのみ使用します。カタログ、検索、セマンティック検索、読み取り、関連性の確認に使用します。docs_search、standard、またはデフォルトの search / research のフォールバックとして Sciverse を使用しないでください。
• providers status / providers reset：任意のプロバイダーに保存された失敗時のクールダウン状態を確認または解除します。チャネルが同じ失敗を繰り返し報告する場合に使用してください。
• model current：明示的に指定されたプロバイダーのモデルのみを確認します。モデルを変更するには、smart-search config set XAI_MODEL ... または smart-search config set OPENAI_COMPATIBLE_MODEL ... を使用します。

主な境界

• smart-search はユーザーの PATH から解決される必要があります。
• 秘密の API キーは smart-search setup または smart-search config set を使って保存してください。CI や上級ユーザー向けには、環境変数も引き続きサポートされます。
• サンドボックス化されたランタイムでは、デフォルトの設定ディレクトリを利用できない場合や、ディレクトリを固定する必要がある場合に、SMART_SEARCH_CONFIG_DIR に絶対パスの書き込み可能な場所を設定してください。
• 標準の最小プロファイルには、有効な検索チャネルが少なくとも1つ必要です。Jev とメインモデルは任意ですが、要求された操作には対応可能なチャネルが必要です。
• フォールバックは同じ機能の範囲内に限られます。通常の検索では、モデルによる回答と Web 検索は相互にフォールバックできます。幅広いニュースや Web 上の事実の検索に Context7 を使用したり、ドキュメント検索の代わりにページ抽出プロバイダーを使用したりしないでください。
• content を信頼する前に、answer_check と primary_sources_count を確認してください。
• xAI Responses と OpenAI-compatible は、同格の main_search プロバイダーです。一方のプロバイダーの URL やキーを流用して、もう一方のプロバイダーをフォールバックとして偽装しないでください。
• 最新ニュース、政策、金融、健康、その他のリスクが高い事実については、幅広い検索の search.content だけを根拠に回答しないでください。重要なページを取得し、取得したテキストで裏付けられる内容のみを要約してください。
• この CLI 優先のワークフローでは、ユーザーが別の承認済みルートを明示的に設定しない限り、ネイティブの web_search は無効です。別の Web 検索ルートへ黙ってフォールバックしないでください。

参考資料

• コマンドの例、証拠ファイル、タイムアウト時の再試行ポリシー、ガードレール：references/command-patterns.md
• Deep Research のプランナー／実行者ワークフロー、計画フィールド、ギャップチェック、スモークテストマトリックス：references/deep-research-mode.md
• CLI エントリーポイント、コマンドシグネチャ、エイリアス、出力フィールド、終了コード、ツールポリシー：references/cli-core.md
• セットアップ、設定の保存場所、スキルのインストール、プロバイダーのエンドポイント、OpenAI 互換の診断：references/setup-config.md
• インテントルーティング、プロバイダーの機能、情報源の来歴、フォールバックの境界、ルーティングのメンテナンス：references/provider-routing.md
• 回帰テスト、パッケージ版のインストールチェック、リリースレーン、リリース完了時の教訓：references/regression-release.md
• 元のモノリシックファイルに言及する古い手順との互換性を示す参照マップ：references/cli-contract.md