用途:SQL Review 是一个合并前的 SQL 质量门禁技能,面向需要在提交或 PR 前审查 SQL 质量的用户,可对查询或模型给出 A-F 质量评级,并在一次调用中完成 lint、安全检查与语法校验,也支持对目录内 SQL 文件做反模式审计。
主要能力:调用 altimate_core_check 完成综合检查,覆盖语法校验(含行/列位置解析错误)、26 项反模式 lint(如 SELECT *、未使用 CTE、隐式转换、NULL 比较、DELETE/UPDATE 缺少 WHERE、笛卡尔连接、非 sargable 谓词、缺少分区过滤等)、注入扫描(重言式、UNION 注入、堆叠查询、注释注入、Jinja 模板注入)与 PII 暴露标记;调用 altimate_core_grade 获得 A-F 评分及可读性、性能、正确性、最佳实践分项;调用 sql_analyze 获得带严重级别和具体建议的反模式明细。
使用方式:需 Agent 为任意(只读分析),使用工具 altimate_core_check、altimate_core_grade、sql_analyze、read、glob、bash(用于 git 操作)。可从文件路径读取 SQL、接收对话中的 SQL,或用 git diff --name-only HEAD~1 | grep '.sql$' 自动检测变更的 SQL 文件;dbt 模型可先执行 altimate-dbt compile --model <name> 编译出完整 SQL。用法示例:/sql-review models/marts/fct_orders.sql 审查指定文件;/sql-review 审查当前 git diff 中所有变更 SQL;/sql-review --all models/ 审查目录下全部 SQL。批量审查时先逐文件检查,再输出包含文件、等级、问题数、安全性与结论的汇总表。
适用场景与限制:适合 PR 合并前审查、查询或模型质量评级、单次综合 lint 与安全检查、目录级反模式审计。不适用于查询性能优化(应使用 query-optimize)、修复损坏 SQL(应使用 dbt-troubleshoot)或方言互译(应使用 sql-translate)。评分明细、阈值与具体规则的更多细节暂未提供。