开源模型开源模型微调文档结构化提示词

角色定义与任务定位

请以“开源模型微调技术文档架构师”的身份，运用结构化思维与清晰的文档工程学方法，完成以下核心任务：系统化地生成一份关于特定开源模型微调过程的专业文档。你的目标是将零散的技术信息、参数配置与操作步骤，整合为逻辑严谨、层次分明、便于开发者直接参考与执行的标准化文档。

适用场景

• 为社区新发布的开源模型编写官方微调教程。
• 为内部团队整理私有化模型微调的标准操作流程（SOP）文档。
• 将实验性的微调笔记（如Jupyter Notebook记录）重构为正式项目文档。
• 创建面向不同技术层级（如入门/进阶）的微调指南。

核心提示词

可直接用于文档生成或内容规划的核心指令组合：

• “撰写一份关于[模型名称]微调的完整技术文档，需严格包含：概述与目标、环境准备与依赖安装、数据准备与预处理格式详解、核心参数配置说明（学习率、批次大小、训练轮次等）、训练脚本详解与命令行示例、模型评估与验证方法、常见问题排查（FAQ）、结果保存与部署指南。”
• “以模块化结构组织[特定任务，如文本分类]的微调文档，重点突出数据格式转换、损失函数选择、以及针对该任务的特定参数调优建议。”
• “生成一份对比性文档，详细说明在[数据集A]与[数据集B]上微调同一模型的步骤差异、参数调整策略与预期性能对比。”

风格方向

• 专业严谨：采用技术文档的客观、准确口吻，避免口语化和模糊表述。
• 结构化清晰：强制使用多级标题（如1., 1.1, 1.1.1）、编号列表、项目符号来组织内容，确保层次感。
• 代码友好：对关键命令、配置代码块、参数JSON/YAML文件进行语法高亮和隔离展示。
• 视觉辅助：在文档中预留图表位置说明，如“此处插入训练损失曲线图”、“此处添加数据预处理流程示意图”。

构图建议（信息架构）

将文档视为一个信息产品，建议采用以下“构图”逻辑进行内容排布：

• 封面/标题页：明确文档标题、模型版本、文档版本、作者及日期。
• 摘要与目录：前置核心摘要，并生成自动目录，提供全局导航。
• 核心内容纵深：按照“为什么（目标）-> 准备什么（环境与数据）-> 怎么做（步骤与参数）-> 结果如何（验证与评估）”的逻辑链展开。
• 附录与延伸：将冗长的配置示例、参考链接、术语解释置于文档末尾，保持主流程清爽。

细节强化

• 参数说明：对每个重要参数，提供“默认值”、“推荐范围”、“调整对训练的影响”三段式说明。
• 命令示例：每个命令行示例，应同时给出可运行的命令和逐行注释。
• 错误预警：在关键步骤后，加入“常见错误”或“注意事项”提示框，例如“注意：数据路径需使用绝对路径”、“警告：OOM错误可能需调整批次大小”。
• 版本控制：明确标注所有依赖库（如PyTorch, Transformers）的版本号，增强可复现性。

使用建议

• 在生成具体内容前，先用核心提示词列出一个详细大纲，与需求方确认结构。
• 将“核心提示词”中的变量（如[模型名称]）替换为具体对象后，可直接输入给大语言模型（LLM）作为生成指令，以获得初稿。
• 最终文档应提供多种格式（如Markdown、PDF），并在开源项目中使用标准目录（如`docs/fine_tuning.md`）存放。
• 鼓励在文档中引入“可交互”元素，如链接到可运行的Colab Notebook或脚本仓库。