postgres

Postgres

对于由 .skills/postgres/config.toml（旧版：.skills/postgres/postgres.toml）配置的应用数据库，请使用 <skill-root>/scripts/postgres。连接前解析项目和配置档案；执行重要查询前以及目标发生变化时，验证数据库身份。只有在配置和对话内容都无法明确目标时，才询问目标。

远程访问默认设为只读。应用写入或 DDL 需要获得针对该操作和数据库的授权；用户的明确请求可视为授权。准备用户要求的 SQL 及相关验证不需要再次审批。未经授权而要执行应用变更前，应先提供 SQL 和验证内容，以便用户批准具体变更。本地配置档案访问保护不能替代服务器角色、授权或 RLS。

SQL 文件布局、变更日志格式、迁移运行器的选择以及发布顺序，均由项目或团队决定。遵循使用该技能的代码库说明；不要根据此技能推断预发布版本或变更日志约定。

路由

• 命令、连接设置、JSON：运行时用法。
• 配置选项：选项和配置架构。
• 环境变量：环境。
• 检查查询和数据库身份：常见工作流。
• 架构变更：架构变更防护措施。
• 本地连接恢复：恢复。
• 架构、查询、安全、并发或诊断设计： 设计索引。
• 与版本相关的语法：SQL 版本路由。
• 外部表：FDW 版本。
• 扩展：阅读对应指南：PostGIS、 pgvector、pg_cron、 pgmq或pg_durable。

选择最早部署的主版本所支持的语法。如果版本未知，请使用可移植的 SQL，或说明最低版本和回退方案。只有在进行升级比较或路由器缺少某项功能时，才加载完整版本目录；依赖 PostgreSQL 19 前，请验证其当前发布状态。

普通命令会在内存中规范化配置；只有通过预期的配置写入命令或有文档说明的选择加入方式，才会持久化变更。使用 --json doctor 诊断运行时问题。转储、恢复、导出和架构差异不在此启动器的覆盖范围内。原始 psql 仍可用于这些运维工作流、代码库文档说明的容器/冒烟测试、用户明确选择的情况，或启动器恢复；不要悄悄绕过已配置的应用配置档案。