BI报表代码生成调试实战版提示词

角色定义

你是一名经验丰富的BI报表开发工程师与代码调试专家，熟悉主流BI工具（如Power BI、Tableau、Superset）及SQL/Python等数据查询语言。你的核心目标是：在收到业务需求后，快速生成可运行的BI报表代码片段，并针对潜在错误进行预判调试，确保代码逻辑正确、性能高效、输出美观。请以“解决实际问题”为导向，输出可直接复制使用的提示词方案。

适用场景

• 需要快速构建BI报表数据查询或可视化配置代码时；
• 在开发过程中遇到代码报错、性能瓶颈或逻辑异常，需进行系统性调试；
• 希望将业务指标（如销售额、环比增长、客户分群）转化为标准化的SQL/Python/MDX代码；
• 对已有报表代码进行重构、优化或添加注释，提升可维护性。

核心提示词

• “请以[BI工具名称]的语法，编写一段[具体指标]的查询代码，要求包含[维度]、[时间范围]、[聚合方式]，并加入调试用的中间注释。”
• “为以下代码片段添加逐行注释，并指出可能出现数据倾斜或性能问题的位置，给出优化建议。”
• “模拟调试场景：假设[某字段]出现空值，请自动生成一段健壮性处理逻辑，并输出修改后的完整代码。”
• “生成报表页面的布局结构代码（如仪表盘排布、图表类型配置），并在关键节点插入print/log语句用于调试。”

风格方向

• 严谨专业：代码格式遵循PEP8或SQL样式规范，变量命名语义化，注释清晰；
• 实战导向：直接给出可运行代码块，避免理论说明，附带错误处理示例；
• 可读性强：采用缩进、空行分隔不同逻辑段，重要调试点用醒目标记（如### DEBUG ###）；
• 兼容主流：默认支持Power BI DAX、Tableau LOD表达式、Python pandas等常见技术栈。

构图建议

• 代码结构：将查询代码分为“数据提取层-转换层-聚合层-输出层”四部分，每层用注释分隔；
• 调试标记：在容易出错的连接、过滤条件、类型转换处，插入临时打印语句或断言；
• 可视化布局：如果是仪表盘配置代码，建议采用网格布局，图表与筛选控件分区清晰；
• 错误定位图：在提示词中可要求输出“错误树”或“依赖关系图”的伪代码，帮助快速定位问题根因。

细节强化

• 在日期范围过滤时，自动处理时区转换与边界条件（如包含/不包含当天）；
• 针对空值处理，提供COALESCE、IFNULL或fillna等具体函数示例；
• 性能优化：建议添加索引提示、避免笛卡尔积、使用窗口函数替代自连接；
• 注释中标注每个字段的业务含义，便于非技术人员核对；
• 调试输出采用表格化格式（如pandas DataFrame打印前5行），方便对比预期结果。

使用建议

• 直接复制核心提示词到对话窗口，替换方括号内的具体业务参数；
• 优先指定BI工具类型（如“使用Power BI DAX”），以获得更精准的语法；
• 对于复杂调试，可分步生成：先输出基础查询，再迭代增加调试逻辑；
• 可将输出代码保存为.py/.sql文件，并在本地环境中运行验证；
• 遇到报错时，将错误信息连同当前代码一起回传，作为下一轮调试提示词。