1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | infra-postgres-clickhouse-agent-skills | — |
| 项目自述名称 | ClickHouse Agent Skills（仓库自述名；本子技能自身标题为 “Postgres with clickhousectl”） | GitHub |
| 作者/维护者 | ClickHouse Inc（官方组织账号） | GitHub API |
| 来源链接 | https://github.com/ClickHouse/agent-skills/tree/main/skills/infra-postgres | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars | 498（整仓库星数，仓库共含 12 个子技能，此数字不代表本子技能自身热度） | GitHub API |
| Forks | 32 | GitHub API |
| 最新版本 | 0.1.0 | SKILL.md metadata |
| 安装方式 | npx skills add clickhouse/agent-skills，或官方 CLI clickhousectl skills |
官方 README |
2. 功能介绍与亮点
这个技能教 agent 用 ClickHouse 官方 CLI clickhousectl 搭建和管理 Postgres 数据库，按“本地开发”与“云端生产”两条路径分流：
- 本地路径：
clickhousectl local postgres start一条命令拉起 Docker 容器化的 Postgres（默认版本 18，端口冲突时自动换端口），返回的 JSON 里带随机生成的连接密码；配套的client子命令自动包装psql（本机没装也能走容器内置的 psql）；dotenv子命令把连接信息直接写进.env - 云端路径：面向 ClickHouse Cloud 托管 Postgres（Beta），覆盖创建服务、TLS 证书获取、只读 OAuth 与可写 API Key 两级鉴权、运行时配置（
pgConfig/pgBouncerConfig）、读副本、主备切换（switchover）与基于时间点的备份恢复（point-in-time restore） - 本地路径写完的 schema 文件可以原样复用到云端连接上执行，两段路径衔接顺畅；密钥录入建议在独立终端完成，避免留在对话记录里；
delete/promote/switchover等破坏性操作文档里明确要求先跟用户确认
亮点：把“随手起一个本地 Postgres”和“托管到生产环境”接成一条链路，命令风格与姊妹技能 Infra ClickHouse 一致，共用同一套 CLI 与心智模型，团队里已经用 ClickHouse 的开发者上手成本很低。
3. 适用场景
固定分类：数据分析与可视化
面向需要 agent 引导搭建本地 Postgres 开发环境、并按需迁移到 ClickHouse Cloud 托管生产实例的开发者与数据工程师；也适合已经在用 ClickHouse 做分析、现在需要给应用配一个事务型 Postgres 库的团队，省去额外学一套 Postgres 专属运维工具的成本。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库 README「Supported Agents」表格列出 Claude Code，对应目录
.claude/skills/ - Codex：原生支持——同一张表格列出 Codex，对应目录
.codex/skills/ - OpenClaw：未验证——抓取材料中未出现相关声明
- Hermes Agent：未验证——抓取材料中未出现相关声明
（README 另列出 Cursor、Windsurf、GitHub Copilot、Gemini CLI、Cline、Goose、Roo Code、OpenHands 等十余款 agent，安装器会自动探测本机已装哪些 agent。）
5. 推荐理由
给应用配一个 Postgres 库，“先在本地随便起一个测试用”和“上线后怎么托管、怎么留后路”这两段经历常常要分别学两套工具。这个技能用同一个 CLI 把两段接起来：本地阶段一条命令拉起 Docker 容器、.env 自动写好就能开始写代码；到了要上线的时候，同一份 schema 直接搬到云端连接上执行，鉴权、TLS、读副本、时间点恢复这些生产必需项都有明确的分步命令而不是留白。破坏性操作（删除、主备切换）文档里都写明先确认，不是“能跑就跑”。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 子目录本身无独立 star 计数，仓库整体 498 星不能算给单个子技能；该子技能是仓库最新一批加入的技能，尚无独立于项目之外的第三方评价，但其所属的 ClickHouse Agent Skills 项目曾登上 Hacker News 讨论区（15 点赞，3 条独立评论），仓库本身持续有多位具名贡献者递交 PR |
| 可用性 | 8 | 本地路径一条命令起步、JSON 输出结构清晰、.env 自动写入；云端路径需要用户已有 ClickHouse Cloud 账号并创建 API Key 才能走写操作，完整体验前需配合完成账号环节 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行 | 有——clickhousectl CLI 管理 Docker 容器（起停 Postgres 实例）、执行 psql 查询；每一步用途在文档中说明清楚，无越权操作 |
| ② 联网外发 | 本地路径通信限于本机 Docker 网络；云端路径通过 clickhousectl 官方 CLI 与用户自己的 ClickHouse Cloud 账号通信，目标透明 |
| ③ API key/凭据 | 云端写操作需要 Admin 角色的 API Key，文档建议在独立终端完成登录避免留在对话里；连接密码随机生成后立即写入 .env，文档提醒加入 .gitignore |
| ④ 可疑指令 | 通读 SKILL.md 与 ref/local.md、ref/cloud.md 全文，未发现要求执行特权操作、隐蔽外发数据或混淆代码的可疑指令 |
| ⑤ 作者信誉 | ClickHouse Inc 官方 GitHub 组织账号出品，SKILL.md metadata 注明出品方与版本号；提交该技能的账号具备该官方仓库的直接合并权限 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 维护时间 | 技能于近日随仓库最新一次提交加入，同一提交同时替换了两个旧的 ClickHouse 本地/云端技能，整仓库持续有多位贡献者递交 PR |
7. 跟同类 Skills 相比的优势
同为面向 Postgres 环境搭建与托管的 agent 技能，定位差异如下：
| 技能 | 出品方 | 覆盖层次 | 特色 |
|---|---|---|---|
| Infra Postgres（本次推荐） | ClickHouse Inc | 本地 Docker 开发 + ClickHouse Cloud 托管 Postgres（Beta）一条链路，同一 CLI 贯穿始终 | 本地可随时起停多个命名实例，.env 自动写入；云端专有读副本、主备切换、时间点恢复 |
Neon Postgres（neondatabase/agent-skills） |
Neon | Serverless Postgres 的连接、分支（branching）、自动扩缩容等云端能力 | Scale-to-zero 云优先路线，不主打本地起服务器 |
Prisma Postgres（prisma/skills 的 prisma-postgres） |
Prisma | 通过 Console、create-db CLI、Management API/SDK 创建与集成 Prisma Postgres 实例 |
面向已用 Prisma ORM 的项目，程序化调用为主，不含本地 Docker 环境编排 |
| PlanetScale Database Skills | PlanetScale | MySQL/PostgreSQL/Vitess 的 schema 设计与查询调优参考 | 聚焦设计与调优建议，不涉及环境搭建或云端账号权限操作 |
差异化在于：Neon 与 Prisma Postgres 都是“云优先”，几乎不涉及本地环境；PlanetScale 只覆盖设计调优这一个环节；而这个技能把“本地随手起一个 Postgres”和“托管到生产、管好副本与恢复”接成一条完整链路，且与用户已经在用的 ClickHouse 生态共用同一套命令。
8. 用户评价
该技能于近日随仓库一次提交加入，是全新加入的功能，目前尚无独立于所属项目之外的具名第三方用户评价。该技能所属的 ClickHouse Agent Skills 项目此前曾登上 Hacker News 讨论区，有独立评论者对项目的安装机制发表过技术层面的看法。
9. 其他补充
姊妹技能 Infra ClickHouse（面向 ClickHouse 本身的本地/云端环境搭建）结构完全一致，可与本技能分别单独安装；仓库内还有 clickhouse-best-practices（schema/查询最佳实践）、chdb-sql/chdb-datastore（Python 内嵌分析）等技能，遵循 agentskills.io 开放技能规范。
10. 安装使用方式
- 推荐方式：
npx skills add clickhouse/agent-skills，CLI 会自动探测已安装的 agent 并询问装到哪个目录 - ClickHouse 官方 CLI：先安装
clickhousectl（curl -fsSL https://clickhouse.com/cli | sh），再运行clickhousectl skills - 手动安装：把仓库
skills/infra-postgres/整个目录复制进目标 agent 的技能目录即可 - 安装后无需重启；用户提到“搭建本地 Postgres”“连接应用到 Postgres”“创建/管理 ClickHouse Cloud 托管 Postgres”等意图时自动触发
- 本地路径需要本机已安装并启动 Docker；云端路径首次使用需要用户已有 ClickHouse Cloud 账号，并按引导生成 Admin 权限的 API Key
11. 注意事项
- 云端 Postgres 服务目前处于 Beta 阶段，功能与命令接口可能随版本迭代变化
- 连接密码一旦丢失，ClickHouse 无法明文找回，只能通过
reset-password重置；.env需加入.gitignore delete、promote、switchover等操作具有破坏性，技能文档要求先与用户确认目标实例再执行- 本技能是合集仓库中的一个子目录，是近日新加入的功能，尚缺乏独立于官方渠道之外的第三方使用反馈
- OpenClaw、Hermes Agent 的兼容性未获官方明确声明，跨 agent 使用前建议自行验证