ClickHouse Agent Skills（ClickHouse 官方智能体技能包）

# ClickHouse Agent Skills：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能本身、它们的规则文件或脚本。这些要从 ClickHouse 的仓库安装：https://github.com/ClickHouse/agent-skills

许可证：Apache 2.0。全文见 https://github.com/ClickHouse/agent-skills/blob/main/LICENSE。仓库的 NOTICE 文件（https://github.com/ClickHouse/agent-skills/blob/main/NOTICE）说，packages/clickhouse-best-practices-build/src/ 下的部分构建文件改编自 Vercel 的 Agent Skills 项目，采用 MIT 许可证。技能本身是 ClickHouse 仓库里的文字，两个 chdb 技能写明作者是 chdb-io。

ClickHouse Agent Skills 是 ClickHouse 自己的项目。README 称它为“the official Agent Skills for ClickHouse”（ClickHouse 官方智能体技能）。Mindket 只负责上架，并不是作者。

这些说明的来源：README（https://github.com/ClickHouse/agent-skills/blob/main/README.md），https://github.com/ClickHouse/agent-skills/tree/main/skills 下每个技能的 SKILL.md，infra-clickhouse 技能的 ref/local.md 和 ref/cloud.md，best-practices 技能的规则 agent-connect-mcp.md，以及 https://github.com/ClickHouse/agent-skills/tree/main/.claude-plugin 里的插件文件。Claude Code 从哪里加载技能，出自它的技能页面（https://code.claude.com/docs/en/skills）。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

一套给编程智能体用的技能，面向 ClickHouse 和 chdb（在 Python 进程内运行的 ClickHouse）。README 说，智能体加载这些技能后，就掌握了 ClickHouse 的最佳实践和 chdb 的 API，能在你设计表、写查询、分析数据或排查性能问题时用上。

skills 文件夹里有 11 个技能。README 介绍了其中 8 个：

| 技能文件夹 | 用途 |
|---|---|
| clickhouse-best-practices | 按成文规则检查表结构、查询和配置，以及智能体如何连接 ClickHouse 并安全地探查它 |
| clickhouse-architecture-advisor | 结合工作负载的设计选择：数据接入、关联、迟到数据、时间序列分区、预聚合 |
| clickhouse-js-node-troubleshooting | Node.js 客户端 @clickhouse/client 的错误和异常行为 |
| chdb-datastore | 由 chdb 支撑、与 pandas 兼容的 API |
| chdb-sql | 在 Python 进程内运行的 ClickHouse SQL |
| infra-clickhouse | 用 clickhousectl 在本地或 ClickHouse Cloud 上运行 ClickHouse |
| infra-postgres | 用 clickhousectl 在本地运行 Postgres，或在 ClickHouse Cloud 上运行托管 Postgres |
| clickstack-otel-collector | 把 OpenTelemetry 采集器接到 Managed ClickStack 服务 |

另外三个不在 README 的列表里：clickhouse-js-node-coding（用 Node.js 客户端写代码）、clickhouse-js-node-rowbinary（在 Node.js 里读写 RowBinary）和 clickhouse-managed-postgres-rca（找出托管 Postgres 变慢的原因）。

## 工具包里的文件

- setup/claude-code.md：README 里的 npx 安装方式，针对 Claude Code
- setup/other-agents.md：同样的安装方式用于 README 列出的其他智能体，以及找不到智能体时怎么办
- setup/clickhousectl.md：README 的第二种安装方式，以及如何安装 clickhousectl 本身
- setup/what-each-skill-needs.md：每个技能需要你的电脑具备什么、需要你提供什么

## 先准备好这些

- README 列表里的一个智能体，先装好。
- Node.js，用于 npx 那一行。README 没有给出版本要求。
- Python 3.9 或更高版本，在 macOS 或 Linux 上，只有两个 chdb 技能需要。它们的 SKILL.md 写的是“pip install chdb”。
- clickhousectl，只有第二种安装方式、infra 技能和 ClickStack 技能需要（setup/clickhousectl.md）。
- ClickHouse Cloud 账号，只有上云时才需要。infra 技能在本地使用时不需要云端账号。

## 插件文件

仓库里还有 .claude-plugin/marketplace.json 和 plugin.json。README 没有给出 /plugin 命令，所以这些说明也不给。

## 你的数据

技能本身是文字。有什么数据离开你的电脑，取决于智能体运行了什么。infra 和 ClickStack 技能会让智能体运行 clickhousectl，本地 Postgres 或采集器还会用到 Docker，它们能在你的 ClickHouse Cloud 账号里创建服务和用户。chdb 在你自己的 Python 进程里运行，chdb 技能能访问你指定的文件、URL 和数据库。详见 setup/what-each-skill-needs.md。

## 更新和卸载

infra 技能自己的说明是：用 clickhousectl update 更新命令行工具，用 clickhousectl skills 更新技能。README 没有给出卸载步骤。Claude Code 的技能页面说，删掉个人技能的文件夹就能移除它。

README.md  5 KB
setup/claude-code.md  3 KB
setup/clickhousectl.md  2 KB
setup/other-agents.md  2 KB
setup/what-each-skill-needs.md  4 KB