open-websearch-maintainer

Open WebSearch メンテナー

open-websearch のコードベース自体を変更する場合は、このスキルを使用してください。

このスキルと現在のリポジトリの動作が食い違う場合は、リポジトリのコード、テスト、意図された変更範囲を優先し、作業を終える前にスキルまたはドキュメントを更新してください。

まず変更を分類する

• エンジンの変更：新しいエンジン、エンジンの解析、エンジンのページネーション、ボット対策。
• ネットワークの変更：プロキシ、TLS、リクエストビルダー、Playwright との連携、ブラウザーへのフォールバック。
• ツールの表層の変更：MCP ツールの登録、スキーマ、エンジンの正規化、設定の公開。
• 検証のみの変更：コードパスの動作変更を意図しない、テスト、ドキュメント、リリース準備。

この分類を作業の開始点にしてください。最初にカテゴリを1つ選び、それに合ったチェックリストだけを読み込み、変更したコードパスが実際にその境界を越える場合にのみ対象範囲を広げてください。

スコープの規律

• 実際の障害箇所で可能な限り局所的に修正してください。
• 根拠なく、解析やエンジン固有の問題を共通ネットワークのリファクタリングに広げないでください。
• テストを1つ通すためだけに、安全性を損なう動作や互換性を緩和する動作を広げないでください。
• 意図的に変更し、検証してドキュメントに記載する場合を除き、ツールの契約や全体的な動作を変更しないでください。

基本ルール

• 破壊的変更が明示的に必要な場合を除き、MCP ツールの契約を安定して保ってください。
• Axios ベースのネットワーク処理は、場当たり的なプロキシ処理ではなく、共通の HTTP リクエストビルダーを経由させてください。
• プロキシ、TLS、Playwright の動作は、複数箇所に影響する関心事として扱ってください。変更後は明示的に検証してください。
• エンジンを追加する場合や動作を変更する場合は、テストと README ファイルを更新してください。

禁止事項

• 特定のエンジンだけの修正で、共通の HTTP リクエストビルダーを迂回しないでください。
• リポジトリでその方針が明示的に採用されていない限り、単一のエンジンでプロキシの動作を暗黙に分岐させないでください。
• 必要な狭いコードパスを超えて、安全性を損なう TLS の動作を広げないでください。
• テスト、設定処理、README ファイルを確認せずに、ツールの契約を変更しないでください。
• 変更が検索結果の解析やドキュメントのみの場合は、共通ネットワークコードに手を加えないでください。

変更チェックリスト

検索エンジンを追加または変更する場合：

• src/config.ts を更新する
• src/tools/setupTools.ts を更新する
• エンジンのテストを追加または更新する
• README.md と README-zh.md を更新する

ネットワークの動作を変更する場合：

• src/utils/httpRequest.ts を優先する
• Axios では proxy: false の動作を明示する
• 安全性を損なう TLS は、必要な場合に限り、オプトインで対象を限定する

検証

• まず TypeScript のチェックを実行してください。
• 変更した箇所を対象とするテストを実行してください。
• 実際のネットワーク動作に依存する変更では、ライブテストを実行してください。

レビュー時の重点項目

• ページネーションと検索結果が空の場合の処理
• ボット対策／認証ページの検出
• USE_PROXY および PROXY_URL を使用する場合のプロキシの動作
• リクエストモードと Playwright モードの動作の違い
• ドキュメントと実装のずれ

変更を実装する際は references/workflow.md を、パッチを確定する前に references/validation.md を読んでください。