| name | lab-report-writer |
| description | Use for writing, editing, polishing, or structuring lab reports and course experiment reports across disciplines. Handles cases with a provided template, raw data, images, notes, or only a brief requirement, and can produce DOCX or Markdown deliverables. |
| allowed-tools | document_read, office_write, file_read, file_write, kb_search, web_search_bing |
实验报告写作
目标
帮助用户完成可提交的实验报告，而不是只生成泛泛的说明文字。默认面向高校课程、专业课实验、课程设计小实验和训练性实验，覆盖物理、化学、生物、材料、电子电路、自动化、计算机、机械、心理学、环境、医学基础等常见方向。
输入类型
用户可能只提供其中一部分：
- 实验名称、课程名、专业方向、教师要求。
- 实验指导书、讲义、评分标准、知识库资料。
- Word 模板、历史报告、待补全文档。
- 原始数据、表格、截图、实验照片、仪器输出文件。
- 只说一句“帮我写某某实验报告”。
不要因为缺少全部材料就停止。能合理生成框架时先生成；不能确定的数据、图片、个人操作记录、教师指定格式必须标为“待补充”，不要编造。
总流程
- 识别实验类型、交付格式、是否有模板、是否有原始数据。
- 有模板时，先用
document_read 读取模板结构，再用 office_write(operation="edit") 生成编辑副本，尽量保留模板样式、页眉页脚、编号和固定字段。
- 无模板时，默认生成结构完整的 DOCX；如果用户明确要 Markdown，再输出
.md。
- 有资料时优先依据资料、用户文件和知识库；没有资料时可按该专业常见实验报告规范生成通用框架，并明确待确认项。
- 有数据时必须进行基础整理：单位、有效数字、表格列名、计算公式、结果与结论是否对应。
- 结束前执行质量自检，并在回复中说明输出文件路径和需要用户补充的内容。
默认报告结构
无模板时使用以下结构，并按实验类型调整：
- 封面信息：课程名称、实验名称、姓名、学号、班级、日期、指导教师。未知项写“待补充”。
- 摘要：100-200 字，说明目的、方法、关键结果和结论。
- 实验目的：3-5 条，使用可验证动词。
- 实验原理：核心概念、公式、模型、反应机理、系统框图或算法思想。
- 仪器、材料与环境：设备型号、试剂浓度、软件版本、实验平台、关键参数。
- 实验步骤：按实际操作顺序写，避免空泛。
- 数据记录与处理：原始数据表、计算过程、图表、误差或不确定度。
- 结果与分析：解释数据趋势、异常值、误差来源、与理论的偏差。
- 思考题或讨论：如果指导书有问题，逐题回答；没有则提供专业相关讨论。
- 结论：只总结由数据支持的结论，不扩大。
- 参考文献：教材、指导书、标准、论文或网页，缺少来源时标注待补充。
- 附录：原始记录、代码、完整计算、图片说明。
专业适配规则
- 物理/电子：突出实验原理、测量方法、误差分析、不确定度、仪器精度、拟合结果。
- 化学/材料：突出试剂与安全、反应条件、现象记录、产率/浓度计算、谱图或显微图分析。
- 生物/医学基础：突出样本来源、变量控制、重复次数、统计方法、生物安全和伦理边界。
- 计算机/自动化：突出需求、算法/控制策略、实验环境、输入输出、测试用例、性能指标和结果截图。
- 机械/工程训练：突出设备参数、工艺流程、结构图、测量数据、失效/误差原因和改进建议。
- 心理/教育实验：突出研究假设、被试、材料、程序、统计检验、伦理说明和限制。
DOCX 生成要求
使用 office_write 时：
- 不确定元素、属性、路径时，先调用
office_write(operation="help", format="docx", element=...)。
- 大量段落、表格或样式设置可使用
useBatch=true。
- 只有 typed actions 不能表达时才使用
raw_set，必须设置 allowRawXml=true 且每个 raw action confirm=true。
- 编辑已有模板时绝不覆盖源文件；必须输出副本。
- 文档层级使用标题样式，正文统一字体和行距。
- 表格必须有表名、列名、单位；图必须有图题和说明。
- 如果图片路径不可用，插入清晰的图片占位说明，不伪造图片。
- 公式可以先用可读文本表达；复杂公式需要保真时可说明用户后续在 Word 中替换为公式对象。
数据和事实规则
- 不编造实验数据、仪器型号、姓名学号、教师姓名、真实参考文献页码。
- 对用户给出的数据做合理计算，但必须保留计算依据。
- 结论必须来自数据或资料；没有数据时写预期结论或待补充结论，并标明不确定。
- 可能影响评分的要求优先服从用户模板、评分标准和教师说明。
质量自检
交付前至少检查：
- 章节是否完整，是否匹配模板要求。
- 是否还有“待补充”项，并在最终回复中列出。
- 数据单位、有效数字和公式是否前后一致。
- 图表是否有编号、标题和引用。
- 结果分析是否解释异常值、误差来源和改进方向。
- 文件是否写入当前 Agent 输出目录。
输出方式
默认优先输出 .docx。如果 OfficeCLI 不可用或用户只要草稿，可输出 Markdown 草稿，并说明未生成 DOCX 的原因。
