Fldicoahkiin/lab-report-autopilot

Lab Report Autopilot (实验报告自动驾驶仪)

驱动报告从任务到交付：检查文件、选择环境、运行实验、捕获有用结果、填充用户模板、检查完成的 DOCX。一旦所需的文件和个人字段可用，无需要求用户执行常规步骤即可继续。

切勿虚构软件输出、截图、用户详细信息、引文或环境值。仅当环境不可用、缺少授权或缺少必要字段会导致报告虚假时才中断。

设置

将包含此 SKILL.md 的目录解析为 SKILL_DIR。通过绝对路径运行捆绑的脚本；当前目录可能是用户的报告文件夹而非技能文件夹。

如果不存在报告工作区：

python3 "$SKILL_DIR/scripts/init_report.py" work/report-name \
  --kind lab \
  --discipline packet-analysis \
  --title "ARP 协议抓包与字段分析"

对于专业实践使用 --kind practice。提供的 DOCX 保持为报告模板；不要将其替换为通用的 Markdown 草稿。

图像检查器需要 Pillow：

python3 -m pip install -r "$SKILL_DIR/requirements.txt"

阅读材料

在写作前对每个输入进行分类：

• **模板：**控制章节、字段、页面布局和视觉样式。
• **好的参考：**展示有用的步骤长度、措辞或截图位置。
• **反面示例：**展示要避免的问题。
• **任务材料：**提供所需的数据、代码、拓扑和预期结果。
• **私人材料：**遵循用户的处理说明并提供授权的信息。阅读 user-data-and-privacy.md。

学习模式，而非他人的身份或结果。不要复制姓名、截图、地址、私人记录或第一人称声明。

阅读 disciplines.md，然后加载匹配的学科文件。仅当任务确实跨学科时才加载第二个文件。

确定需要交付的内容

记录：

• 必需的章节和评分提示；
• 用户已提供的字段；
• 软件、操作系统、数据、拓扑和预期输出；
• 每个提交声明所需的可见结果；
• 长度、日期、文件名和文件格式规则。

仅从用户提供或确认的值中填充姓名、学号、班级、教师、单位、角色、日期和其他字段。在出现的所有位置使用相同的值。对于模板要求的缺失字段，询问一次。除非用户明确提供，否则留空签名、分数和审批字段。不要重用来自无关报告的文件名模式。

在编辑 Word 之前，阅读 docx-qa.md 并测量提供的模板：纸张大小、页边距、表格、字体、字号、行间距、缩进、图像宽度、标题、页眉、页脚和页码。这些测量值控制输出。

选择环境

阅读 environment-playbook.md，然后检查当前机器：

python3 "$SKILL_DIR/scripts/probe_environment.py" --json

不要假设作者的计算机或虚拟化产品。遵循任务指定的操作系统和软件。对于常见的中国大学课程，将 Windows 作为 Office、PowerShell、SQL Server、eNSP、供应商模拟器和仅限 Windows 的教学软件的主要路径。对于 Linux 网络和安全工具，使用 Linux 或 Kali。仅当指定的软件和所需截图等效时，才原生使用 macOS；否则使用任何可用的 Windows 或 Linux 虚拟机、容器、WSL 或授权的远程实验室。

除非权限修复和失败的尝试会更改提交的结果，否则将其保留在工作笔记中。安全相关的工作必须保持在本地实验室、课程系统、故意易受攻击的目标或其他授权系统内。

运行并捕获

阅读 evidence-and-screenshots.md 和所选学科文件。

1. 构建满足任务的最小设置。
2. 运行报告中会出现的每条命令和代码路径。
3. 在有意义的 GUI 操作后，检查最新的应用程序状态。
4. 记录确切的输入、文件名、版本、地址、帧号和观测值。
5. 捕获显示结果的屏幕；不要捕获每次点击。
6. 保持原始截图、数据包文件、数据和源代码不变。

生成的图表可以解释一个概念，但不得替代真实的软件结果。一份报告中使用的截图必须在文件名、地址、端口、值和环境上一致。

在起草前检查图像文件夹：

python3 "$SKILL_DIR/scripts/evidence_manifest.py" path/to/evidence \
  --output evidence-manifest.json

修复损坏的文件、意外的重复项、不可读的捕获、暴露的私人数据和缺失的结果屏幕。

根据观测结果写作

阅读 writing-and-code.md。

对于每个实践步骤，说明操作、观测到的值或行为、附近的截图以及简短的解释（仅当有帮助时）。理论和小结的比例应与示例和任务相符。

对于专业实践，按分配的工作撰写：接收了什么、检查或操作了什么、如何做出判断以及记录了什么结果。不要添加有关截图数量、报告结构、保留的工件或报告未引入内容的说明。不要添加公司主页以填补来源行。

对于代码，仅实现请求的行为。不要添加未使用的抽象、推测选项、不可能情况的检查或重述简单代码的注释。

构建并检查 DOCX

在可用时使用宿主代理的文档工具；否则使用兼容的 DOCX 工具和真正的渲染器。就地填充提供的模板。仅删除报告内容替换的示例文本。

渲染最新的 DOCX 并以 100% 查看每一页：

• 截图和标题清晰且对齐；
• 文本、表格和图像不裁剪或不重叠；
• 中文和拉丁字形正确渲染；
• 标题、编号、间距、缩进、页边距、页眉和页脚与模板匹配；
• 姓名、日期、命令、地址、帧号、图表和结论一致；
• 没有多余的空白页或几乎空白的遗留页；
• 文件名遵循此任务的规则；
• 不保留凭据、私人工作场所数据或无关的个人信息。

每次布局更改后重复渲染。除非用户要求工作材料，否则仅交付请求的文件。