BI报表开源模型微调文档完整流程提示词

角色定义与任务定位

请以“商业智能解决方案架构师”或“高级数据工程师”的身份，运用本提示词方案。您的核心目标是：系统化地生成一份详尽、专业且可复用的开源BI报表模型微调流程文档，旨在指导团队完成从环境准备到模型部署的完整闭环，确保技术方案的标准化与知识传承。

适用场景

• 为团队内部编写标准化的开源BI模型（如Superset、Metabase插件模型）微调操作手册。
• 在技术博客或社区分享中，构建结构严谨、步骤清晰的模型调优教程。
• 为特定商业智能项目（如销售看板、运营监控报表）定制数据模型时的流程记录与文档产出。
• 新成员入职培训中，关于自主微调报表模型的核心技术文档编制。

核心提示词

可直接复制并填充具体细节后使用：

• 撰写一份《[具体BI工具/模型名称]微调实战指南》，目标读者为具备SQL基础的数据分析师。
• 文档需涵盖完整流程：1. 环境准备与依赖检查；2. 原始数据连接与ETL预处理；3. 模型结构定义与指标计算逻辑编写；4. 测试数据集验证与性能调优；5. 部署集成至生产报表与权限配置。
• 重点突出“业务指标映射”与“SQL逻辑优化”两个关键环节，提供可修改的代码片段示例。
• 使用清晰的小标题、步骤编号、注意事项（Warning/Note框）和命令行实操截图（占位说明）来组织内容。

风格方向

• 文体风格：技术手册风格，追求精准、客观、条理清晰。避免文学化描述，采用定义、步骤、示例、总结的经典技术文档结构。
• 视觉基调：专业、整洁、现代。可参考科技公司官方API文档的视觉体系，采用深色代码块与浅色正文背景形成对比，关键步骤使用图标或色块进行视觉引导。
• 术语级别：使用“数据源连接”、“维度/度量定义”、“查询性能”、“缓存策略”、“权限继承”等专业领域术语，确保表述严谨。

构图建议（文档结构布局）

• 封面/标题页：明确文档标题、版本号、目标模型/工具名称、作者及更新日期。
• 文档结构图：在开头提供一张流程图或思维导图，可视化呈现“准备 -> 开发 -> 测试 -> 部署”四大阶段及其子步骤。
• 层级化标题：采用“章 -> 节 -> 小节”的多级标题结构，例如“第三章：模型开发 -> 3.1 定义核心事实表 -> 3.1.1 设置时间维度”。
• 图文混排区：为关键配置界面、命令行操作结果预留截图位置，并配以简明的图注说明。
• 代码与配置区块：所有SQL查询、YAML/JSON配置代码均需使用等宽字体单独呈现，并注明其作用与修改点。

细节强化

• 关键警告与提示：在涉及数据安全、生产环境操作、不可逆更改等步骤前，使用【警告】或【注意】标签强调风险与前置检查项。
• 参数化示例：提供的代码示例应包含可替换的变量（如{database_name}、{user_id}），并说明变量含义。
• 版本兼容性说明：明确指出本流程所依赖的BI工具版本、数据库驱动版本，以及已知的兼容性问题。
• 故障排查附录：在文档末尾设立“常见问题与解决”章节，列举3-5个微调过程中可能遇到的典型错误及其解决方案。
• 色彩与标识：在文档设计中，可使用不同颜色区分命令（如绿色）、文件路径（如灰色）、重要概念（如蓝色加粗），增强可读性。

使用建议

• 在使用本提示词生成初稿后，请务必使用真实或模拟环境走查一遍所有步骤，验证文档的准确性与可操作性。
• 根据团队实际使用的技术栈（如Docker、K8s、特定云平台），在“环境准备”和“部署”章节补充对应的具体命令与配置。
• 将文档视为“活文档”，建立与代码仓库的关联，当模型定义或SQL逻辑变更时，同步更新此文档。
• 在“核心提示词”部分填入您具体的项目信息，即可作为AI辅助写作的清晰指令，快速生成结构化草稿。