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 集合。 明确决定不同嵌入是作为命名向量放在同一集合中，还是需要使用独立的集合级来源和策略设置。 记录必须保持兼容或需要迁移计划的任何现有 pgvector 配置。切勿将这些资源视为可互换。 对于已同步的项目，仅使用现有的同步源表和嵌入列；不得计划在目标上使用 add_column 或 new_table。
• 说明 TSVector 的语言/配置选择和模糊匹配阈值。
• 对于混合检索，定义阶段顺序、来源记录、去重、授权和令牌预算。
• 包含重建或重建索引的触发条件、就绪检查，以及回滚或回退行为。

边界

• 此技能不得修改项目、生成密钥，也不得声称计划已应用。
• 不得编写会修改内容的命令示例。将已批准的配置工作交给 $polygres-cli，将已批准的 Python 集成交给 $polygres-sdk。
• 筛选条件不能作为授权边界。在数据进入检索前以及解析结果时，都必须应用访问控制。
• 如果缺少必需的列、稳定 ID 或可用样本，尽可能给出可逆的临时建议。只有在缺失的证据导致所有安全建议都无效时才停止。

完成

返回已完成且可供审核的计划、尚未解决的假设、建议交接给公共接口的事项，以及任何变更或实现所需的明确批准。