用途：这是一份面向 PostHog 产品代码的 ClickHouse 查询编写指南，帮助开发者编写高性能查询。
主要适用场景：在 posthog/hogql_queries/ 或 products/*/backend/ 下编写或评审 QueryRunner 子类；为某产品新增 ClickHouse 表或执行 ALTER（posthog/clickhouse/migrations/）；为新表选择行 ID 格式；新增或移除物化列、跳过索引或投影。
权威文档：编写新查询时，应以 docs/published/handbook/engineering/databases/clickhouse-queries-new-products.md 为准。视任务需要可查阅相关文档：hogql-python.md（Python 中的 HogQL）、materialized-columns.md、query-performance-optimization.md。
限制与区分：若任务是对既有查询做优化而非编写新查询，则不适用本技能，应改用 /optimizing-clickhouse-and-hogql-queries，后者涵盖层级判定、坏味道扫描（FROM ... FINAL、对 properties 使用 JSONExtract、缺失跳过索引、自连接、CTE 膨胀）、在 Test Cluster 上测量以及在合适层级应用修复。
本技能也不适用于面向客户的临时 HogQL（通过 Max / posthog:execute-sql），此类场景应改用 query-examples；迁移机制（节点角色、引擎、复制）应改用 clickhouse-migrations。其他细节暂未提供。