用途:在评审 ClickHouse 的 schema、SQL 查询或配置时,按优先级检查规则并给出可引用来源的建议。资料称其含 28 条原子规则,分 schema、query、insert 三类,另附 14 个参考文件,涵盖集群管理、备份、监控与集成。
主要能力:规则前缀与数量为 schema-pk-(4)、schema-types-(5)、schema-partition-(4)、schema-json-(1)、query-join-(5)、query-index-(1)、query-mv-(2)、insert-batch-(1)、insert-mutation-(2)、insert-async-(2)、insert-optimize-(1)。评审顺序为先查 rules/,再查 references/,否则用通用知识或查文档,并需标注来源(规则名、参考文件或 URL)。表结构评审关注主键/ORDER BY 顺序(低到高基数,且不可变)、类型匹配、LowCardinality、分区基数(100–1,000)、ReplacingMergeTree 版本列;查询评审关注 JOIN 算法、ANY JOIN、先过滤后连接、字典/反规范化、跳过索引、增量与可刷新物化视图;写入评审关注每批 10K–100K 行、异步写入、Native 格式、避免 ALTER UPDATE/DELETE 与 OPTIMIZE TABLE FINAL。输出格式为规则检查、发现(违规/合规)、建议三段。
使用方式与限制:资料未提供安装命令或具体调用步骤,仅说明版本 1.3.0、规则与 ClickHouse/agent-skills 同步(Apache-2.0)、参考 Altinity 知识库与官方文档。文档中示例口令为占位符,生产环境应使用环境变量、密钥管理器或 Kubernetes Secret 等管理凭据;安装与运维应优先包管理器并使用固定版本,先在非生产环境验证。