1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | infra-clickhouse-clickhouse-agent-skills | — |
| 项目自述名称 | ClickHouse Agent Skills（仓库自述名；本子技能自身标题为 “ClickHouse with clickhousectl”） | GitHub |
| 作者/维护者 | ClickHouse Inc（官方组织账号） | GitHub API |
| 来源链接 | https://github.com/ClickHouse/agent-skills/tree/main/skills/infra-clickhouse | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars | 498（整仓库星数，仓库共含 11 个子技能，此数字不代表本子技能自身热度） | GitHub API |
| Forks | 32 | GitHub API |
| 最新版本 | 0.3.0 | SKILL.md metadata |
| 安装方式 | npx skills add clickhouse/agent-skills，或官方 CLI clickhousectl skills |
官方 README |
2. 功能介绍与亮点
这个技能把“搭本地 ClickHouse 开发环境”和“部署到 ClickHouse Cloud 生产环境”两条路径合并进一个决策树入口，按用户实际意图路由到对应参考文档：
- 本地路径：
clickhousectl local use latest一条命令装好 ClickHouse 并设为默认版本；local init生成标准项目目录（tables/、materialized_views/、queries/、seed/）；起后台服务器、写建表与种子数据 SQL、用SHOW TABLES/SELECT count()验证 - 云端路径：引导注册 ClickHouse Cloud（提供免信用卡试用）、创建 API Key 并说明为何需要 Admin 角色、创建云服务、把本地 schema 迁移上去，最后专门为应用创建最小权限专属用户（只给
SELECT/INSERT，明确提醒不要用default管理员账号） - 密钥录入环节建议用户在独立终端标签完成，避免把密钥留在对话记录里；密码写入
.env前先持久化，防止后续步骤失败导致凭据丢失
亮点：把此前两个独立技能整合为一套统一命令体系，本地验证过的 schema 能直接复用到云端部署，不必两套流程各学一遍；云端权限管理给出的是具体做法（专属最小权限用户），不是泛泛的安全提醒。
3. 适用场景
固定分类：数据分析与可视化
面向想用 ClickHouse 构建应用、需要 agent 引导从零搭建本地开发环境、并在准备好后无缝迁移到生产云服务的开发者与数据工程师，也适合团队里带新人上手 ClickHouse 时统一操作路径。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库 README 的 Supported Agents 表格列出 Claude Code，对应目录
.claude/skills/，仓库另带.claude-plugin清单 - Codex：原生支持——同一张表格列出 Codex，对应目录
.codex/skills/ - OpenClaw：未验证——抓取材料中未出现相关声明
- Hermes Agent：未验证——抓取材料中未出现相关声明
5. 推荐理由
“本地怎么起步、什么时候该上云、上云后权限怎么分”是第一次接入一个新数据库时最容易卡壳、也最容易图省事直接复用管理员账号糊弄过去的环节。这个技能用一张决策表把两段路径接起来，agent 能按用户真实意图（本地原型、准备上生产、或两者都要）分流到对应参考文档，不需要用户自己判断该看哪份指南；云端部分对权限收敛（专属最小权限用户）与密钥处理（避免留在对话里）都给出了可执行的具体做法。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 子目录本身无独立 star 计数，仓库整体 498 星不能算给单个子技能；该子技能是本仓库最新加入的一批，尚无独立引用记录，但仓库整体持续有多位外部贡献者递交 PR，所属项目也曾登上 Hacker News 讨论区（15 点赞，含独立评论者的技术讨论） |
| 可用性 | 8 | 本地路径一条命令起步、步骤含可直接执行的示例 SQL，维护活跃；云端生产路径需要用户注册 ClickHouse Cloud 账号（有免信用卡试用），完整体验前需配合完成账号与密钥环节 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行 | 有——clickhousectl CLI 装本地数据库、起停服务器、执行建表/查询，以及 openssl rand 生成随机密码；每步用途在正文中说明清楚，无越权操作 |
| ② 联网外发 | 本地路径通信限于本机；云端路径通过 clickhousectl 官方 CLI 与用户自己的 ClickHouse Cloud 账号通信，目标透明 |
| ③ API key/凭据 | 云端部署需要 ClickHouse Cloud API Key，技能明确建议在独立终端录入避免留在对话里，密码写入 .env 并提醒加入 .gitignore |
| ④ 可疑指令 | 抽查 SKILL.md 与两份参考文档全文，未发现要求执行特权操作、隐蔽外发数据或混淆代码的可疑指令 |
| ⑤ 作者信誉 | ClickHouse Inc 官方 GitHub 组织账号，SKILL.md metadata 注明出品方与版本号 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 维护时间 | 该子技能随仓库最新一次提交一并加入，整仓库持续有多位贡献者递交 PR |
7. 跟同类 Skills 相比的优势
同为数据库/数据平台官方出品、涉及“本地开发到云端部署”引导流程的技能，定位差异如下：
| 技能 | 出品方 | 覆盖层次 | 权限处理 |
|---|---|---|---|
| Infra ClickHouse（本次推荐） | ClickHouse Inc | 用一张决策表把本地开发与云端生产部署接成一条链路 | 专门为应用创建最小权限用户，密钥录入建议脱离对话窗口 |
Neon Postgres（neondatabase/agent-skills） |
Neon | 面向 Serverless Postgres 的连接、分支、自动扩缩容等云端能力 | 区分 Pooled/Unpooled 连接串，产品定位是 scale-to-zero 云端优先，不主打本地起服务器 |
| PlanetScale Database Skills | PlanetScale | MySQL/PostgreSQL/Vitess 的 schema 设计与查询调优参考 | 聚焦设计与调优建议，不涉及环境搭建或云端账号权限操作 |
| MongoDB Connection | MongoDB | 面向 MongoDB 驱动的连接配置排障 | 聚焦连接字符串与驱动配置，不含从零建库或云端部署引导 |
差异化在于：Neon 走的是无需本地服务器的 serverless 路线，PlanetScale 与 MongoDB Connection 各自只覆盖调优或连接排障这一个环节，而这个技能专门把“本地搭环境”和“上云部署+权限收敛”两段路径串成一条完整链路。
8. 用户评价
该技能所属的 ClickHouse Agent Skills 项目曾登上 Hacker News 讨论区（2026 年 2 月，15 点赞），有独立评论者对技能的安装机制提出技术层面的商榷意见，另有评论澄清该安装器实为复用 Vercel 的通用 skills CLI，而非厂商自造机制。这个具体子技能于 2026 年 7 月 27 日随本地与云端流程的合并重构一起推出，发布时间尚短，目前没有独立于该讨论之外的具名用户评价。
9. 其他补充
该技能取代了此前分别负责本地开发与云端部署的两个技能，合并为统一入口；同仓库还有 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-clickhouse/整个目录复制进目标 agent 的技能目录即可 - 安装后无需重启；用户提到“搭建本地 ClickHouse 开发环境”“部署到 ClickHouse Cloud”等意图时自动触发
- 云端路径首次使用需要用户已有 ClickHouse Cloud 账号，并按引导生成 Admin 权限的 API Key
11. 注意事项
- 云端路径要求的 API Key 建议使用 Admin 角色创建（用于自动配置查询端点），意味着该密钥权限较高，应妥善保管、不要提交进版本库
.env需要加入.gitignore；应用专属用户的密码一旦丢失，ClickHouse 无法明文找回，只能通过ALTER USER重置- 本技能是合集仓库中的一个子目录，是同仓库原有两个技能（本地开发、云端部署）的合并升级版本
- OpenClaw、Hermes Agent 的兼容性未获官方明确声明，跨 agent 使用前建议自行验证