用途：面向 SQL 数据分析场景，覆盖业务指标查询（GMV / DAU / 转化率）、漏斗分析、留存分析（N 日留存）、同比环比、窗口函数（排名 / 累计 / 移动平均）以及 CTE 递归（层级 / 链路）。
核心原则：先明确问题再写 SQL；用 CTE 分步骤以提升可读性；注意时区和日期边界；排除测试数据与异常值；大表注意性能（索引 / 分区）；结果必须可解释。
常用模式：漏斗分析用 CTE 聚合各步骤去重用户数并计算相邻步骤转化率；N 日留存先取每个用户首次日期，再按 day_n 聚合，用条件聚合输出 d0、d1、d7、d30；窗口函数可做排名（RANK() OVER）、累计（SUM() OVER）和 7 日移动平均（ROWS BETWEEN 6 PRECEDING AND CURRENT ROW）。
配套模板：templates/sql-analysis-template.md 为 SQL 分析记录模板。
质量自检：问题明确、数据源正确、时区处理、排除异常、性能可接受、结果可解释、CTE 可读。
常见坑：时区不一致（UTC 与 Local 差 8 小时）、不排除测试数据导致指标失真、COUNT 与 COUNT DISTINCT 去重遗漏、NULL 参与计算造成偏差、大表全扫导致超时。
协作关系：上游 metric-design 提供指标定义；下游 data-visualization 做图表展示，analysis-report 纳入报告。
限制：资料未提供具体数据库方言、执行环境、安装方式或收费信息。