SkillsScout
ENG-QUALITY ／ 工程效率与代码质量

postgres-timescale-pg-aiguide

收录日期 2026-07-21·来源仓库 ↗
受欢迎程度
7
可用程度与相关性
8
安全性
9
8SCOUT SCORE

1. 基本信息

项目 内容 数据来源
名称 postgres-timescale-pg-aiguide —
项目自述名称 pg-aiguide（skill 本身在 SKILL.md 中命名为 postgres） GitHub
作者/维护者 Timescale（对外品牌 TigerData），官方组织仓库 GitHub API
来源链接 https://github.com/timescale/pg-aiguide/tree/main/skills/postgres —
许可证 Apache-2.0 GitHub API
GitHub Stars 1,790（整个 pg-aiguide 仓库口径；该仓库是包含 10 个 Postgres 相关 skill 的合集，此数字不代表 postgres 这一个 skill 自身热度） GitHub API
Forks 98 GitHub API
最新版本 0.5.1（package.json）；最近一次正式 Release 为 v0.5.0，发布于 2026-04-28 GitHub API
安装方式 npx skills add timescale/pg-aiguide --skill postgres 官方 README

2. 功能介绍与亮点

postgres 是 pg-aiguide 项目里的旗舰 skill，本质是一套结构化的 PostgreSQL 专家知识库：agent 触发后按任务类型加载对应参考文档，覆盖表设计（数据类型、约束、索引、JSONB、分区）、pgvector 向量检索（HNSW/IVFFlat、量化、过滤检索）、BM25 与向量的混合检索、PostGIS 空间数据建模、TimescaleDB hypertable 的创建与迁移，以及零停机 schema 迁移的安全模式。

主要亮点：

3. 适用场景

所属分类：工程效率与代码质量

适合用 Claude Code / Codex 等 agent 开发基于 PostgreSQL 的应用、需要设计规范的表结构与索引策略的初中级开发者；尤其适合涉及向量检索（RAG/语义搜索）、地理空间数据（PostGIS）或时序数据（TimescaleDB hypertable）等扩展生态、且不希望 agent 凭记忆编造过时用法的场景。

4. 跨 Agent 兼容性

（npx skills 是独立于 pg-aiguide 的第三方跨 agent 安装器，官方称支持 40 余种 agent；仓库另含 .cursor-plugin 目录，为 Cursor 做了专门适配，但 Cursor 不在本报告追踪的四个生态之内）

5. 推荐理由

PostgreSQL 是应用开发中最常用的关系型数据库之一，但 agent 生成的 schema 常常遗漏约束、索引或用过时写法。pg-aiguide 由 Postgres 时序数据库厂商 Timescale 官方维护，把表设计、pgvector、PostGIS、TimescaleDB 等常见扩展生态的最佳实践打包成纯参考文档型 skill，一条命令即可安装，且因为不执行代码、不联网，风险面很小，适合作为日常写 Postgres 代码时的常驻参考。

6. 评分

维度 分数 说明
受欢迎程度 7 Timescale 是知名的 Postgres 时序数据库厂商，官方仓库整体 1,790 stars；postgres skill 相关的 PR 与 issue 有多位仓库外部贡献者参与（如新增 PostGIS 支持、混合检索等特性均由外部贡献者提交），并有独立第三方监控服务对其 MCP 服务器给出高可靠性评价
可用性 8 一条命令即可安装（npx skills add timescale/pg-aiguide --skill postgres），SKILL.md 结构清晰、按任务路由到对应参考文档；Apache-2.0 开源无付费依赖；仓库持续有新版本发布
安全性 9 见下方检查清单

安全检查清单：

  1. shell 命令执行范围：postgres skill 本身是纯 Markdown 参考文档，agent 只读取不执行；仓库内另有用于构建文档索引的 ingest/ 脚本，但那是维护者用于生成参考资料的内部工具，终端用户安装 skill 后不会触发
  2. 联网外发：skill 本体不发起任何网络请求；仅在用户额外选择安装配套 MCP 服务器时才会连接官方 mcp.tigerdata.com
  3. API key 存储：skill 本身不需要任何密钥或凭据
  4. 可疑指令：抓取到的 SKILL.md 全文未发现面向 AI 助手的可疑指令或数据外发企图
  5. 作者信誉：Timescale 为知名开源数据库厂商，仓库署名与官方域名一致，未见刷星或 SEO 操纵痕迹
  6. License：Apache-2.0，明确
  7. 最近维护：仓库整体近期持续有提交与版本发布，postgres 参考文档在 2026-06-24 有过更新

7. 跟同类 Skills 相比的优势

Skill 定位 与本 skill 的差异
neon-postgres（Neon / Databricks 旗下） 聚焦 Serverless Postgres 的连接池、数据库分支（branching）、autoscaling 等基础设施层最佳实践 解决的是“如何连接和管理一个 Postgres 实例”；pg-aiguide 解决的是“表该怎么设计、扩展该怎么用”，两者可以搭配使用而非互斥
database-skills 中的 postgres 子技能（PlanetScale 官方） 面向 PlanetScale 托管 Postgres 服务的运维调优，覆盖 MVCC/VACUUM、WAL 调优、连接池 偏向已上线数据库的性能诊断与运维；pg-aiguide 偏向建表阶段的规范设计与 pgvector/PostGIS/TimescaleDB 扩展生态，覆盖面更广但不专攻单一托管平台的运维细节

8. 用户评价

第三方 MCP 服务器监控平台 YellowMCP 在 GitHub issue 中反馈：pg-aiguide 的 MCP 服务器在其监测的 2 万余个 MCP 服务器中可靠性排名前 0.1%，长期保持 100% 可用率、平均延迟 104ms（来源：GitHub issue #96，2026 年）。

另有真实用户在 issue 中反馈过与 Claude Code 集成时的缓存问题，以及安装扩展权限不足的报错，均已被维护者记录跟进，反映出该项目有持续的真实用户在使用并给出反馈。

9. 其他补充

仓库提供多种接入方式：除 Agent Skill 外，还可作为公共 MCP 服务器（mcp.tigerdata.com）或 Claude Code 插件市场条目使用；也提供 Cursor、VS Code 等编辑器的一键安装徽章。

10. 安装使用方式

11. 注意事项