用途:检查 PostgreSQL 数据库、设计或运行 SQL,并诊断 PostgreSQL 运行时行为,通过随附的 CLI 完成。
主要能力:提供运行时用法、连接配置、环境变量、检查查询与数据库身份识别、模式变更防护、本地连接恢复、设计参考(模式、查询、安全、并发、诊断)、版本敏感语法路由、外部表(FDW)版本,以及 PostGIS、pgvector、pg_cron、pgmq、pg_durable 等扩展指南。
使用方式:使用 <skill-root>/scripts/postgres,应用数据库由 .skills/postgres/config.toml(旧版为 .skills/postgres/postgres.toml)配置。连接前先解析项目与 profile;在执行重要查询前以及目标变化时验证数据库身份。仅当配置与对话都无法确定目标时才询问。普通命令在内存中规范化配置,只有通过预期的配置写入命令或文档化的选择加入才持久化更改。可用 --json doctor 做运行时诊断。
权限与限制:默认远程访问为只读。应用写入或 DDL 需要针对该操作和数据库的授权;明确请求可提供授权。准备所请求的 SQL 及相关验证不需要额外批准;在未授权应用前,应展示 SQL 与验证,让用户批准具体变更。本地 profile 访问防护不能替代服务器角色、授权或 RLS。SQL 文件布局、变更日志格式、迁移运行器选择与发布顺序属于项目或团队决策,应遵循使用方仓库的说明,不要从本技能推断预发布或变更日志约定。选择最旧已部署主版本支持的语法;未知时使用可移植 SQL,或说明最低版本与回退方案。仅在升级比较或路由缺失功能时加载完整版本目录;依赖 PostgreSQL 19 前先核实当前发布状态。dump、restore、export 与 schema diff 不在该启动器覆盖范围内;原始 psql 仍可用于这些运维工作流、仓库文档化的容器或冒烟检查、用户明确选择或启动器恢复,但不要静默绕过已配置的应用 profile。