前言¶

在业务开发里，查表结构、跑一条 UPDATE、对照测试库和生产库的数据，往往要切到桌面客户端或自己拼 psql 连接串。把连接信息写进项目里的 .env 或脚本，又容易在提交时泄露密码。若希望由编码 Agent 代为执行查询和有限的写操作，还需要一层机制：默认不真提交、生产环境单独确认、危险 DDL 二次把关。

下面介绍 SkillHub 上的 postgres连接助手（@user_2ea0925b/postgresql）。它把「CLI 直连 PostgreSQL」的能力封装成 Agent Skill，并约定凭据只放在用户目录，写操作默认 dry-run。

这是什么¶

postgres连接助手 是一套通过 CLI 直连 PostgreSQL 的工具集，面向增删改查、查看表结构、列出表、执行 DDL 等日常数据库操作。

• 坐标：@user_2ea0925b/postgresql
• 版本：1.0.0
• 来源：community（SkillHub 分类 dev-programming）
• 发布者：user_2ea0925b

官方页面：SkillHub - postgres连接助手。Skill 元数据接口地址为 https://api.skillhub.cn/user_2ea0925b/postgresql（页面侧引用）。

SkillHub 上该 Skill 标签含 requires_api_key=true，表示安装或使用 SkillHub 相关能力时可能需要配置 API Key；具体字段以 SkillHub 与 Skill 说明为准。

核心功能¶

以下能力均来自官方简介，未单独列出的子命令或参数不在本文臆造。

1. 数据读写：查询、修改、删除 PostgreSQL 数据；支持 UPDATE / INSERT / DELETE 等写操作。
2. 元数据与结构：查看表结构、索引、外键；列出数据库中的表。
3. DDL：可执行 DDL（含需格外谨慎的语句类型）。
4. 多环境连接：在测试、预发、生产等环境之间切换数据库连接（凭据由本地配置文件管理，而非仓库内文件）。
5. 执行问题排查：适用于排查 pg_query / pg_execute 相关执行问题。
6. 安全默认：
   - 所有写操作默认 dry-run，必须显式加上 --confirm 才会真正提交。
   - 生产环境在 --confirm 之外，还需要 --confirm-prod。
   - 对危险 SQL（如 DROP / TRUNCATE）需要二次确认（与简介中的使用场景一致）。

凭据路径固定为：

~/.codebuddy/postgres-cli/credentials.json

官方明确要求：严禁在项目仓库内创建含密码的文件。

安装与启用¶

Skill 基于通用 SKILL.md 格式，通过 SkillHub 安装到当前 Agent 的 skills 目录后才会被识别。

1、安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需要 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明见：SkillHub 安装与优先源配置。

2、安装本 Skill¶

官方页面给出的方式，是让 Agent 根据安装文档安装坐标 @user_2ea0925b/postgresql。命令行等价形式为（--dir 必须指向当前 Agent 的 skills 目录）：

skillhub install @user_2ea0925b/postgresql --dir <skills 目录>

常见 Agent 的 skills 路径（摘自 SkillHub 安装文档）：

安装到错误目录（例如默认的 ./skills/）时，Agent 可能无法加载，需按文档调整后重启或重新加载。

3、配置数据库凭据¶

在用户目录准备 ~/.codebuddy/postgres-cli/credentials.json，写入各环境连接信息。JSON 内部字段名以 Skill 包内 SKILL.md 为准；本文不编造示例密码或字段结构。

配置完成后，在对话中说明目标环境（测试 / 预发 / 生产）和操作意图，由 Agent 按 Skill 约定调用 CLI。

典型用法（对话侧）¶

官方简介归纳了触发本 Skill 的自然语言场景，可复现的用法模式如下。

1. 只读排查：「列出某库所有表」「查看某表的索引和外键」「执行 SELECT 核对数据」。
2. 受控写入：「执行 UPDATE / INSERT / DELETE」——先接受 dry-run 结果，确认无误后再要求带 --confirm 提交。
3. 生产变更：在生产环境写操作时，除 --confirm 外，还需明确 --confirm-prod（按 Skill 约定由 Agent 执行）。
4. DDL 与高危语句：涉及 DROP、TRUNCATE 等时，按 Skill 要求完成二次确认后再执行。
5. 环境切换：「改用预发库连接」——依赖 credentials.json 中的环境配置，而不是在仓库里新增连接文件。

具体 CLI 子命令与参数以安装后的 Skill 文档为准；写操作始终遵循：默认不提交，显式确认后才落库。

适用场景与注意¶

适合谁

• 已在用 Cursor、Claude Code、Codex 等支持 Skills 的工具，希望 Agent 代跑 PostgreSQL 查询与有限写操作。
• 需要区分测试 / 预发 / 生产，并愿意把连接信息集中在 ~/.codebuddy/postgres-cli/credentials.json。
• 希望写库默认预览（dry-run），生产与危险 SQL 多一道确认。

限制与注意

• 凭据不得进 Git 仓库；团队应统一用本地或密钥管理系统，而非把 credentials.json 提交到项目。
• SkillHub 页面统计（截至抓取）：评分 100000，下载 940，分类 dev-programming；安装量等以 SkillHub 实时展示为准。
• 标签 requires_api_key=true：使用 SkillHub 搜索、安装时可能需要 API Key，与数据库密码是不同层面的配置。
• 本文未收录的包内 CLI 帮助、credentials 字段示例，请以安装后的 @user_2ea0925b/postgresql 内文档为准。

结尾¶

postgres连接助手 把 PostgreSQL 的 CLI 操作收敛进 Agent Skill：查表、改数、看结构、跑 DDL，并默认 dry-run、生产与危险语句额外确认，凭据固定在用户目录。若你正在 SkillHub 上找数据库相关的 dev-programming 类 Skill，可从官方页安装 @user_2ea0925b/postgresql：

https://www.skillhub.cn/skills/user_2ea0925b/postgresql