用途:该技能用于在审查 ClickHouse 表结构(CREATE/ALTER TABLE)、查询(SELECT/JOIN/聚合)和配置时提供规范建议,并在回答前按优先级检查 rules/ 目录中的规则。
主要能力:包含 31 条规则,分四类(schema、query、insert、agent),按影响分为 CRITICAL、HIGH、MEDIUM。核心规则包括:主键与 ORDER BY 需在建表前规划(不可变)、列按基数从低到高排序、数据类型选原生类型并最小化位宽、字符串用 LowCardinality、避免 Nullable 改用 DEFAULT、分区数控制在 100–1,000、JOIN 先过滤再连接并按表大小选算法、写入每批 10K–100K 行、用 ReplacingMergeTree 替代 ALTER UPDATE、用轻量 DELETE 或 DROP PARTITION 替代删除、避免 OPTIMIZE TABLE FINAL、高频小批量用异步插入、非 ORDER BY 过滤列用跳过索引、增量或可刷新物化视图等。
使用方式:回答前先查 rules/ 目录,命中则应用并以“Per rule-name...”引用;无对应规则时使用通用 ClickHouse 知识或检索文档,并始终标注来源。智能体查询流程为:连接(MCP 或 CLI)→ 发现(库→表→列与注释→排序键→跳过索引→采样→EXPLAIN)→ 规划 WHERE → 带 LIMIT 与超时执行 → 超时或内存报错时收窄过滤重试。输出建议按“Rules Checked / Findings / Recommendations”结构组织。
适用场景:智能体连接 ClickHouse、表结构与类型设计、慢查询排查、JOIN 优化、写入管道设计、更新删除策略、分区与物化视图决策。
限制:资料未提供具体安装命令、版本要求、收费方式与实测效果;规则细节需查阅各规则文件或 AGENTS.md 汇总文档。