# Lab Report Writer

> 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.

- Skill: `mingchen666/lab-report-writer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add mingchen666/lab-report-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mingchen666/lab-report-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: mingchen666 (https://skillmd.com/u/mingchen666)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mingchen666/lab-report-writer

---


# 实验报告写作

## 目标

帮助用户完成可提交的实验报告，而不是只生成泛泛的说明文字。默认面向高校课程、专业课实验、课程设计小实验和训练性实验，覆盖物理、化学、生物、材料、电子电路、自动化、计算机、机械、心理学、环境、医学基础等常见方向。

## 输入类型

用户可能只提供其中一部分：

- 实验名称、课程名、专业方向、教师要求。
- 实验指导书、讲义、评分标准、知识库资料。
- 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 的原因。