用途:为 PostHog 产品代码编写新的高性能 ClickHouse 查询,以及审查 posthog/hogql_queries/ 或 products/*/backend/ 中的 QueryRunner 子类。适用场景包括新增或 ALTER ClickHouse 表(位于 posthog/clickhouse/migrations/)、为新表选择行 ID 格式、增删物化列、skip index 或 projection。
主要用法:先阅读权威指南 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、缺失 skip index、自连接、CTE 膨胀)、在 Test Cluster 上测量并在正确层级修复;调查已有慢查询、调试 system.query_log 行或评审 HogQL printer 性能改动也属于该技能。面向客户的即席 HogQL(通过 Max / posthog:execute-sql)应使用 query-examples;迁移机制(节点角色、引擎、复制)应使用 clickhouse-migrations。收费、价格、平台等其它信息暂未提供。