设计 ClickHouse 架构或选择摄取/建模模式时…

在 ClickHouse 架构设计、摄取或建模模式选择时，按工作负载读取规则、给出带官方/推导/经验标签的决策建议。

适用场景

解决思路

1. 在给出建议前，先识别工作负载形态，分类为 observability、security/SIEM、product analytics、IoT/telemetry、market data/financial services、mixed OLAP with point-lookups。
2. 阅读 rules/ 下与场景相关的决策规则文件。
3. 使用 mappings/doc_links.yaml 为建议附上官方文档链接。
4. 将每条建议分类为 official、derived 或 field。
5. 绝不把 field 指导呈现为 official 指导。
6. 如果某条建议不确定，明确说明不确定。
7. 判定 official：当建议直接由官方文档支持时使用。
8. 判定 derived：当文档未逐字说明，但可由 ClickHouse 已记录行为逻辑推导时使用。
9. 判定 field：仅用于可能依情况而定的经验型指导。
10. 使用 field 时，加入该建议是启发式的免责声明。
11. 使用 field 时，如果部分适用，附上相关官方文档。
12. 使用 field 时，说明该建议为何依赖工作负载上下文。
13. 实时摄取设计：阅读 rules/decision-ingestion-strategy.md。
14. 实时摄取设计：阅读 rules/decision-real-time-preaggregation.md。
15. 实时摄取设计：阅读相关 best-practices 插入规则。
16. 时序和保留设计：阅读 rules/decision-partitioning-timeseries.md。
17. 时序和保留设计：阅读相关 best-practices schema 分区规则。
18. 富化和维度查找：阅读 rules/decision-join-enrichment.md。
19. 富化和维度查找：阅读相关 best-practices 查询 join 规则。
20. 可变状态/迟到事件：阅读 rules/decision-late-arriving-upserts.md。
21. 可变状态/迟到事件：阅读相关 best-practices mutation avoidance 规则。
22. 输出结构：包含 ## Workload Summary，并填写 workload、latency target、data shape、primary query patterns、operational constraints。
23. 输出结构：包含 ## Key Decisions。
24. 输出结构：包含 ## Recommendations。
25. 每条建议使用 ### <Recommendation title> 标题。
26. 每条建议包含 **What**。
27. 每条建议包含 **Why**。
28. 每条建议包含 **How**。
29. 每条建议包含 **Category**：official | derived | field。
30. 每条建议包含 **Confidence**：high | medium | heuristic。
31. 每条建议包含 **Source**：doc link(s)。
32. 每条建议包含 **Validation**：具体 SQL、metric 或 smoke test。
33. 优先使用决策框架，而不是泛泛建议。
34. 解释权衡。
35. 识别可能的运行瓶颈。
36. 将立即行动与结构性重设计分开。
37. 提供目标架构模式，而不只是孤立设置。
38. 始终优先采用官方 ClickHouse 文档作为事实来源；如果可用，以官方文档为准。
39. 参考 AGENTS.md 获取编译版本，参考 examples/ 获取示例输出。

适用边界 · 注意事项

• 不适用于非 ClickHouse 架构设计，或不需要在摄取/建模模式间做架构决策的场景。
• 当无法读取技能中的 rules/ 和 mappings/doc_links.yaml，且无法进行官方来源标注时，不应套用其来源分类流程。
• 当已有官方 ClickHouse 文档能直接、完整回答且无需工作负载特定权衡时，不需要走完整顾问流程。