用途
该技能让助手扮演基于 ClickHouse 的交互式数据分析师。它并非直接运行第一个想到的查询，而是先弄清用户真正的问题，再用正确且有边界的查询回答，并报告数字背后的定义与注意事项。适用于用户询问内部数据、指标、仪表盘、遥测等问题。
主要能力
- 以“意图块”（Intent block）作为任何数据请求的第一段输出，逐项标注指标、人群、时间窗口、粒度、过滤条件和输出形式，并区分为已确认、假设、需用户提供或需查词典。
- 先解析业务与产品术语到具体模型、列和指标定义，再执行查询。
- 运行安全 SQL：连接 ClickHouse Cloud 时使用配置的直接 Query API 端点与按用户凭据（CH_API_KEY / CH_API_SECRET）；本地或 host/port 服务器使用 clickhousectl local client。不使用 ClickHouse MCP 工具。
- 将查询结果分析为趋势、对比、分布、漏斗、合理性检查和可直接用于报告的结论。
- 按需生成图表或可视化产物，并将 CSV、图表和报告资产保存到稳定位置并报告路径。
- 自带若干官方 ClickHouse 子技能，覆盖最佳实践、在本地文件/S3/远程数据库上以 chdb 运行 SQL、pandas 风格 API、本地开发环境搭建等。
使用方式
技能内包含多个子技能目录，按当前步骤只加载所需子技能并遵循其 SKILL.md。典型工作流为：先输出意图块并标记需用户澄清或需查词典的字段；验证连接；针对性地解析术语定义并向用户确认；依据确认后的意图块编写并运行 SQL；分析结果；按需创建并保存图表与报告资产。若出现新的歧义，或在数据不完整、含义不明时用户要下结论或要报告，则回到意图块重新确认。
适用场景
适合需要针对 ClickHouse 内数据回答指标问题的分析工作，尤其是首次请求往往描述不充分、需要先澄清指标定义、人群、时间窗口与粒度的场景，以及需要对查询结果做趋势、对比、分布、漏斗分析和产出图表、CSV、报告的场合。
限制
该技能明确禁止使用 ClickHouse MCP 工具（如 mcp-clickhouse__run_query、mcp-clickhouse__list_databases、mcp-clickhouse__list_tables 等），即使环境中可用也应忽略。对 ClickHouse Cloud 分析不使用 clickhousectl cloud service query，因为它依赖本地 service-query-key 状态并可能自动创建密钥。执行昂贵、无界、长时间或高基数查询前需先征得用户同意；不得在未检查覆盖范围、上线日期、数据新鲜度和选择性加入等注意事项的情况下暗示数据完整；不得在对话中回显凭据或密钥。关于具体价格、平台支持范围、效果等资料暂未提供。