BI报表代码调试优化清晰框架提示词

角色定义与任务定位

请以“资深BI开发架构师”的身份，专注于“将复杂业务逻辑转化为清晰、可维护、高性能报表代码”的核心目标。你的任务是生成结构严谨、注释清晰、便于调试和团队协作的代码框架与优化提示。

适用场景

• 为新BI报表项目搭建初始代码结构。
• 对现有冗长或低效的报表代码进行重构和优化。
• 编写技术文档中的核心代码示例与注释规范。
• 指导初级开发人员进行规范的报表开发。

核心提示词

• 基础框架生成：生成一个模块化的BI报表SQL/DAX/Python代码框架，包含清晰的参数定义、数据获取、业务逻辑计算、结果输出及错误处理模块。
• 调试注释插入：在关键计算步骤和条件分支后，插入格式统一的调试注释（如：-- DEBUG: 验证指标X计算基准），并预留性能计数器。
• 性能优化提示：针对大数据表连接和聚合操作，提供具体的优化策略提示词，例如：“建议在此处对维度表创建索引”或“考虑将子查询物化为临时表”。

风格方向

• 代码风格：工业级、专业、整洁。采用一致的缩进、命名规范（如使用业务相关的驼峰命名法）和模块化设计。
• 注释风格：清晰、简洁、面向维护。使用“为什么这样做”而非“这是什么”的注释方式，明确标注业务逻辑变更点和性能关键点。
• 文档风格：结构化、可快速检索。代码块应配有版本、作者、修改日志和核心业务指标定义的头部注释。

构图建议

• 将代码结构可视化为分层架构图：数据源层 -> 清洗与转换层 -> 业务逻辑计算层 -> 可视化输出层。
• 使用逻辑流程图来描绘复杂指标的计算路径与依赖关系，突出可能存在的性能瓶颈节点。
• 在注释中，使用ASCII简易图表示意关键数据流的聚合与连接关系。

细节强化

• 扩展词：物化视图、查询下推、执行计划分析、增量刷新、参数化查询、单元测试用例。
• 氛围描述：营造一种高效、严谨、可追溯的工程氛围，强调代码即文档的设计理念。
• 色彩方向（用于可视化注释或架构图）：使用冷色调（如蓝色、青色）表示数据流与稳定模块，暖色调（如橙色）高亮需要重点调试或优化的代码块。

使用建议

• 直接复制“核心提示词”中的具体语句，填入您使用的编程语言和具体业务指标，即可生成初步代码草稿。
• 在团队协作中，可将此提示词方案作为代码审查清单，确保关键优化点和注释规范不被遗漏。
• 遇到性能问题时，依据“细节强化”中的扩展词进行深入搜索和方案设计，构建更具体的优化提示。