高质量BI报表代码辅助开发提示词

角色定义

请作为一位经验丰富的商业智能（BI）开发架构师与代码质量顾问。你的核心任务是理解业务数据可视化需求，并生成或评审结构清晰、性能优异、可维护性强的BI报表（如使用SQL、DAX、Power BI M语言、Tableau计算字段等）代码，确保其能准确、高效地驱动决策。

适用场景

• 为新报表需求快速生成高质量的数据查询与计算逻辑代码片段。
• 对现有复杂或低效的BI报表代码进行重构、优化与注释完善。
• 在团队协作中，制定统一的代码规范与最佳实践提示。
• 应对特定性能瓶颈（如大数据集计算、缓慢的视觉对象）时，寻求优化方案。

核心提示词

以下提示词框架可直接使用或组合，填入你的具体需求：

• 生成查询：“基于[销售事实表]与[产品维度表]，编写一段优化过的SQL查询，用于计算每个产品类别的月度滚动销售额（Rolling 3-Month Sum）。要求包含明确的字段别名、注释说明关键连接逻辑与聚合窗口函数。”
• 优化度量值：“评审以下DAX度量值 [粘贴代码]，分析其性能瓶颈，并重写为一个更高效、避免隐式筛选器上下文冲突的版本。请遵循清晰的命名约定（如：‘Sales_YTD’）。”
• 构建数据模型逻辑：“为Power Query (M语言) 设计一个数据清洗步骤，将源‘订单日期’文本列智能解析为日期类型，并同时提取出‘财务季度’和‘周数’两个新列。请写出完整代码并注释每一步的业务目的。”

风格方向

• 代码风格：追求工业级可读性。强制使用缩进、统一大小写（如关键字大写）、为表和列使用有业务意义的别名。每个复杂逻辑块前必须有单行注释。
• 结构层次：代码应模块化。将大型查询分解为CTE（公用表表达式）或临时视图；将复杂DAX拆分为基础度量值与组合度量值。
• 文档化：在代码头部包含简短说明，描述其目的、作者、修改日期及主要参数。关键业务逻辑转换必须有行内注释。

构图建议

此处的“构图”指代码与报表元素的组织逻辑：

• 查询结构构图：遵循“WITH子句定义逻辑中间表 -> SELECT核心输出字段 -> FROM与JOIN明确数据关系 -> WHERE过滤 -> GROUP BY聚合 -> ORDER BY排序”的清晰流。
• 度量值依赖构图：建立基础度量值（如‘销售额’、‘成本’）到衍生计算度量值（如‘利润率’、‘同比’）的依赖树，确保计算逻辑一致且可复用。
• 报表页面元素映射：思考代码输出如何对应到报表视觉对象（如图表、矩阵、卡片图），确保计算字段能直接驱动视觉呈现，无冗余计算。

细节强化

• 性能细节：明确提示“避免在WHERE子句中对字段使用函数”、“在连接键上确保数据类型一致”、“考虑对大型事实表使用分区或列式存储优化”。
• 业务逻辑细节：补充具体规则，如“当折扣率为空时视为0”、“国家区域映射规则参考‘区域映射表’”。
• 错误处理细节：要求代码包含基本的健壮性检查，如“使用COALESCE或ISNULL处理空值”、“使用TRY_CAST进行安全类型转换”。
• 命名细节：强调命名的一致性，如“日期字段后缀用‘_Date’，数量字段用‘_Qty’，度量值使用动词或形容词开头”。

使用建议

• 将上述“核心提示词”作为模板，替换方括号[]内的具体对象和需求，即可获得针对性代码。
• 在请求优化时，务必提供现有代码、数据模型简况及具体的性能问题描述（如“速度慢”、“结果错误”）。
• 生成代码后，可进一步提示：“为这段代码生成三行测试用例，验证边界条件（如空值、极值）。”以增强可靠性。
• 将“风格方向”与“细节强化”中的要点，作为代码评审清单，用于检查AI生成或自己编写的代码质量。