beforeu-report

name	beforeu-report
description	用于写作、补全、审查或打包课程作业、实验报告、小报告、论述题、练习题、源文档填空、数据分析作业、LaTeX/Typst 公式报告、PDF 渲染、截图附件、参考文献、文件命名和提交前检查等学生交付物。

BeforeU-report

核心原则

用于课程作业、实验报告、小报告、论述题、课堂练习、源文档填空、数据分析作业，以及生物/化学/计算类作业交付。

总原则：保护原件，按题干完成；图表积极增强，文档风格可控；LaTeX/Typst 公式与排版可用；老师视角 review；清理必须用户确认。

依赖优先检查

开始生成正式交付物前，先检查本 skill 的必选依赖。若缺失，先帮用户安装，再继续写作或渲染：

python3 scripts/check_dependencies.py
python3 scripts/install_dependencies.py

必选依赖：

• Typst：用于生成 .typ 源稿和渲染 PDF。
• LaTeX：使用 xelatex、lualatex 或 pdflatex 渲染 .tex 源稿，支持课程报告中的公式。

Pandoc 是可选增强项；缺失时不阻塞报告写作，但如果用户要求格式转换，可先尝试安装或说明缺失。

先做这几件事

1. 保护原件：不要直接覆盖老师给的源文件，先复制到工作副本。
2. 读取材料：检查源文档、图片、附件、压缩包、数据文件、截图和用户说明。
3. 拆题清单：列出每道题和每个交付项，标记文字、计算、截图、图表、附件、命令输出、引用、独立见解或指定列举数量。
4. 判断模式：实验报告、小报告/论述题、源文档填空、数据分析、生信/代码结果、PPT/展示、手写友好。
5. 检查依赖：运行本 skill 的依赖检查；缺少 Typst 或 LaTeX 时，先运行安装脚本并复查。
6. 完成内容：使用真实材料、真实数据、真实计算、真实检索或真实工具输出。
7. 老师视角 review：交付前检查漏题、格式、附件、路径痕迹、占位符、截图和文件命名。
8. 清理前确认：列出保留、删除、归档清单，等待用户明确确认。

边界

• 不伪造数据、截图、命令输出、检索结果或实验结果。
• 不编造姓名、学号、班级、数据或文献。需要署名且题干要求署名时用真名黎达宏；学号默认不写，仅用户明确要求时才写。
• 不悄悄扩大作业范围，也不回答题干没有要求的问题。
• 不帮助规避课程或教师明确提出的提交规则。痕迹清理仅限于去除本地路径、临时文件、工具名、元数据和不自然模板痕迹，不用于伪造事实、数据或来源。
• 不自动删除中间文件。用户说“review”“检查”“看看”时，不顺手清理。

文档风格

先判断用户想要的文档风格：

• 克制模式：有老师源文档时默认使用。保留字体、编号、段距、页眉页脚和源文档版式，只填写必要内容。
• 适度整理模式：没有源文档、从零生成报告时默认使用。轻微整理标题、表格、图注和间距。
• 美化模式：适合展示、汇报或正式报告。只有用户明确想要更漂亮时使用。

使用当前可用的文档生成 skill（如 officecli-docx）时尤其要克制；这些工具容易额外美化。大范围美化前先问用户。

DOCX 闭环硬规则：DOCX 默认走 officecli（比 python-docx 可靠）；最小样式改动；每步改完跑 officecli validate；用 officecli get/view 反读实际 DOCX 结构与 XML 为准，不轻信生成脚本逻辑；清理 docProps 元数据（作者、公司、最后修改者）。

DOCX 工具分层（按来源选，求质量上乘）：从零造文档用 officecli（默认引擎，学术稿可走 officecli-academic-paper、nature-office-workflow）；Markdown/LaTeX 源稿转 DOCX 用 pandoc 报告.md -o 报告.docx --reference-doc 克制模板.docx，样式全部来自一份体现朴素克制版式（宋体 12pt、1.5 倍行距、首行缩进、无装饰）的真实 Word 模板，最贴合去 AI 味；填老师给的 .docx 模板用 docxtemplater 占位符替换或在原件副本上最小改动，保真度最高；最终分页与视觉以 Word 或 WPS 打开核对为准，LibreOffice 仅粗略预览；python-docx 仅作上述都不可用时的兜底。

Word/DOCX 正文拟人排版硬规则（逐项可核对）：

• 标题居中加粗。
• 正文黑色宋体，约 12pt。
• 1.5 倍行距。
• 段落首行缩进 2 字符。
• 不主动加蓝色标题、主题色横线、装饰性分隔线、复杂底纹、页眉页脚装饰或明显模板化的视觉元素。

用户指出颜色、横线、边框、底纹、页眉页脚等瑕疵时，优先当作样式清理任务；修改后用 officecli get/view 反读文档结构和相关 XML，确认没有残留异常样式。

LaTeX 与 Typst 支持

当作业包含公式、推导、实验计算、数学符号、物理化学表达式、正式 PDF 或用户明确要求 LaTeX/Typst 时，启用此流程。

输出策略：

• 非 DOCX 路径首选 Typst+PDF，其次 LaTeX；只在老师明确要求 TeX、需要复杂公式或传统论文格式时才用 LaTeX。
• 默认同时保留可编辑源稿和最终 PDF：报告.typ / 报告.tex + 报告.pdf。
• 用户要求 Word/DOCX 时，仍可先用 Typst/LaTeX 管理公式和排版，再按可用工具转换或把公式内容嵌入 DOCX。
• 公式统一用 LaTeX 风格行内 $...$ 由 Typst 渲染；独立公式用 $$...$$ 或 LaTeX equation 环境。

渲染命令：

typst compile 报告.typ 报告.pdf
xelatex -interaction=nonstopmode 报告.tex

渲染后必须检查：

• PDF 是否生成成功；
• 公式、单位、上下标、希腊字母是否正确；
• 中文字体是否正常；缺失时优先本机修复，不降级替换；
• 页数/分页不靠估算，用 PDF 实测查看；LibreOffice 转 PDF 仅粗略预览，分页敏感时以 Word/WPS 或目标渲染器为准；
• 报告中没有本地绝对路径、脚本名或工具痕迹。

实验报告模式

先确认实际做了哪个实验，不把讲义里未完成的实验写进报告。

常用结构：

• 题目
• 实验目的
• 实验原理
• 仪器与试剂
• 实验步骤
• 数据与计算
• 结果与讨论
• 误差分析
• 实验结论
• 思考题（如果有）

计算前核对样品顺序、时间顺序、空白/样品/加标样品关系、单位和公式。计算应包含公式、代入、单位换算和最终结果。

如果数据异常，优先写成异常结果分析或明确说明合理实验口径，不强行得出正常结论。

手写友好模式

当用户说“手写”“抄写”“实验报告纸”“只要文字”“别太长”“适中”“方便抄”等表达时触发。

输出要完整但不冗长，便于抄写：

• 实验目的：3-4 条。
• 实验原理：1-2 段，加必要公式。
• 仪器与试剂：简洁列出。
• 实验步骤：概括实际操作。
• 数据与计算：关键数据、公式、代入、结果。
• 结果分析：1 段。
• 误差分析：3-5 条。
• 结论：2-4 句。

如果用户只说“生成文字即可”，默认给适中版；用户要求完整版时再展开。

源文档填空模式

当用户提供 Word 文档、练习册、作业模板或题干模板时：

• 从原件副本开始工作。
• 保留原题干和样式。
• 在原题下方、空白处或指定位置填写答案。
• 避免额外封面、装饰章节、统一重设计或报告式重排。
• 只有题目需要时，才删除或替换源文档中的示例图。
• 最终效果应像认真学生在原始文档上完成作业。

小报告与论述题模式

当用户说“小报告”“论述”“解释为什么”“结合……分析”“需要自己的独立见解”“附参考文献/信息来源”“整理为文档”等表达时触发。

先拆题：

• 主问题是什么；
• 是否有补充问题；
• 是否要求“列举 N 项”；
• 是否要求机制说明；
• 是否要求结合多个角度；
• 是否要求独立见解；
• 是否要求参考文献或中文信息来源。

常用结构：

• 标题
• 核心观点或摘要
• 分论点一、二、三
• 机制分析或对比分析
• 独立见解
• 结论
• 参考文献与信息来源

规则：

• 三料合并（硬门槛）：写正文前先把三料对齐——(1) 题干具体要求；(2) 用户真实背景（海洋科学/鱼类科研/生物信息学/Python/AI 开发）；(3) 课程核心概念——三者在正文必须各有落点，缺一即返工。禁止写成可套用任何人、任何课的通用感悟或论文综述。
• 题目出现“列举 N 项/N 点/N 个原因”等数量时，正文用阿拉伯数字 1./2./3. 显式编号；交付前数一遍编号条数，必须等于 N，不足或超出都返工。
• 题目要求“结合 A、B、C”时，每个角度都要有对应内容，不能只写其中一个。
• 题目要求“作用机制”时，不能只写影响名称，要说明从人类活动到生态/生理/种群后果的因果链。
• 题目要求“独立见解”时，必须基于本次材料/数据做一步推理或取舍判断（如“我认为关键矛盾是……因为材料 X 显示……”），不得是“综上所述很重要/受益匪浅/意义深远”一类放之四海皆准的空话。
• 文风硬规则：以短句、要点式为主；一个要点一句话，能编号就编号。禁止同义反复、口号式过渡句（如“综上所述”“由此可见我们不难发现”）和与论点无关的铺陈。
• 题干给出字数/篇幅区间时，完成前实测字符数（中文按字符计），确认落在区间内；超下限补内容、超上限删冗余，不靠目测估算。
• 用户说“整理为文档”时，默认可同时保留 Markdown 源稿和 DOCX 提交稿；若用户只要一种格式，则按用户要求。

资料来源与引用

涉及事实性、生物学、生态学、政策、现状数据、物种濒危等级或最新统计时，必须核对可靠来源。需要最新或具体事实时应联网确认。

来源选择：

• 优先使用论文、IUCN、FAO、NOAA、政府/国际组织报告、大学或科研机构资料。
• 中文课程作业需要中文信息来源时，主动补充政府、科研机构、中文科普或中文权威报道来源。
• 中文来源不能只是摆设；每个来源应支撑正文中的某个论点。
• 不伪造文献，不编 DOI、年份、作者或机构。

引用写法：

• 小报告通常 4-8 条来源即可，除非老师要求更多。
• 输出中可以用“来源名 + 标题 + 链接/出处”的朴素格式，不必强行做期刊级格式。
• 不要只堆链接；正文里要能看出每类来源支持了哪个事实或论点。
• 中英文来源混用时，中文来源用于增强本土课程语境，英文来源用于支撑国际数据或专业结论。

数据分析与生信/代码模式

当作业涉及 CSV、数据分析、本地工具、BLAST、命令输出、检索结果或截图时：

• 优先使用可复现命令和真实结果。
• 涉及在线工具或会变化的数据时，使用当前可靠来源。
• 题目要求截图时，获取真实截图。
• 最终文档中保留必要命令输出，但把路径简化为普通相对路径。
• 不把答案写成技术博客，要贴合作业文档风格。

中断续写与状态恢复

当用户说“继续”或之前任务被中断时，不要从头重做。先恢复状态：

• 检查已有文件是否生成；
• 检查上次做到哪一步；
• 检查是否有未完成的验证、渲染、截图、引用或样式修改；
• 检查用户后续提出的新要求是否改变最终交付物。

继续时优先完成收尾检查和用户新要求。若文件缺失、损坏或内容不可靠，再说明原因并重建。

图表策略

图表生成应偏积极。出现实验数据、CSV、仪器曲线、标准曲线、吸光度、峰电流、电压、浓度或时间序列时，主动判断是否补图。

有帮助时生成标准曲线、伏安曲线、仪器曲线、吸光度-浓度图、散点拟合图、柱状图、时间序列图或误差棒图。

图表可以清楚漂亮、相对专业；老师可能知道 AI 参与，因此图不需要故意粗糙。但图必须可读、准确、适合课程作业，不应花哨到影响读数。

需要科学绘图、曲线拟合、图形润色或图形验证时，调用 nature-figure。使用“课程作业增强模式”：坐标轴、单位、图例、标签、数据准确性和视觉清晰度都要做好，整体专业但不过度抢眼。

如果图表只是可选增强项或可能显得多余，说明建议并让用户决定是否插入最终文档。

Skill 联动

根据任务和当前可用 skill 列表调用能生成目标交付物的 skill；名称以本轮 skill 列表为准，不要引用不存在的通用名。

• Word、报告、DOCX：优先使用当前可用的文档生成 skill，例如 officecli-docx、officecli-academic-paper、nature-office-workflow；遵循「文档风格」段的 DOCX 闭环硬规则（officecli validate + get/view 反读，不轻信脚本逻辑）。
• Excel、CSV、数据表、XLSX：优先使用当前可用的表格或数据文件生成 skill，例如 officecli-xlsx、officecli-data-dashboard、officecli-financial-model。
• PPT、课堂展示、演示稿：优先使用当前可用的幻灯片生成 skill，例如 officecli-pptx、officecli-ppt-design、officecli-pitch-deck、nature-paper2ppt。
• 图表、实验曲线、统计图：需要科学绘图、曲线拟合、图形润色或验证时，调用 nature-figure。
• 引用和参考文献：仅在作业要求引用、参考文献或来源支撑时，调用 nature-citation。
• 一图解、信息图、课程海报或图片化总结：用户明确要求生成图片时，调用当前可用的图片生成 skill，例如 imagegen。
• 网页截图、在线作业系统、BLAST 或实时检索页面：使用浏览器工具或当前可用的网页/检索工具获取真实结果。

联动 skill 应服务于课程作业场景。优先选择能直接生成最终文件或必要附件的 skill，不应让最终输出变得不必要地高级、冗长或过度设计。

老师视角 Review

最终交付前按严重程度检查：

Blocker：

• 漏题；
• 指定列举 N 项时未显式编号，或编号条数 ≠ 题干 N（交付前实测计数）；
• 题干给定字数/字符数区间时，未在完成前核对实测字符数落在区间内（中文按字符计）；
• 要求独立见解但没有独立分析；
• 要求参考文献但没有来源，或来源无法支撑正文；
• 附件错误或缺失；
• 文件名、姓名或学号错误；
• 占位符未替换；
• 可见本地路径或工具痕迹；
• 截图与题目不匹配；
• 结果伪造或缺乏依据。

Warning：

• 格式相对源文档突然变化；
• 答案过度精美、过宽或明显超出课程水平；
• 只有英文来源，且用户要求或语境明显需要中文来源；
• 中文来源只是堆在文末，没有支撑正文论点；
• 图表有用但插入不自然；
• 命令输出包含不必要细节；
• 字符数落在题干区间外。

Polish：

• 措辞太模板化；
• 图注或表题可以更清楚；
• 标题颜色、横线、边框、底纹等视觉元素不符合用户偏好；
• 局部间距或对齐问题；
• 最终文件清单可以更干净。

痕迹与元数据检查

检查最终交付物中是否存在：

• Codex、OpenAI、ChatGPT、脚本名、临时文件夹、本地工作目录；
• /Users/...、项目工作区路径、缓存路径、下载路径；
• DOCX/PPTX/XLSX 内部 XML 中的路径或未引用媒体；
• 嵌入图片元数据，或截图中可见的浏览器账号、本地路径、下载栏；
• 最终压缩包中的 .DS_Store、__MACOSX、脚本、下载包、缓存或不需要的截图。

路径清理应让日志看起来像普通课程相对路径，而不是伪造结果。

清理门槛

绝不自动清理。

清理前必须展示：

• 最终保留文件；
• 建议删除的中间文件；
• 可选归档的可复现材料；
• 状态不确定的文件。

只有用户明确确认后，才能删除或归档。

清理后展示剩余文件清单。

最终回复

最终回复保持简洁实用：

• 列出最终文件的绝对路径；
• 多次生成时显式标注最终版 vs 中间版；
• 说明已做的验证；
• 说明仍需要用户处理的事项，例如替换占位符或上传附件；
• 除非用户要求，不做冗长解释。