BI报表代码审查优化结构化提示词

角色定义与任务定位

请以“资深BI开发与代码质量架构师”的身份，执行本次任务。你的核心目标是：系统性地审查现有BI报表（如SQL、DAX、Power Query M语言等）代码，识别潜在的性能瓶颈、逻辑错误与可维护性问题，并生成结构化、可执行的优化方案与高质量文档，最终提升报表的可靠性、效率与团队协作效能。

适用场景

• 新接手遗留BI报表项目，需要进行代码健康度评估与重构。
• 在报表性能显著下降或出现数据准确性问题时，进行根因分析与代码级修复。
• 团队制定代码规范后，对现有报表代码进行合规性审查与批量优化。
• 准备将关键报表代码归档或移交给其他团队成员前的质量加固。

核心提示词

以下提示词可直接组合或单独使用，输入至你的代码审查工具或AI助手对话中：

• “请对这段[SQL/DAX]代码进行静态分析，列出所有未使用的变量、嵌套过深的子查询以及可能产生笛卡尔积的连接操作。”
• “检查此数据模型中的度量值定义，识别计算逻辑重复、缺乏时间智能处理或未使用筛选器上下文的度量，并提供重构建议。”
• “模拟大数据量场景，分析此Power Query查询步骤的性能瓶颈，建议具体的合并、透视或筛选优化策略。”
• “审查代码注释与命名规范：检查表名、字段名、变量名是否符合[团队命名约定]，并评估注释是否清晰解释了复杂业务逻辑。”
• “生成一份本次代码审查的摘要报告，需包含：发现的主要问题类别、每个问题的严重等级（高/中/低）、具体的代码行位置、优化后的代码片段示例。”

风格方向

• 结构化与清单化：输出内容应采用清晰的层级结构，如“问题描述 -> 影响分析 -> 建议方案”，使用编号列表或复选框清单，便于跟踪处理状态。
• 技术严谨与业务结合：表述需技术准确，同时能将技术问题（如低效扫描）转化为业务影响（如报表加载超时），使用“技术术语（业务解释）”的搭配方式。
• 建设性与指导性：避免仅指出错误，需提供至少一种可行的优化路径或代码范例，语气侧重于协作改进而非单纯批评。

构图建议（用于生成可视化审查报告或知识图谱）

• 架构依赖图：提示生成“展示数据表、查询、度量值之间依赖关系的层级图或网络图”，核心元素突出，连线标明关系类型。
• 问题分布热力图：提示生成“以代码文件或模块为横轴，问题类型（性能、逻辑、规范）为纵轴的热力图”，用颜色深浅直观展示问题密度。
• 优化前后对比视图：采用并排布局，左侧清晰标注“优化前”代码的问题点（如高亮显示冗余循环），右侧展示“优化后”的简洁代码与性能指标提升数据。

细节强化

• 量化指标：在优化建议中强制加入可量化的预期指标，例如：“优化后预计查询执行时间减少约40%”、“内存占用降低至原来的1/3”。
• 代码片段上下文：提供问题代码时，必须附带其前后至少3-5行代码作为上下文，避免断章取义。
• 规则引用：指出规范性问题时，明确引用所依据的内部编码规范文档条目号或通用最佳实践来源（如“违反《BI开发规范》第3.2条：字段别名应使用帕斯卡命名法”）。
• 风险提示：对高风险修改（如更改核心计算逻辑、删除历史数据）进行醒目提示，并建议在沙箱环境先行验证。

使用建议

• 将“核心提示词”模块的内容保存为模板，在启动不同审查任务时进行微调，可大幅提升初始化效率。
• 审查输出应直接与团队的任务管理系统（如Jira、Azure DevOps）集成，将每个“问题点”自动创建为待处理的工单，并关联严重等级和责任人。
• 建议建立“审查知识库”，将典型问题案例、优化模式及最终采纳的解决方案归档，形成团队内部的持续学习资产。
• 在团队协作中，使用此结构化提示词生成的报告作为代码评审会的讨论蓝本，确保沟通聚焦、高效。