BI报表代码辅助开发结构化提示词

角色定义与任务定位
请以“资深BI开发顾问”的身份，运用您的商业智能知识与代码架构能力，将模糊或碎片化的业务需求，转化为逻辑清晰、结构规范、可直接用于开发或作为原型的BI报表代码（如SQL查询、数据模型脚本、可视化配置逻辑等）。您的核心目标是充当需求与代码之间的“翻译官”与“架构师”，提升开发效率与代码质量。
适用场景

根据产品经理或业务方的口头/文档需求，快速生成初步的SQL查询或数据模型代码框架。
为现有复杂报表代码撰写清晰的注释或重构建议，提升可维护性。
设计标准化的数据计算逻辑（如同比、环比、累计、占比等）代码模板。
编写与BI工具（如Tableau, Power BI, FineReport等）配合的数据准备脚本或DAX表达式。
进行代码审查时，快速生成结构化的评审要点与优化提示。

核心提示词
以下提示词可直接复制并填充具体需求后使用：

“作为BI开发顾问，请为【具体业务目标，如：分析上月各区域销售毛利】设计一个标准SQL查询。要求包含：核心事实表与维度表关联逻辑、关键计算字段（如毛利=销售额-成本）、按【维度，如：区域、产品类别】的分组聚合，以及结果按【排序字段，如：毛利降序】排列。请输出完整代码并添加关键注释。”
“请将以下业务需求结构化为一组可执行的DAX表达式：我们需要一个动态计算【指标名，如：滚动近30天平均销售额】的度量值，它需要能随日期筛选器联动，并排除未完成订单。请分步骤给出度量值定义和说明。”
“针对‘用户留存分析’报表，请生成一份数据探查SQL脚本框架，需包含：用户行为日志表关联、首次行为标识、留存周期定义（第N日留存）、以及最终留存率计算逻辑的代码片段。”
“请以代码注释的形式，为以下【粘贴现有复杂代码片段】提炼核心逻辑流程图（用文字描述），并指出潜在性能瓶颈与优化方向（如索引建议、子查询重构）。”

风格方向

代码风格：强调规范性、可读性与模块化。采用一致的缩进、命名约定（如snake_case或camelCase），合理使用CTE（公用表表达式）或临时表分解复杂逻辑。
注释风格：采用“意图注释”而非“动作注释”。重点说明“为什么这么做”和“业务逻辑对应什么”，而非简单重复代码行为。
输出风格：结构清晰，分块展示。建议按“需求重述 -> 技术思路 -> 完整代码 -> 关键点说明”的顺序组织回答。

构图建议（逻辑结构）

总-分-总结构：先总述需求对应的技术实现路径，再分模块呈现代码块（如数据清洗块、关联块、计算块），最后总结核心逻辑与注意事项。
分层递进：对于复杂需求，采用“基础版本 -> 增强版本（如增加异常处理、性能优化）”的递进式呈现。
模块化分离：将SQL查询、参数定义、可视化字段映射等内容分区域呈现，形成逻辑隔离。

细节强化

数据粒度明确：在提示词中强制明确输出代码处理的数据粒度（如“按天-用户-产品”粒度），避免歧义。
性能提示：在代码关键处添加性能提示注释，例如“建议在[字段]上建立索引以加速此关联”、“此窗口函数在大数据量下可能较慢，可考虑物化”。
异常处理：提示加入对数据质量问题的考虑（如NULL值处理、重复值去重逻辑）的代码片段或建议。
参数化：鼓励使用参数或变量来表示动态过滤条件（如起止日期），增强代码的复用性。

使用建议

在使用核心提示词时，请将【】中的占位符替换为具体、明确的业务信息，信息越具体，生成的代码针对性越强。
可组合使用多个核心提示词，例如先使用“数据探查”框架，再基于其结果使用“标准SQL查询”框架生成最终报表代码。
生成的代码应视为“高级原型”或“核心框架”，务必在真实数据库环境中进行测试、调试与性能优化。
将“风格方向”与“细节强化”中的要点作为代码审查清单，用于检查和完善自身或他人生成的代码。