ClickHouse Architect 技能：按查询形状选择 MergeTree 排序键
EnglishClaude Code 安装步骤
- 从 GitHub 固定提交获取完整的 `plugins/quality-tools/skills/clickhouse-architect` 目录。
- 复制到目标项目的 `.claude/skills/`，确认 `.claude/skills/clickhouse-architect/SKILL.md`，再从项目根目录启动 Claude Code，输入 `/clickhouse-architect`。
中文摘要
让 Claude Code 从常见过滤条件、数据规模和字段含义设计 ClickHouse 表，保留排序键和样例查询证据。
SKILL.md 中文导读
可复现示例
为 synthetic_events 放入站点 A 和 B 的测试事件。用 (site_id, occurred_at) 作为排序键，查询 A 在指定 UTC 日期的事件数并查看计划。工作步骤
- 列出最常见的按站点和日期筛选。设计与查询顺序相配的 ORDER BY，并记录字段注释。
- 用少量数据复核查询结果，在更大合成数据上查看 EXPLAIN 索引信息与读取量。
验收方法
查询只计 A 对应日期的行。设计记录解释排序键、使用范围和实际验证方式。
GitHub 原文 · 更新日期
适用环境
准备自己的本地 ClickHouse 测试实例和合成浏览事件。只使用虚构站点和时间。
常见问题
排序键需要与唯一主键一样吗？
ClickHouse MergeTree 排序键主要服务物理组织和查询。明确记录唯一性需求，再选合适实现。