lab-report-writer

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 模板、历史报告、待补全文档。
• 原始数据、表格、截图、实验照片、仪器输出文件。
• 只说一句“帮我写某某实验报告”。

不要因为缺少全部材料就停止。能合理生成框架时先生成；不能确定的数据、图片、个人操作记录、教师指定格式必须标为“待补充”，不要编造。

总流程

1. 识别实验类型、交付格式、是否有模板、是否有原始数据。
2. 有模板时，先用 document_read 读取模板结构，再用 office_write(operation="edit") 生成编辑副本，尽量保留模板样式、页眉页脚、编号和固定字段。
3. 无模板时，默认生成结构完整的 DOCX；如果用户明确要 Markdown，再输出 .md。
4. 有资料时优先依据资料、用户文件和知识库；没有资料时可按该专业常见实验报告规范生成通用框架，并明确待确认项。
5. 有数据时必须进行基础整理：单位、有效数字、表格列名、计算公式、结果与结论是否对应。
6. 结束前执行质量自检，并在回复中说明输出文件路径和需要用户补充的内容。

默认报告结构

无模板时使用以下结构，并按实验类型调整：

1. 封面信息：课程名称、实验名称、姓名、学号、班级、日期、指导教师。未知项写“待补充”。
2. 摘要：100-200 字，说明目的、方法、关键结果和结论。
3. 实验目的：3-5 条，使用可验证动词。
4. 实验原理：核心概念、公式、模型、反应机理、系统框图或算法思想。
5. 仪器、材料与环境：设备型号、试剂浓度、软件版本、实验平台、关键参数。
6. 实验步骤：按实际操作顺序写，避免空泛。
7. 数据记录与处理：原始数据表、计算过程、图表、误差或不确定度。
8. 结果与分析：解释数据趋势、异常值、误差来源、与理论的偏差。
9. 思考题或讨论：如果指导书有问题，逐题回答；没有则提供专业相关讨论。
10. 结论：只总结由数据支持的结论，不扩大。
11. 参考文献：教材、指导书、标准、论文或网页，缺少来源时标注待补充。
12. 附录：原始记录、代码、完整计算、图片说明。

专业适配规则

• 物理/电子：突出实验原理、测量方法、误差分析、不确定度、仪器精度、拟合结果。
• 化学/材料：突出试剂与安全、反应条件、现象记录、产率/浓度计算、谱图或显微图分析。
• 生物/医学基础：突出样本来源、变量控制、重复次数、统计方法、生物安全和伦理边界。
• 计算机/自动化：突出需求、算法/控制策略、实验环境、输入输出、测试用例、性能指标和结果截图。
• 机械/工程训练：突出设备参数、工艺流程、结构图、测量数据、失效/误差原因和改进建议。
• 心理/教育实验：突出研究假设、被试、材料、程序、统计检验、伦理说明和限制。

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 的原因。