SuperAPI AI 工具集

clickhouse-architecture-advisor

设计与创作

查看项目

更新于 10-15 19:49

技能介绍

用途:该技能用于设计 ClickHouse 架构、在摄取与建模模式之间做选择,并把最佳实践转化为针对具体工作负载的系统建议。官方文档始终是权威来源,技能要求优先采用官方 ClickHouse 文档。

主要能力:先识别工作负载形态(可观测性、安全/SIEM、产品分析、IoT/遥测、市场数据/金融、混合 OLAP 与点查),再读取 rules/ 下相关决策规则文件,并通过 mappings/doc_links.yaml 关联官方文档。每条建议需分类为 official(官方文档直接支持)、derived(未逐字写明但可由文档行为逻辑推导)或 field(经验性、情境化)。field 类建议须附启发式免责声明、部分适用的官方文档及依赖工作负载上下文的原因;不确定时须明确说明。

使用方式:按场景读取规则文件——实时摄取设计读 rules/decision-ingestion-strategy.md 与 rules/decision-real-time-preaggregation.md;时序与保留设计读 rules/decision-partitioning-timeseries.md;关联与维度查找读 rules/decision-join-enrichment.md;可变状态/迟到事件读 rules/decision-late-arriving-upserts.md。输出按固定结构:Workload Summary(工作负载、延迟目标、数据形态、主要查询模式、运维约束)、Key Decisions、Recommendations(每条含 What、Why、How、Category、Confidence、Source、Validation)。

适用场景:需要权衡取舍、识别可能运行瓶颈、区分即时动作与结构性重构,并给出目标架构模式而非孤立配置项的设计任务。

限制:资料未提供具体安装命令、收费方式、支持平台或效果数据;完整参考见 AGENTS.md,示例输出见 examples/。