pg-aiguide：PostgreSQL 智能助手
为 AI 编程工具提供优化的 PostgreSQL 知识与最佳实践，生成更高质量的代码。
证据显示：仓库未提供权限模型、用户确认机制、数据流透明性、敏感数据处理、依赖安全审计、外部影响说明、回滚机制或来源归属的明确说明。所有信任相关标准均未得到支持，因此评分为0。
证据显示：README和package.json中的描述一致，均指向PostgreSQL文档搜索和技能提供，自洽性评分为2。依赖项在package.json中列出，但未提供可用性保证或锁定版本，依赖可用性评分为1。未提供失败消息或错误处理文档，失败消息评分为0。
证据显示：README明确了目标受众（AI编码助手）和多种使用场景（Agent Skills、MCP服务器、Claude插件），受众和场景评分为2。能力边界部分描述（如支持的扩展），但未明确限制，能力边界评分为1。触发精度未详细说明，仅提及技能自动使用，触发精度评分为1。环境适配良好，支持多种IDE和CLI，环境适配评分为2。
证据显示：README结构清晰，包含快速入门、功能、开发等章节，信息架构评分为2。安装说明详细，覆盖多种环境，安装说明评分为2。命名稳定性未明确，但版本号存在，命名稳定性评分为1。提供了示例提示和视频，示例和FAQ评分为2。已知限制未明确列出，仅提及即将支持pgvector，已知限制评分为1。许可证为Apache-2.0，许可证评分为2。版本号存在但无变更日志，版本和变更日志评分为1。维护责任未明确，但存在贡献指南，维护责任评分为1。
证据显示：输出可用性高，提供搜索和技能，输出可用性评分为2。边际价值明显，提供AI优化技能，边际价值评分为2。成本效益未量化，成本效益评分为1。
证据显示：README中的声明（如4倍约束）未提供可验证的测试或数据，声明可追溯性评分为1。跨来源佐证有限，仅依赖README，跨来源佐证评分为1。事实与推断未明确区分，事实推断分离评分为1。
- 未提供权限模型或用户确认机制，使用前需谨慎评估。
- 依赖未锁定版本，存在供应链风险。
- 声明（如4倍约束）缺乏可验证证据。
- 未提供回滚机制或数据流透明性说明。
这个 Agent 能做什么，适合哪些场景？
pg-aiguide 是一个 MCP 服务器和 Claude Code 插件，旨在帮助 AI 编码工具生成更准确、更现代的 PostgreSQL 代码。它提供基于官方 PostgreSQL 手册的语义搜索（支持版本感知），以及经过优化的“技能”（skills），涵盖模式设计、索引策略、数据类型等最佳实践。支持 Agent Skills（通过 npx skills 安装）和公共 MCP 服务器（https://mcp.tigerdata.com/docs）两种使用方式，并可作为 Claude Code 插件直接安装。
pg-aiguide 通过 MCP 提供文档搜索工具（search_docs），支持对 PostgreSQL、TimescaleDB 和 PostGIS 手册进行语义搜索和关键词搜索。它还通过 view_skill 工具暴露预设的 PostgreSQL 最佳实践技能，供 AI 代理自动使用。安装后，AI 代理可以在生成模式或查询时自动检索相关文档和技能，从而生成包含更多约束、索引和现代特性的高质量 SQL。
- 使用 Claude Code 或 Cursor 的开发者，希望生成更健壮的 PostgreSQL 模式。
- 使用 Codex 或 Gemini CLI 的开发者，需要快速查询 PostgreSQL 文档。
- 使用 VS Code 或 Visual Studio 的开发者，希望通过 MCP 集成获取实时文档建议。
- 处理复杂物联网数据模式的工程师，需要设计包含时序数据、异常检测等功能的数据库结构。
- 希望将 TimescaleDB 或 PostGIS 扩展集成到 AI 工作流中的团队。
这个 Agent 有哪些优点和局限？
- 提供版本感知的 PostgreSQL 官方手册语义搜索，确保知识最新。
- 内置经过优化的最佳实践技能，自动提升生成的 SQL 质量。
- 支持多种 AI 工具（Claude Code、Cursor、Codex、Gemini CLI 等）和协议（MCP、Agent Skills）。
- 开源且采用 Apache 2.0 许可，可自由扩展。
- 公共 MCP 服务器依赖 TigerData 托管，可能存在第三方服务依赖。
- 安装过程涉及多个环境（Node.js、命令行工具），对非技术用户不友好。
- 技能集和文档覆盖范围有限，目前仅支持 PostgreSQL、TimescaleDB 和 PostGIS，其他扩展（如 pgvector）仍在规划中。
如何安装或部署这个 Agent？
安装 Agent Skills：运行 npx skills add timescale/pg-aiguide --skill postgres 或交互式选择。安装 MCP 服务器：配置 JSON 将 https://mcp.tigerdata.com/docs 作为 MCP 端点。安装 Claude Code 插件：运行 claude plugin marketplace add timescale/pg-aiguide 然后 claude plugin install pg@aiguide。
如何使用这个 Agent？
安装后，直接向 AI 代理提问，例如“创建一个存储用户名和唯一电子邮件地址的 Postgres 表模式”。对于复杂任务，提供详细需求，代理会自动搜索相关文档并应用最佳实践。
这个 Agent 与同类方案有什么区别？
与原生 AI 工具（如不带额外插件的 Claude Code）相比，pg-aiguide 提供了更专业的 PostgreSQL 知识库和最佳实践集成。