用途:对目标 ClickHouse 集群做一次系统性剖析,产出一份可持久保存的“分析师”知识库型 Skill,而不是零散查询助手或通用 ClickHouse 教程。产物为 <cluster-name>-analyst/ 文件夹,含 6 个 markdown 文件:SKILL.md(常加载入口,含概览、Top-15 表、join 图、引擎惯用法、时效)、catalog.md(约 15–25 张热点表卡片)、patterns.md(查询写作先验)、pipeline.md(入库链路与被降级基础设施表)、glossary.md(命名、用户、CH 特性)、README.md(来源、决策、限制、再生成与验证日志),总量约 5k–10k 词,可通过问卷选 concise 或 full。
主要能力:经 MCP execute_query(或等价只读工具)采样,检测 CH 版本桶、query_log 形态(原始或预聚合)、Distributed 命名约定、簇拓扑、库清单、引擎分布、查询日志跨度;挖掘 Top-50 热查询、共现、热点列;按引擎而非库名分类 Dim/Fact/Mart/Staging/Other;对每条非平凡断言做验证——存在性用 system.tables/system.columns,行为用 EXPLAIN indexes=1 加 log_queries 探针并嵌入实测数字,关系断言一律标注 [inferred] 并附基数探针。
必要用法:按 Phase 0–8 顺序执行,Phase 1.5 做原型路由并在 Phase 2 向用户提问确认库范围、窗口、集群名与验证租户,Phase 7 后确认分类再合成。每次阻塞式阶段向用户输出一行进度。连接异常最多重试 3 次,失败须询问用户,不得另开连接通道。
限制:严格只读,仅 SELECT、SHOW、DESCRIBE、EXPLAIN,禁止任何写操作;query_log 文本须经 normalizeQuery() 并去除注释、不得出现字面值、邮箱、IP、用户 ID 或注释元数据,示例 SQL 使用占位符。仅适用于 ClickHouse,不适用于 PostgreSQL、MySQL、BigQuery、Snowflake;一次性查询、单表调试、非 ClickHouse 目标不激活。系统表为空、列在当前版本不存在或查询日志无业务流量时须显式说明,不得编造。部分细节(如具体费用、官方文档)暂未提供。