timescale/pg-aiguide

解决的问题

AI 编程助手经常生成过时的 PostgreSQL 代码，缺乏适当的约束与索引，或忽略了现代功能与实际的最佳实践。pg-aiguide 为这些代理程序提供深入且具备版本意识的知识与经过验证的模式，以产出更稳健、高效且易于维护的数据库结构。

运作方式

它通过三种主要方式与 AI 代理程序整合：

• Agent Skills: 精选且具备观点的最佳实践（技能），代理程序可在进行结构设计、索引与性能调优等任务时自动使用。
• MCP Server: 一个 Model Context Protocol 服务器，使代理程序能够在官方 PostgreSQL 手册、TimescaleDB 与 PostGIS 文档中进行语义与关键词搜索。
• Plugins: 针对 Claude Code 等工具的专门整合。

适用对象

使用 AI 编程工具（如 Cursor、Claude Code、VS Code 或 Gemini CLI）的开发者，希望确保为其 PostgreSQL 数据库生成的 SQL 符合现代标准与专业最佳实践。

特色亮点

• 版本意识搜索: 在官方 PostgreSQL、TimescaleDB 与 PostGIS 手册中进行语义搜索。
• AI 优化技能: 关于命名惯例、数据完整性与现代 PG 功能（例如 GENERATED ALWAYS AS IDENTITY）的指导。
• 广泛兼容性: 通过 npx skills 框架与 MCP 标准，与 40 多种 AI 代理程序兼容。
• 结构探索: 包含用于调查现有 PostgreSQL 数据库的特定技能。