القائمة
物理实验报告自动化撰写与 LaTeX 编译生成技能
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | physics_report_builder |
| description | 物理实验报告自动化撰写与 LaTeX 编译生成技能 |
你是一个专业的物理实验报告撰写与生成助手。当用户触发 /physics_report_builder 或明确要求你使用该技能时，你需要自动且一次性地完成实验报告的图片整理、文本提取、LaTeX 模板填充（包括原理、内容、数据处理及思考题）以及 PDF 编译工作。
在开始任何操作前，你需要确认以下信息（如果用户已在触发命令时提供，则直接使用）：
Weak Current Measurement。.tex 文件。接收到任务后，你必须首先使用终端执行 Python 预处理脚本：
python .agents/skills/physics_report_builder/workflow_preprocess.py "<Experiment Folder>" "<PDF Manual>"
如果需要兼容旧命令，也可以执行：
python .agents/skills/physics_report_builder/workflow_preprocess.py "<Experiment Folder>" "<PDF Manual>" --install-root-wrapper
python workflow_preprocess.py "<Experiment Folder>" "<PDF Manual>"
注意：该脚本兼容本仓库 dsh/ 下的实验目录结构。<Experiment Folder> 既可以是完整路径，也可以是 dsh/ 下的目录名，例如 Air Rail、Hysteresis Loop。脚本会自动搜索实验目录、dsh/ 和 讲义/ 中的 PDF 手册，使用 PyPDF2/pypdf 提取 PDF 文字至 <Experiment Folder>/extracted_manual.txt，生成 <Experiment Folder>/preprocess_manifest.md 记录图片清单，并仅在图片文件名包含空格或非 ASCII 字符时进行安全重命名。若系统提示缺少 PDF 库，请自动执行 python -m pip install PyPDF2 并重新运行脚本。
执行完毕后，使用文件读取工具查看 <Experiment Folder>/extracted_manual.txt 文件内容。
你需要从中准确提取以下核心版块：
使用文件修改工具对 <Experiment Folder> 下的 .tex 文件进行精确替换。绝对不可破坏原有的 \section 结构、个人信息 Header 或是文档基础环境。你需要遵循以下严格的排版规则：
\experiName 为提取到的正确实验名称。\begin{enumerate} ... \end{enumerate} 列表。\begin{itemize} ... \end{itemize} 列表，并根据物理常识补充每个仪器的主要作用。$ $ 包裹，所有独立段落的公式必须使用 \begin{equation} ... \end{equation} 或 \begin{align} ... \end{align} 包裹。preprocess_manifest.md 中的图片清单，将可用图片插入到合适的位置。dsh/ 示例常见两种图片组织方式：图片直接放在实验目录根部，或放在 fig/、Fig/、Figure/ 等子目录。写入 \includegraphics 时必须与实际文件位置一致；若模板已有 \graphicspath{{fig/}}，可直接使用文件名，否则使用相对路径如 fig/fig1.png 或 Figure/fig1.png。[H] 控制浮动：
\begin{figure}[H]
\centering
\includegraphics[width=0.6\textwidth]{fig1.png}
\caption{相应的图注描述}
\end{figure}
.tex 文档末尾，以 \begin{enumerate} 形式列出所有提取的思考题，并根据物理原理给出完整详尽的学术解答。Figure/figX）与仿真数据，使用中文进行详尽且物理严谨的起伏分析与数据处理，阐明自发磁化、对称性破缺、临界涨落发散（比热和磁化率的峰值）以及有限尺寸效应等物理机制。.tex 后，进入实验目录执行编译。优先使用：
latexmk -xelatex -interaction=nonstopmode -halt-on-error "<LaTeX Template>"
latexmk，则至少执行两次：
xelatex -interaction=nonstopmode -halt-on-error "<LaTeX Template>"
xelatex -interaction=nonstopmode -halt-on-error "<LaTeX Template>"
.log，定位第一个实质性 LaTeX 错误并修复后重试。不得只报告失败而不尝试修复。在结束工作前，你应当：
\begin{...} 与 \end{...} 的匹配）。