用途:该技能用于 BigQuery Dataform 的各类开发工作,包括新建或修改 SQLX 转换、添加源声明、排查管道问题,以及看似简单的临时报表。它把安全实践与合理架构视为不可选项,并基于 superpowers:test-driven-development 的 TDD 原则适配 SQLX。
主要能力与规则:测试必须使用 --schema-suffix dev,执行前先 --dry-run,再正式运行;外部表先写 declaration 源声明,再用 ${ref()} 引用,禁止硬编码表路径;ref() 默认单参数,需要固定 schema 时用双参数;用 bq query 做基础校验。架构上采用 sources/intermediate/output 分层,避免输出层单体查询。增量表用 type: "incremental"、uniqueKey 数组、partitionBy/clusterBy,配合 incremental() 与 ${self()} 写增量条件,pre_operations/post_operations 包裹一次性 DDL。断言支持 uniqueKey、nonNull、rowConditions。新源声明必须用 .sqlx 并写 columns 文档;operations 与 test 文件不得写 schema。TDD 流程为:先写断言并运行至失败,再写最小实现使其通过,最后重构。
使用方式:按资料中的命令执行,如 dataform compile、dataform run --schema-suffix dev --dry-run --actions table_name、dataform run --schema-suffix dev --run-tests --actions assert_customer_metrics,生产部署仅在开发测试通过后进行。
适用场景与限制:适用于 BigQuery Dataform;PostgreSQL/Supabase 应改用 sqlanvil-engineering-fundamentals。时间压力下仍须遵守 dev 测试、dry-run、源声明、columns 文档与测试先行,仅可跳过独立文档、同行评审与性能优化,并需以 technical_debt 标记 TODO。排障建议使用 systematic-debugging 与 root-cause-tracing。官方文档见 https://cloud.google.com/dataform/docs 与仓库最佳实践页面。其他细节暂未提供。