timescale/pg-aiguide

解决的问题

AI 编码助手经常生成过时的 PostgreSQL 代码，缺少必要的约束和索引，或忽略现代功能和现实世界中的最佳实践。pg-aiguide 为 AI 代理提供版本感知的文档和经过精选的最佳实践，以确保它们生成的数据库模式和查询具有鲁棒性、高性能且易于维护。

工作原理

它作为一组「技能」和 Model Context Protocol (MCP) 服务器运行。它为 AI 代理提供两种主要功能：

1. 语义搜索：一个统一的搜索工具（search_docs），使用向量相似性和关键词搜索来查询官方 PostgreSQL 手册、TimescaleDB 和 PostGIS 文档。
2. 精选技能：一个包含意见性最佳实践的库（view_skill），涵盖模式设计、索引、数据类型和性能调优，代理可自动应用这些实践。

适用人群

使用 AI 编码工具（如 Claude Code、Cursor、VS Code 或 Gemini CLI）并希望其 AI 助手编写高质量、现代化 PostgreSQL 代码的开发者。

主要亮点

• 版本感知文档：可访问按版本范围的官方 PostgreSQL 手册。
• 编码化最佳实践：涵盖索引策略、数据完整性、命名规范的精选技能。
• 广泛的代理兼容性：通过 npx skills 或 MCP 服务器集成，支持 40 多个代理。
• 扩展支持：包含 TimescaleDB 和 PostGIS 的文档和技能，pgvector 即将推出。