前言¶

寫 ClickHouse 的人多半遇到過兩件事：一是表建得不對，列類型、分區鍵、排序鍵選錯，數據一進來查詢就慢；二是查詢本身寫法有問題，全表掃描、缺少合適的聚合粒度，跑一次要等很久，卻不知道該從哪下手改。

這類問題沒有通用的排查套路，而 SkillHub 上的 ClickHouse Analytics Patterns 正是爲此準備的。它不提供運行時能力，而是在你寫 schema、寫查詢或優化慢查詢時給出一套可參照的工程實踐清單。

下面介紹這個 Skill 的定位、已知信息和用法。

這是什麼¶

ClickHouse Analytics Patterns 是一個面向 ClickHouse 分析型負載的 Skill，覆蓋數據庫模式設計、查詢優化、分析建模和數據工程最佳實踐。它由 SkillHub 上的發佈者 RealQ 維護，座標 @org-eyw2ohcx/affaan-m-ecc-clickhouse-io，當前版本 1.0.0，來源標記爲 enterprise，分類爲 data-analysis。

官方簡介寫得很明確：當你在寫 ClickHouse schema 或查詢，或者某個分析查詢太慢時使用它。也就是說，它的作用是把”該考慮哪些東西”顯式化，而不是替代你寫 SQL。

核心功能¶

根據官方簡介，這個 Skill 的能力範圍集中在四個方面：

1、ClickHouse database patterns，即建表時的模式選擇，包括列類型、分區與排序鍵的組合方式。
2、Query optimization，面向慢查詢的優化思路。
3、Analytics，分析場景的建模與查詢組織方式。
4、Data engineering best practices，面向高性能分析型負載的數據工程實踐。

需要說明的是，SkillHub 頁面當前無法訪問，因此以上能力描述以預抓取到的官方簡介爲準，Skill 內部的具體章節結構和示例內容未能覈實。

安裝與啓用¶

這個 Skill 基於通用 SKILL.md 格式，在支持該格式的 Agent 工具中按座標加載即可，標籤顯示 requires_api_key=false，即不需要額外配置 API Key。

已覈實的信息如下：

SkillHub 頁面: https://www.skillhub.cn/skills/org-eyw2ohcx/affaan-m-ecc-clickhouse-io
API 地址:     https://api.skillhub.cn/org-eyw2ohcx/affaan-m-ecc-clickhouse-io
座標:         @org-eyw2ohcx/affaan-m-ecc-clickhouse-io
版本:         1.0.0

具體的安裝命令、Skill 存放目錄以及在 Cursor、Codex CLI、Claude Code 中的差異，資料中沒有給出，本次抓取官方頁面也失敗了，因此不在這裏編造。啓用方式請以打開上述頁面後看到的實際說明爲準。

典型用法¶

這個 Skill 的觸發條件寫在簡介裏，實際使用方式就是讓它參與你正在做的事：

1、寫 ClickHouse schema 之前，先讓它過一遍模式設計，看列類型、分區鍵和排序鍵是否匹配你的查詢模式。
2、寫查詢時，讓它檢查是否存在全表掃描、聚合粒度是否合理等常見優化點。
3、遇到跑得慢的分析查詢，把查詢和表結構一起交給它，按優化清單逐項排查。

沒有需要你手工執行的命令或腳本。它屬於知識型 Skill，價值在於約束和提示，最終的 SQL 和建表語句仍由你決定和驗證。

適用場景與注意¶

適合使用的人：日常維護 ClickHouse 表結構、寫分析查詢、或者負責把慢查詢優化下來的工程師和數據工程師。如果你的項目用其他列式存儲或關係型數據庫，它給出的建議不一定適用。

需要注意的幾點：

1、Skill 內的具體規則和示例未能從公開頁面覈實，使用前請打開官方頁面確認內容是否與你使用的 ClickHouse 版本匹配。
2、它不提供運行時校驗，也不會自動改你的表結構，優化結果需要在測試庫上驗證後再上線。
3、SkillHub 顯示安裝量爲 0、評分爲 100000，下載量爲 787。評分爲全量滿分口徑，不代表真實用戶評價；下載量不高，實際使用反饋樣本很少，建議當作參考清單而非權威規範。

結尾¶

ClickHouse Analytics Patterns 的價值在於把分析型負載裏容易踩的坑提前列出來，適合在建表和寫查詢這兩個環節用上。它的能力範圍就是查詢優化與模式設計，不涉及運行時組件。

官方地址：https://www.skillhub.cn/skills/org-eyw2ohcx/affaan-m-ecc-clickhouse-io