polygres-retrieval-design

Polygres 検索設計

検索設定やアプリケーション作業に着手する前に、レビュー可能な計画を作成します。 このスキルは助言のみを行い、プロジェクトを直接変更してはなりません。

Polygres MCP ツールを利用できる場合は、 references/mcp-tool-contract.md を読み、検出した読み取りツールを使って範囲を限定した調査を行います。whoami を呼び出し、接続に設定されたプロジェクトの境界を尊重してください。また、変更ツールが表示されていても、このスキルでは読み取り専用を維持します。

ワークフロー

1. プロンプトと調査したアプリケーションから、ユーザーが望む結果、権限、レイテンシ、鮮度、期待する結果の形式を抽出します。推奨を左右する不足情報だけを質問してください。代表的な質問は有用な根拠ですが、必須の聞き取りではありません。
2. プロジェクトモードを特定し、提供されたスキーマ、検証済みの行識別子、サンプルデータ、既存の検索設定を調査します。根拠が不足している情報は未解決として明示し、テーブル名やカラム名から本番環境の事実を推測してはなりません。
3. references/strategy-selection.md を使って、必要十分な最小の戦略を選択します。根拠のない機能は作り上げず、そのような戦略は却下してください。
4. グラフ検索の場合は、references/graph-modeling.md を適用します。既存のベクトル設定、TSVector、またはファジー検索がある場合は、references/vector-and-text-design.md を適用します。 MCP Graph ツールを利用できる場合は、根拠と引き継ぎ要件について references/mcp-graph-retrieval.md も読みます。
5. pgContext コレクション、ポイント同期、登録済みフィルター、または Context 検索モードについては、references/context-design.md を適用します。
6. 複数段階の検索または RAG については、references/hybrid-and-rag-plan.md を適用します。
7. references/plan-template.md を使って結果を記述します。$polygres-data-pipeline から呼び出された場合は、選択したコンポーネントと省略したコンポーネント、および正確なパブリックインターフェースの引き継ぎ情報を、呼び出し元が追加の聞き取りなしに続行できるよう、機械可読なセクションで返します。
8. 設計のみの依頼では、変更を加える前に停止します。アクティブなデータパイプラインのセットアップでは、オーケストレーションを行うスキルに制御を戻します。統合レビューと承認に従って実装してください。

設計ルール

• 検索インデックスを必要としない、正確な述語、結合、集計、トランザクションには、リレーショナル検索を優先します。
• 同期済みプロジェクトでは、正確な SQL、トランザクション、ソースの変更はソース PostgreSQL データベースに保持します。Polygres では、サポートされている Runtime の検索および検索設定のインターフェースのみを使用します。
• グラフ、ベクトル、テキスト、Context の各インデックスとポイントマッピングは、準備状況と更新動作を検証する必要がある、派生プロジェクトリソースとして扱います。
• 検証済みデータから得られた正確なスキーマ識別子と安定した行 ID 値を使用します。架空の行 ID を使用したり、スキーマ名をあいまいに照合したりしてはなりません。
• グラフの方向、深さ、分岐数、結果件数、サイクル動作に上限を設けます。
• 埋め込みモデル、次元数、距離指標、入力の構成方法、次元不一致または空の埋め込みに対する対応を記録します。
• 新しいセマンティック検索計画では、Polygres AI Context コレクションをデフォルトとします。異なる埋め込みを1つのコレクション内の名前付きベクトルにするか、コレクション単位で個別のソース設定とポリシー設定が必要かを明示的に判断します。互換性を維持する必要がある、または移行計画が必要な既存の pgvector 設定を記録します。これらのリソースを相互に置き換え可能なものとして扱ってはなりません。同じプロジェクトで同期済みのソーステーブルと埋め込みカラムのみを使用し、ターゲット上で add_column または new_table を計画してはなりません。
• TSVector の言語／設定の選択と、ファジー検索のしきい値を明示します。
• ハイブリッド検索では、段階の順序、出所、重複排除、認可、トークン予算を定義します。
• 再構築または再インデックスの実行条件、準備状況の確認、ロールバックまたはフォールバックの動作を記載します。

境界

• このスキルは、プロジェクトを変更したり、シークレットを生成したり、プランが適用されたと主張したりしてはなりません。
• 変更を伴うコマンド例は記載しないでください。承認済みの設定作業は $polygres-cli に、承認済みの Python 統合作業は $polygres-sdk に引き継いでください。
• フィルターは認可の境界ではありません。データが検索に入る前と、結果を解決する際の両方でアクセス制御を適用してください。
• 必須の列、安定した ID、または利用可能なサンプルがない場合は、可能であれば取り消し可能な暫定的な推奨案を提示してください。不足している根拠のために安全な推奨案がすべて無効になる場合に限り、作業を中止してください。

完了

レビュー可能な完成済みプラン、未解決の前提、推奨するパブリックサーフェスへの引き継ぎ、および変更や実装の前に必要な明示的な承認を提示してください。