面向福州外语外贸学院工科类学生的课程实验报告(Word/.docx)撰写标准 skill:默认以本校《实验报告模版.docx》为底稿,只填写「实验实践目的 / 实验实践设备与仪器 / 实验过程 / 实验实践结论」四栏,封面、时间地点、实验名称一律留空,交付前做结构校验 + 渲染校验。
作者:GitHub@kmmiku
功能: 把一次真实的实验/实训过程沉淀成符合本校课程模板格式的实验报告。skill 内置了几块可复用的知识:①模板底稿与填写边界(哪四格填、哪几格必须留空、合并单元格索引);②三栏文字的写法(目的分点、一句话一条且不带任何编号符号;设备与仪器列版本号;结论约 150 字一句话概括流程,不写优缺点);③「实验过程」的图文节奏(一条 10–20 字图注 + 一张截图,图注在上、图在下)与截图时机清单;④交付前的双校验流程。覆盖虚拟机/操作系统安装、网络与安全实验、编程与数据库实验、嵌入式与硬件实验、AI 与数据处理实验等常见工科实验课型。
- 支持 Skill 机制的 Agent 客户端(Claude Code、Codex、DSH 等),或任何能读 Markdown 规范的协作流程。
- 手头有两样东西收益最大:实验指导书(PDF/PPT,看步骤、目的与必需图)与截图素材(按 skill 的截图时机拍下来的过程图)。
- 模板默认路径
D:\cxdownload\实验报告模版.docx;没有该文件时,用仓库内templates/实验报告模版.docx放到该路径即可。 - 纯问答、纯文案润色类需求无需本 skill。
git clone https://github.com/kmmiku/Fzfu_Homework_skill.git把 templates/实验报告模版.docx 复制到 D:\cxdownload\实验报告模版.docx(或按需修改 skill 里的 TPL 路径)。
把 skills/lab-report-cn 整个目录放入你所用客户端的 skills 路径:
- Claude Code:
~/.claude/skills/lab-report-cn/ - Codex:
~/.codex/skills/lab-report-cn/ - DSH:
<工作区>/skill/lab-report-cn/
目录内必须包含 SKILL.md,其 YAML frontmatter 提供 name 与 description,客户端据此决定何时加载。
在写报告时直接提要求,例如:
- 「按模板把这次实验写成实验报告」
- 「帮我把这些截图填进实验报告模板」
- 「实验报告写完了,帮我检查排版和图片数对不对」
客户端匹配 description 后自动加载本 skill,按模板版式产出 docx。
成文后必须跑完两步校验再交:结构校验(重开文档,核对封面与 r0/r1 未被改动、目的段数且无编号符号、结论为单句 130–170 字、图片数 == 图注条数)与渲染校验(LibreOffice 渲染首页/中间页/末页,确认封面不折行、图注在图片上方且未被拆页、结论与签名栏在最后一页)。
Fzfu_Homework_skill/
├── skills/
│ └── lab-report-cn/
│ └── SKILL.md # skill 本体:填写边界、三栏写法、图文节奏、生成脚本、校验清单、本机常见坑
├── templates/
│ └── 实验报告模版.docx # 本校课程实验报告底稿(默认工作模板,勿改动后覆盖)
├── docs/
│ └── push-guide.md # 一键推送到 GitHub 的操作指引(含代理与 PAT 说明)
└── README.md
模板是 1 个 6 行 5 列表格(Table Grid,正文 12pt 小四,标签黑体 12pt)+ 3 行封面段落。
| 行 | 模板标签 | 写入位置 | 处理 |
|---|---|---|---|
| r0 | 实验实践时间 / 实验实践地点 | cells[2] / cells[4] |
留空(保留空格占位) |
| r1 | 实验实践名称 | cells[1] |
留空 |
| r2 | 实验实践目的 | cells[1] |
填写:分点,一句话一条,无编号符号 |
| r3 | 实验实践设备与仪器 | cells[1] |
填写:一段罗列,带版本号 |
| r4 | 实验过程(整行合并) | cells[0] |
填写:图注 + 截图交替 |
| r5 | 实验实践结论(整行合并,含签名栏) | cells[0] |
填写:约 150 字一句话;签名栏原样保留 |
一律留空、禁止补全:
- 封面三段(课程名行、学院/年级/专业行、班级/姓名/学号行)——模板原样,一个字都不动。
- 实验实践时间、地点、实验实践名称。
- 结论栏里的
指导教师签名:……年 月 日。
实验实践目的:分点,3–5 条,每条一句话(15–30 字),动词开头;不加任何前缀(不要 1.、(1)、●、-、*、•),段落本身就承担分点作用。
实验实践设备与仪器:一段写完,逗号/顿号列举计算机、宿主软件、平台与版本、安装镜像。
实验实践结论:一句话约 150 字(130–170),只概括实验流程与结果(做了什么 → 按什么顺序 → 最终状态),不写优缺点、不写心得建议,一段到底。
实验过程:(模板已有)→ 每步 图注段(10–20 个汉字,动词开头)+ 图片段(居中,宽 15cm) → 下一步。一条图注只对应一个动作/一个界面,图注在上、图在下。
合格:上传Windows与CentOS安装镜像、配置2核CPU、4096MB内存与20GB磁盘、安装完成进入Windows10桌面
不合格:截图1(无信息)、点击下一步然后选择自定义安装并新建分区应用确定(超长)
- 只填四栏:目的、设备与仪器、实验过程、结论。多填一格(尤其封面)比少填更糟——会破坏模板原貌。
- 点完就截:对话框一旦关闭无法复现,向导每一步都要落地一张图;进度类画面抓一次带百分比的即可。
- 双校验:结构校验(重开文档数段落/表格/图片、正则扫编号符号)+ 渲染校验(LibreOffice 看分页),两步都过才算交付。
- 本 skill 是模板,自身不包含任何具体姓名、学号、学院、专业、班级、实验室门牌或账号名。
- 生成报告时封面与人名一律留空,不从往期报告搬个人信息,也不写进脚本。
- 仓库内只放规范、脚本骨架与空白模板,不放任何人的真实报告文件。
- 模板单元格合并:
row.cells会把同一个合并格重复返回,写错索引就会覆盖「实验实践时间」标签。 _Cell没有add_run,只能cell.paragraphs[0].add_run(...)或cell.add_paragraph()。- 图片一律
width=Cm(15.0),表格内可用宽度约 15.9cm,别按原始像素宽插。 - 中文必须显式设
rFonts的eastAsia,否则字体回退。 - 结论超 170 字会把签名栏挤到下一页;写完先数字数。
- Word 打开过会留
~$xxx.docx锁文件,写入前确认 WINWORD 未运行。 - PowerShell 5.1 读 UTF-8 无 BOM 的
.ps1会乱码报解析错误;脚本里别写中文,或存成带 BOM。
- AIagent-App-Development — AI Agent 工程全生命周期治理规范 skill
- Fzfu_Sch_Homework — 在校课程作业与实验代码合集
如有问题或建议,欢迎在 GitHub 提交 Issue 或 Pull Request。
感谢使用!🎉