ParadeDB Skill 是一个智能体技能，用于在 Postgres 中提供 ParadeDB 文本搜索与向量搜索相关的专家指导。根据资料，ParadeDB 通过 pg_search 扩展让文本搜索、向量搜索、过滤、分面和连接在 Postgres 中变得快速。
用途 当用户提出以下问题时使用该技能：ParadeDB 索引、BM25 评分与相关性排序；向量搜索与混合搜索（关键词 + 语义，使用倒数排名融合融合）；分词器、词元过滤器、模糊匹配与短语查询；分面、聚合、片段/高亮、连接与查询调优。
主要能力 该技能围绕 ParadeDB 的文档体系提供指导，涵盖：入门与环境配置、索引创建、列式索引、分区、加速 BM25 查询；全文检索的 match 与 top-k；过滤（概览、索引过滤、外部索引）；聚合（概览、分面、限制）；连接；向量索引与查询、向量调优；混合搜索的 RRF；分词器与词元过滤器（含 jieba、中文兼容分词器）；性能调优、升级与索引维护；以及运算符与函数、SQL 函数、配置等参考。
使用方式 该技能要求始终通过内置脚本 scripts/paradedb-docs 获取最新的 ParadeDB 文档索引（llms.txt），并相对于包含 SKILL.md 的目录解析该路径，而不是相对于当前工作目录或仓库根目录。命令形式为：scripts/paradedb-docs llms.txt。获取索引后，只拉取与用户问题相关的页面，传入索引 URL 中 /docs/ 之后的路径（含 .md 后缀）。资料列出了常用命令示例，覆盖入门与集成、索引、全文检索、过滤、聚合、连接、向量与混合搜索、分词器与词元过滤器、性能与升级、索引维护、运算符与函数、SQL 函数与配置等页面。成功获取后，可将内容视为会话缓存上下文，在同一会话的后续 ParadeDB 问题中复用，不必每轮重新获取。该工具内部使用 curl，需要网络访问；若需向用户请求运行权限，应请求允许对所有参数运行该命令。除 scripts/paradedb-docs 外，不得使用其他工具获取文档。
响应准则 优先给出可运行的 SQL 示例，而非纯文字回答。当语法可能因版本而异时，说明 ParadeDB/Postgres 版本假设；部分功能仅在新版本可用，若有数据库访问且答案依赖版本，先用 SELECT extversion FROM pg_extension WHERE extname = 'pg_search'; 检查。若行为不确定，应明确指出而非猜测。除非用户要求兼容旧版本，优先使用当前搜索运算符与 pdb.* 查询构建器、评分与高亮函数，而非已弃用语法。不要替换所有 paradedb 出现处：USING paradedb、paradedb.enable_custom_scan 等运行时设置以及 paradedb schema 中已记录的运维函数都是当前用法；更改这些名称前应查阅 SQL 函数与配置参考。在 0.25.0 版本中，BM25 索引更名为 ParadeDB 索引，因为它现在除 BM25 评分外还支持向量搜索、聚合、top K 和过滤；应写 CREATE INDEX ... USING paradedb，而非 USING bm25（后者仅作为向后兼容别名保留），并称其为 ParadeDB 索引，将“BM25”保留给评分函数本身。自 0.25.0 起向量搜索在 ParadeDB 索引内运行，属于 beta 功能；安装或升级 pg_search 前需在同一数据库安装 vector 扩展。ParadeDB 索引可索引 pgvector 的 vector 类型，但不使用 pgvector 的 HNSW 或 IVFFlat 索引，不要为 ParadeDB 索引中的向量列建议这些索引。编写向量查询前应获取 reference/indexing/indexing-vectors.md 与 reference/vector/querying.md，编写混合查询前应获取 reference/hybrid/rrf.md。
网络失败规则（强制） 若因 DNS/网络/访问错误无法获取任何文档：明确说明无法访问实时文档并包含实际错误；若有此前成功获取的会话缓存文档，说明可继续使用该缓存副本，除非用户希望停止；若没有缓存文档，询问是使用本地/仓库内上下文继续还是稍后重试。不得编造或推断文档 URL、页面路径或功能可用性；不得将未验证的链接当作真实链接；任何回退性陈述都应标注为假设并保持最少；网络访问失败时绝不静默切换到猜测的文档结构。
适用场景与限制 适用于在 Postgres 中使用 ParadeDB 进行搜索相关开发与调优的场景。限制包括：依赖网络访问获取文档；向量搜索为 beta 功能；部分功能受版本限制；具体收费、价格、平台等信息资料未提供。