Skip to content

S1xycat/lab-report-writer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lab Report Writer Skill

这是一个用于生成实验报告的Skill。

你可以把实验任务书、实验报告模板、实验所需文件、成品实验报告等材料放进模板文件夹里,然后把文件夹路径发给 agent。agent 会自动读取文件,并生成一份完整的实验报告。

这个 Skill 能做什么

  • 根据实验任务书生成完整实验报告。
  • 按实验报告模板排版。
  • 参考成品实验报告的完整度,但不直接照抄。
  • 没有真实实验数据时,自动生成合理的数据。
  • 需要截图时,会先尝试运行相关文件或搭建最小环境来自动截图。

模板文件夹结构

模板文件夹/
├─ 实验任务书/
├─ 实验所需文件/
├─ 实验报告模板/
├─ 成品实验报告/
├─ 实验相关课件/
├─ 实验原始数据.md
├─ 个人信息.md
├─ 评分标准.md
├─ 输出文件要求.md
└─ 目标写作风格.md

空文件和空文件夹可以保留。agent 会自动跳过空内容,不需要删除。

每个位置放什么

实验任务书(必须有)

放老师给的实验要求、实验指导书、实验说明、任务 PDF、Word 文档等。

这是最重要的部分。agent 会优先从这里判断实验要做什么、报告要写哪些内容、需要哪些截图或表格。

实验所需文件

放实验过程中需要用到的文件,例如:

  • 源代码
  • 项目文件
  • 数据集
  • SQL 文件
  • 测试用例
  • 运行日志
  • 模型文件
  • 网页文件
  • 软件工程项目

如果报告里需要截图,agent 会先看这里有没有可以运行的程序、网页、脚本或测试文件,能运行就尽量自己截图。

实验报告模板

放空白实验报告模板,例如 .docx

如果这里有模板,agent 会优先按照模板的标题顺序、封面字段、表格样式和整体格式来生成报告。

成品实验报告

放从学长学姐那里拿到的已经写好的实验报告。

它的作用是让 agent 了解报告大概写多详细、老师可能喜欢什么结构。它不是用来照抄的。

agent 会尽量做到:

  • 不复制成品报告里的段落。
  • 不复制成品报告里的数据。
  • 不复制成品报告里的截图。
  • 不照着成品报告逐段改写。
  • 生成前先设计差异点。

实验相关课件

放 PPT、教材章节、课堂资料、参考文档等。

这些材料可以帮助 agent 补充实验原理、背景知识、公式解释和分析内容。

实验原始数据.md

如果你有真实实验数据,可以写在这里。

例如:

实验 1:
输入 A,输出 15.2
输入 B,输出 18.7

实验 2:
第 1 次测试通过
第 2 次测试失败,原因是……

如果没有真实数据,留空即可。agent 会默认生成合理的数据。

个人信息.md

放封面上需要填写的信息,例如:

姓名:
学号:
班级:
课程名:
教师名:
日期:
小组成员:

不知道的地方可以留空。agent 会保留占位符。

评分标准.md

如果老师给了评分标准、检查清单、扣分规则,可以写在这里。

例如:

实验原理 20 分
实验步骤 20 分
实验结果 30 分
分析总结 20 分
格式 10 分

没有评分标准就留空。

输出文件要求.md

写你希望输出成什么格式、放到哪里、怎么命名。

例如:

文件格式:docx
命名规则:软件测试实验报告-姓名-学号.docx
输出文件夹:D:\我的实验报告输出
生成份数:1

如果不写,agent 会按默认方式生成 DOCX。

目标写作风格.md

写你希望报告是什么风格。

例如:

写得像普通本科生实验报告,不要太像论文。
内容详细一点,实验步骤和结果分析多写。
语言自然,不要太 AI。

不写也可以,agent 会默认使用比较正常的学生实验报告风格。

怎么跟 agent 发提示词

最简单的说法:

使用 lab-report-writer skill,根据这个模板文件夹生成一份完整实验报告:
D:\你的路径\模板文件夹

希望报告和成品样例差异更大:

使用 lab-report-writer skill,根据这个文件夹生成一份新的实验报告。成品实验报告只作为完整度参考,不要照着它的排版、表格顺序、数据和段落结构写,请先设计差异点:
D:\你的路径\模板文件夹

数据和截图规则

如果你提供了真实数据,agent 会优先使用真实数据。

如果你没有提供真实数据,agent 会自动生成合理的数据。

如果报告需要截图,agent 会先尝试:

  • 找已有截图。
  • 运行网页或程序。
  • 运行测试脚本。
  • 搭建一个最小可运行环境。
  • 生成图表、终端输出或结果页面再截图。

只有确实做不了时,才会留下截图占位符。

公式生成规则

如果实验任务书、课件或报告内容里有公式,agent 可以先用 LaTeX 形式理解和组织公式,例如:

$$ I(\theta) = I_0 \left( \frac{\sin \beta}{\beta} \right)^2 $$

但最终生成的 DOCX 里,不应该直接显示这种 $$...$$ 源码。

公式处理优先级是:

  1. 能转换成 Word 原生公式 / OMML 时,优先使用 Word 原生公式。
  2. 如果原生公式转换不稳定,就把 LaTeX 公式渲染成透明背景 PNG 图片,再插入 DOCX。
  3. 生成后会检查文档里是否还残留 $$...$$\frac\theta\lambda 等 LaTeX 标记。

也就是说,LaTeX 可以作为“公式源码”,但不能作为最终报告里的普通正文交付。

如果你希望 agent 特别注意公式,可以这样提示:

使用 lab-report-writer skill 生成实验报告。文档中涉及公式时,请不要把 LaTeX 源码原样写进 DOCX,优先转换为 Word 公式,转换不了就渲染成透明 PNG 公式图片:
D:\你的路径\模板文件夹

免责声明

这个 skill 用于辅助整理和生成实验报告草稿。生成内容需要使用者自行检查、修改,并确认符合课程要求和学术规范。

About

一个根据实验材料自动生成实验报告的Skill

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages