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 即將推出。