莫的 Skills 精品 Hubskills.miemie
安装热度榜官方 Skill

neon-postgres

来自 neondatabase/agent-skills 的官方技能，面向 Neon 的 Lakebase Postgres 数据库工作，覆盖连接方式、schema 迁移、分支、自动扩缩容、缩容至零、即时恢复、只读副本、IP 允许列表、逻辑复制与 Lakebase Search。文档区分 pooled（带 -pooler 后缀，用于应用查询）与 direct（无后缀，用于迁移、pg_dump/pg_restore、逻辑复制、LISTEN/NOTIFY、依赖 SET 的会话状态）两类连接字符串，并给出驱动选择建议（Vercel/Cloudflare/Neon Functions 用 node-postgres，serverless 与边缘环境用 @neondatabase/serverless，其 HTTP 用于一次性查询、WebSocket 支持事务）。诊断部分强调优先使用 Neon 预置只读检查（CLI `neon inspect db` 与 MCP `inspect_database`），如 table-sizes、index-sizes、unused-indexes、seq-scans、long-running-queries、locks、outliers、calls、lfc-hit-rate、working-set、vacuum-stats、bloat、replication-slots、subscriptions，并说明各检查的语义差异与结果解读注意事项；还介绍用 EXPLAIN (ANALYZE, BUFFERS, PREFETCH, FILECACHE) 查看 Local File Cache 与预取行为。该技能为 `neon` 父技能的子技能，新后端、Auth、文件、Functions 与 LLM 调用归属父技能。

分类
数据库
榜单排名
#264
安装量
220,476

它能做什么

中文摘要

来自 neondatabase/agent-skills 的官方技能，面向 Neon 的 Lakebase Postgres 数据库工作，覆盖连接方式、schema 迁移、分支、自动扩缩容、缩容至零、即时恢复、只读副本、IP 允许列表、逻辑复制与 Lakebase Search。文档区分 pooled（带 -pooler 后缀，用于应用查询）与 direct（无后缀，用于迁移、pg_dump/pg_restore、逻辑复制、LISTEN/NOTIFY、依赖 SET 的会话状态）两类连接字符串，并给出驱动选择建议（Vercel/Cloudflare/Neon Functions 用 node-postgres，serverless 与边缘环境用 @neondatabase/serverless，其 HTTP 用于一次性查询、WebSocket 支持事务）。诊断部分强调优先使用 Neon 预置只读检查（CLI `neon inspect db` 与 MCP `inspect_database`），如 table-sizes、index-sizes、unused-indexes、seq-scans、long-running-queries、locks、outliers、calls、lfc-hit-rate、working-set、vacuum-stats、bloat、replication-slots、subscriptions，并说明各检查的语义差异与结果解读注意事项；还介绍用 EXPLAIN (ANALYZE, BUFFERS, PREFETCH, FILECACHE) 查看 Local File Cache 与预取行为。该技能为 `neon` 父技能的子技能，新后端、Auth、文件、Functions 与 LLM 调用归属父技能。

为什么推荐

推荐理由

这是 Neon 官方仓库维护的数据库专项技能，安装量约 18.4 万次，适合已经在用或准备使用 Neon Postgres 的开发者。它不泛泛讲 Postgres，而是集中给出 Neon 特有的分支工作流、pooled/direct 连接取舍、serverless 驱动选择、自动扩缩容与缩容至零、即时恢复、只读副本、逻辑复制和 Lakebase Search 等实践，并附上官方文档链接，可直接落到具体配置决策。其中的诊断流程与连接陷阱（迁移误用 pooled 连接导致 prepared statement 冲突、SET search_path 不持久、只读事务报错等）对排查实际问题很有价值。适合与 postgres-best-practices 技能配合：Neon 计算、缓存、连接与平台决策留在本技能，通用查询改写与索引优化交给后者。

什么时候用

适用场景

  • 为现有 DATABASE_URL 或 Neon 项目选择 pooled 与 direct 连接字符串
  • 在 Neon 上执行 schema 迁移、pg_dump/pg_restore 或逻辑复制前确认连接方式
  • 为 Vercel、Cloudflare、Netlify 或 Neon Functions 选择驱动与连接方法
  • 使用分支为迁移测试、预览部署或隔离环境创建 copy-on-write 克隆
  • 排查 Neon 数据库性能问题，选择并解读 neon inspect db 或 MCP inspect_database 检查项
  • 在 serverless 或高并发场景下配置 PgBouncer 连接池
  • 实现缩容至零、自动扩缩容、即时恢复或只读副本相关策略
  • 在 Neon 上搭建语义搜索、BM25 全文搜索或混合搜索，或用 Drizzle 管理 Lakebase Search
  • 通过 EXPLAIN (ANALYZE, BUFFERS, PREFETCH, FILECACHE) 检查 Local File Cache 与预取行为

使用前先看

主要亮点

  • 01

    官方技能，安装量 184057 次，来自 neondatabase/agent-skills 仓库，父技能为 `neon`

  • 02

    提供 pooled（-pooler）与 direct（DATABASE_URL_UNPOOLED）连接选择表，明确迁移、pg_dump/pg_restore、逻辑复制、LISTEN/NOTIFY、会话状态需用 direct

  • 03

    列出 pooled 连接误用迁移时的具体故障表现，如 `prepared statement "s0" already exists`、SET search_path 不持久、SQLSTATE 25006 只读事务

  • 04

    给出按运行时选驱动的建议：Vercel 配 Vercel Fluid compute 与 attachDatabasePool、Cloudflare 用 Hyperdrive、serverless/边缘用 @neondatabase/serverless（HTTP 一次性查询、WebSocket 事务）

  • 05

    诊断优先使用 Neon 预置只读检查 `neon inspect db` 与 MCP `inspect_database`，并按症状给出检查项对照表

  • 06

    解释检查项语义差异：long-running-queries 指当前运行超 5 分钟的语句，outliers 按累计执行时间排名，calls 按执行次数排名

  • 07

    说明 outliers 与 calls 需要 pg_stat_statements，lfc-hit-rate 与 working-set 需要 neon 扩展，安装扩展前应先询问

  • 08

    EXPLAIN (ANALYZE, BUFFERS, PREFETCH, FILECACHE) 可获取 File cache hits/misses 与 Prefetch hits/misses/expired/duplicates，且不需 neon 扩展；MCP 的 explain_sql_statement 不暴露这些选项，需用 run_sql

  • 09

    给出结果解读的安全提示：unused-indexes 只是候选清单，bloat 为统计估计，缓存与统计在计算重启（含缩容至零）后重置，需先跑代表性负载

  • 10

    分支为即时、copy-on-write 克隆，每个分支有独立计算端点；缩容至零默认空闲 5 分钟后挂起，首次查询约有数百毫秒冷启动，仅 Launch 与 Scale 计划可禁用

  • 11

    Lakebase Search 支持语义（向量）、BM25 全文与混合搜索，并提供 Drizzle 管理参考文档

  • 12

    技能命名空间划线清晰：登录、用户、会话与 @neondatabase/auth 归 neon-auth，新后端、Auth、文件、Functions 与 LLM 调用归父技能 neon

原始文档

原文摘录

**FIRST**: Use the parent `neon` skill for a Neon overview, getting started with Neon, Neon development best practices, and more. If the `neon` skill is not installed, fetch it from https://neon.com/docs/ai/skills/neon/SKILL.md or install it with: neon skills -s neon -y