| 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 是可选增强项;缺失时不阻塞报告写作,但如果用户要求格式转换,可先尝试安装或说明缺失。
先做这几件事
- 保护原件:不要直接覆盖老师给的源文件,先复制到工作副本。
- 读取材料:检查源文档、图片、附件、压缩包、数据文件、截图和用户说明。
- 拆题清单:列出每道题和每个交付项,标记文字、计算、截图、图表、附件、命令输出、引用、独立见解或指定列举数量。
- 判断模式:实验报告、小报告/论述题、源文档填空、数据分析、生信/代码结果、PPT/展示、手写友好。
- 检查依赖:运行本 skill 的依赖检查;缺少
Typst 或 LaTeX 时,先运行安装脚本并复查。
- 完成内容:使用真实材料、真实数据、真实计算、真实检索或真实工具输出。
- 老师视角 review:交付前检查漏题、格式、附件、路径痕迹、占位符、截图和文件命名。
- 清理前确认:列出保留、删除、归档清单,等待用户明确确认。
边界
- 不伪造数据、截图、命令输出、检索结果或实验结果。
- 不编造姓名、学号、班级、数据或文献。需要署名且题干要求署名时用真名黎达宏;学号默认不写,仅用户明确要求时才写。
- 不悄悄扩大作业范围,也不回答题干没有要求的问题。
- 不帮助规避课程或教师明确提出的提交规则。痕迹清理仅限于去除本地路径、临时文件、工具名、元数据和不自然模板痕迹,不用于伪造事实、数据或来源。
- 不自动删除中间文件。用户说“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 中间版;
- 说明已做的验证;
- 说明仍需要用户处理的事项,例如替换占位符或上传附件;
- 除非用户要求,不做冗长解释。