pure

name	pure
description	当用户输入 `{~pure 主题}` 或 `{$用户输入}`，或要求穷尽/深挖项目核心、核心算法与竞争力、物理 图像、公式推导、代码与物理对应、精剖，或要为后续 agent 建立核心细节参考时使用；目标是把 项目最有价值的部分挖到底时，即使未明说“pure”也使用；核心细节在展示稿中出现公式、代码、表格 或流程遮挡/截断时也使用。
metadata	{"openclaw":{"emoji":"🎯"}}

pure — 核心细节穷尽解析与 agent 参考技能

执行前置

遵循当前目录 AGENTS.md「技能执行公共契约」；仅按需读取技能正文与 reference。

对当前 git 仓库中的核心部分进行只读穷尽剖析，解析用户输入（{$用户输入}，即剖析主题）， 产出 PDF 报告到当前工作目录的 docs/ 文件夹。

本技能与 analy 形式相同（同样的证据驱动、文件:行号 参考源、\lstinputlisting 直引、 LaTeX 报告输出与五色+场景色色彩体系）但定位互补。本技能是分析链的细节参考层：优先 消费 analy 产出的整体地图，在不重复全库罗列的前提下，把后续 agent 需要的核心算法、物理对象、 公式推导、代码符号和验证边界解析到可直接定位、复核和继续执行的粒度；对每个可能进入 report 的密集对象同时给出视觉占用、拆分边界和版式风险，使细节不会在展示层重新堆叠成遮挡。

技能	回答的问题	报告骨架
analy	仓库怎么组织（整体结构、关系、思路与入口）	概览→结构→关系→思路→主题→结论
pure	仓库最强的是什么、细节如何复核（核心部分穷尽剖析）	整体接口→核心清单→逐部分深剖→独特性→交接

analy 织网（整体参考），pure 掘井（细节参考）。二者按流水线使用：先 analy 固定全局边界与入口， 再 pure 深挖核心；report 消费二者的参考结果组织学者展示。

输入接口：开始剖析前优先查找用户提供的或当前 docs/ 下最新的 analy_* 参考产物，继承其任务定义、 范围、依赖链和证据入口，并对关键路径重新核实；找不到时仍可独立执行，但必须在终端摘要和报告中标注 “未取得 analy 整体参考”，不得假装已完成整体交接。输出给 report 时，除细节索引外必须同步交付 “证据—视觉”记录：对象、主张、来源、视觉类型、宽高等级、合法拆分点和风险。

何时使用 / 何时不用

使用本技能：

• 用户输入 {~pure <用户输入>} 或 {$用户输入}：{...} 内即剖析主题/范围
• 用户要求穷尽核心部分："穷尽"、"核心部分"、"核心算法"、"深挖"、"精剖"、 "把核心挖到底"、"最有价值的部分"
• 用户要求物理深挖："物理图像"、"公式推导"、"推导过程"、"模型设定"、"独家理论"
• 用户要求代码-物理对应："代码与物理对应"、"符号映射"、"这段代码对应什么物理"
• 用户要求竞争力分析："独特算法"、"核心竞争力"、"创新点"、"与朴素实现的区别"
• 用户要求为后续 agent 提供细节参考：核心函数/符号、公式推导、边界校验、独特性证据和可继续动作
• 与其他技能配合：先 analy 掌握结构全貌再 pure 深挖核心；pure 中发现 bug → debug； analy 产物是本技能的整体输入，剖析前后性能对比 → optim；剖析结论验证 → test； pure 产物供 report 学者展示消费；报告输出后打标 → tag

不使用本技能（转用对应技能）：

场景	改用技能
分析仓库整体结构/各部分关系/项目思路	analy
定位/修复 bug、排错	debug
性能/启动/资源优化	optim
查看改动差异、版本对比	diff
初始化/归档目录与 agent 配置	init
系统化测试与验证	test
生成全新项目	make

主题含糊（如只说"挖核心"）时先提问确认范围与项目性质（纯代码/纯物理/交叉）， 不擅自定义；所有问题在第一次交互一次性全部提出（编号列表），用户一次回答，不逐次追问。

核心原则

1. 穷尽性：剖析前先枚举全部核心部分候选（算法清单/物理对象清单/映射候选清单）， 每个候选显式分配三态——深挖（进入报告主体）/ 浅析（概述+理由）/ 排除（注明排除理由）——报告结尾重述三态计数，证明"穷尽"而非"挑选"；这张清单同时是后续 agent 的细节索引，任何候选不得落入"未处理"。
2. 独特竞争力定位：只剖析有独特性/竞争力的部分——纯代码：自研算法、精巧数据结构、 独到优化技巧（对照朴素实现与通用库给出差异证据）；纯物理：独家物理图像、自洽推导、 新的公式关系；交叉：关键代码-物理逐符号对应。通用脚手架、样板代码不进剖析主体。
3. 项目性质判定先行：按仓库实测内容（代码/公式/映射占比）判定三类之一—— 纯代码向 / 纯物理向 / 代码-物理交叉——并选择对应剖析框架（见工作流 Step 4）； 判定依据写入报告（性质判定框），不凭感觉归类。
4. 推导严谨，每步有据：物理推导从第一性原理（定义/对称性/近似/边界条件）逐步推演， 每步注明依据；公式一律编号（\label/\eqref 交叉引用）；推导前后做极限与退化校验 （$m\to 0$、$V\to\infty$、$L\to 0$、零耦合等极端情形下公式行为合理）与量纲检查。
5. 一一对应映射：交叉项目中每个关键代码符号必须有物理对象，且双向可查 （代码→物理、物理→代码），映射表列尽全部关键符号，无孤儿符号。
6. 证据驱动，参考源可追溯：每个结论附 文件:行号；代码片段用 \lstinputlisting[firstline,lastline] 直引仓库原文件，不做转写；公式对照 原文献/源码推导核验后写入，不凭记忆转写；每个拟展示的密集对象还要登记内容边界和版式风险。
7. 深挖 why：每个核心部分至少回答三层——是什么（对象/定义）→ 怎么工作 （机制/流程）→ 为什么这样设计（动机/权衡/对比备选方案）；只讲是什么不算深挖。
8. 诚实原则：找不到独特竞争力时如实报告"未发现显著独特部分"并给出依据； 未验证/推断的结论显式分级标注（确证/推断/未验证），不虚报创新性。
9. 只读分析与产出穷尽性：分析阶段不改动源文件；唯一写操作是 docs/ 下的 .tex 源文件与编译产物 .pdf。大任务中产生的全部图表与终端实测输出须列清单并逐项解读， 说明来源、含义、结论关联与局限，确保结果分析、综合分析和附录无遗漏；交给 report 的细节包 还必须闭合视觉占用与拆页信息。

工作流的统一 LaTeX 表达

凡是算法、伪代码、公式推导、编程思路、数据处理或验证过程等具有顺序、迭代或分支关系的内容， 在生成报告中统一用下列单列 table[htbp] 结构承载；它是工作流的主表达，流程图只补充跨模块关系。 每行只写一个动作或推导转移，\quad/\quad\quad 表示层级。算法按“输入→初始化→循环→分支/更新→ 收敛→输出”组织，公式推导在每行写出等式或箭头并标注定义、对称性、近似、量纲或边界条件，编程思路按 “输入→状态/数据结构→核心处理→校验/错误分支→输出”组织。真实报告中的公式、符号、数据和证据必须替换为 本次核验内容；长流程按语义拆成多个表格，不能靠缩小字号解决溢出。

\begin{table}[htbp]
  \centering
  \caption*{Workflow. Algorithm, derivation, and implementation}
  \small
  \begin{tabular}{@{}l@{}}
    $\text{Input: } D,\; x^{(0)},\; \varepsilon$ \\
    $\text{Initialize: } \mathrm{state}\gets(D,x^{(0)},\varepsilon)$ \\
    $\text{for } k=0,1,\ldots\ \text{ iterate:}$ \\
    \quad $\text{derive/update } F_{k+1}=T(F_k)\quad(\text{definition/symmetry/approximation})$ \\
    \quad $\text{implement } \mathrm{state}\gets\mathrm{update}(\mathrm{state},D)$ \\
    \quad $\text{if } \lVert r_{k+1}\rVert\le\varepsilon\ \text{ then stop}$ \\
    \quad $\text{else } k\gets k+1$ \\
    $\text{end for}$ \\
    $\text{Output: } F_{\mathrm{out}},\;\mathrm{state},\;\text{verified evidence}$ \\
  \end{tabular}
\end{table}

表格标题注明算法/推导主题及“示意”或数据来源；表格下方保留必要的 文件:行号、命令或参考源。

输入解析规则

输入形式	解析方式
{$主题或问题}	直接作为剖析主题；含问句时按问题展开
{~pure 主题}	同上，pure 之后的部分为主题
主题含糊（无焦点词）	一次性列出候选（按项目性质自动判定 / 指定某算法 / 指定某物理模块）提问确认
主题含范围限定	尊重限定（如"只看 src/ 下的算法"），并说明剖析范围
无主题（仅 ~pure）	自动判定项目性质后穷尽全部核心部分（默认模式）

主题解析后输出一句任务定义（如"剖析主题：格点 QCD 代码的核心物理算法与代码-物理映射"） 并在终端摘要中说明——任务定义是后续调查与报告结构的锚点。

输出命名约定

• 输出目录：当前工作目录（被分析仓库根）下的 docs/；不存在则创建
• PDF 文件名：pure_<主题slug>_<YYYYMMDD>.pdf（slug 用拼音/英文短词，不用中文字符； 如 pure_algos_20260815.pdf）
• .tex 源文件同目录同名：pure_<主题slug>_<YYYYMMDD>.tex
• 同日重复输出同一主题：文件名追加序号（_2、_3），不覆盖已有产物

触发时机

• 用户要求穷尽剖析："pure"、"穷尽"、"核心部分"、"核心算法"、"独特算法"、 "深挖核心"、"精剖"、"把核心挖到底"
• 用户要求物理深挖："物理图像"、"公式推导"、"模型设定"、"推导过程"、"独家理论"
• 用户要求代码-物理对应："代码与物理对应"、"符号映射"、"对应什么物理"
• 用户要求竞争力分析："核心竞争力"、"创新点"、"与朴素实现的区别"、"独特性评估"
• 用户要求为后续 agent 提供细节参考：需要逐函数、逐符号、逐公式或逐边界复核的可追溯底稿
• 与其他技能配合：先 analy 掌握全貌再 pure 深挖核心；剖析中发现 bug → debug； analy 产物提供整体边界，剖析前后性能对比 → optim；剖析结论验证 → test； 细节结果交给 report 组织学者展示；报告输出后打标 → tag； 多核心部分独立证据收集 → dispatch 并行派发

工作流程

Step 1. 解析用户输入（主题与性质）

1. 从 {$用户输入} / {~pure ...} 提取主题，按「输入解析规则」确认任务定义；
2. 主题不明确或项目性质无法判定时向用户提问（所有问题一次全部列出，用户一次回答）；
3. 在终端摘要中说明任务定义。

Step 2. 环境准备

# 1) 确认 git 仓库（在仓库根执行本技能）
git rev-parse --is-inside-work-tree

# 2) 确认/创建 docs 输出目录
mkdir -p docs

# 3) 确认 LaTeX 工具链（缺项则向用户报告，不静默降级）
command -v xelatex || command -v pdflatex || echo "NO_LATEX"
# 中文内容（主题含中文或仓库含中文文档）必须 xelatex + ctex；缺 ctex 时报错重试或告知用户

Step 3. 全库调查与核心部分候选清单（穷尽枚举）

# 仓库元信息
git log --oneline -20
git tag -l --sort=-v:refname | head -10

# 目录结构与文件清单
find . -type f -not -path "./.git/*" -not -path "*/node_modules/*" \
  -not -path "*/__pycache__/*" -not -path "./tmp/*" | sort

# 规模实测
find . -name "*.sh" -not -path "./.git/*" | wc -l
find . -name "*.py" -not -path "./.git/*" | wc -l
find . -name "*.f90" -o -name "*.cpp" -o -name "*.c" -not -path "./.git/*" 2>/dev/null | wc -l
wc -l $(find . -name "*.sh" -not -path "./.git/*") 2>/dev/null | tail -1

1. 接收整体参考：若已找到 analy 产物，先记录其任务定义、范围、结构/依赖链和未决问题， 再核对本次仓库状态；不得把 analy 的概览重复扩写为 pure 主体。若没有 analy 产物，记录缺失 并只补齐理解核心所需的最小整体上下文。
2. 建立核心部分候选清单（穷尽枚举，逐类列出）：
   • 纯代码向：候选算法/数据结构/优化技巧（按文件与函数枚举）；
   • 纯物理向：候选物理对象/模型/公式（按文档章节与代码注释中的物理量枚举）；
   • 交叉向：候选代码-物理对应点（按核心模块枚举）；
3. 阅读说明文件（AGENTS.md/README.md/docs/*.md）确认仓库定位，辅助候选筛选；
4. 候选清单及其三态分配在终端摘要中说明；清单以 C1/C2/... 编号，报告中同名引用。

Step 4. 项目性质判定与筛选（三态分配）

按仓库实测内容占比判定性质：

判定线索	纯代码向	纯物理向	交叉向
主体文件	算法/数据处理代码	推导文档/公式/书籍	物理计算代码+文档
独特性载体	算法复杂度/数据结构	物理图像/公式链	符号↔对象对应
报告剖析框架	算法原理→复杂度→正确性→独特性	图像→模型→推导链→极限校验	映射表→逐符号解释

对候选清单逐项分配三态：

• 深挖：有独特竞争力且证据充分的候选（进入报告第 2 节主体）；
• 浅析：相关但非核心（报告内一段概述 + 参考源）；
• 排除：通用样板/无关内容（报告清单表中注明排除理由）；
• 悬而未决的候选默认先深挖（宁可多挖，不可遗漏），证据不足时降级浅析并注明。

Step 5. 逐部分深度剖析（证据收集）

对每个"深挖"候选按性质框架剖析：

# 代码向：定位核心函数/算法
target_file="path/to/file"
grep -rn "def \|function \|核心函数名" "$target_file"
# 物理向：定位公式与图像描述
target_doc="path/to/document"
grep -rn "哈密顿量\|作用量\|相关函数\|关键物理量" "$target_doc"
# 交叉向：定位代码符号与物理对象的对应
code_path="path/to/code"
grep -rn "plaquette\|hopping\|wilson\|关键符号" "$code_path" "$target_doc"

1. 纯代码框架（每部分必答；核心算法须按 15 步全流程重现，禁止只讲原理平铺）：

   • 目的与前期准备：该算法/模块为什么存在、前置条件；
   • 输入 / 输出：数据/参数/配置是什么；预期产物与结果形式；
   • 整体框架：代码组织与主流程；关键细节：核心函数/数据结构/易错点；
   • 算法原理：输入/输出/步骤流程（结合代码直引）；
   • 任务如何正确执行：标准调用/运行步骤（命令或接口示例）；
   • 实际执行情况 / 实际输出情况：实测运行过程与实测结果；
   • 结果分析：结合生成的图表/终端输出/其他文件逐项解读；
   • 复杂度分析：时间/空间，推导或实测（注明基准）；
   • 正确性论证：不变量、边界情形、与朴素实现对比；
   • 独特竞争力：对照通用库/朴素实现给出差异证据（实测数据优先）；
   • 综合分析、结尾总结、结尾评价：与整体联系、优缺点、可改进处；
   • 补充说明：局限/假设/未覆盖项；参考源与附录（如有）。

2. 纯物理框架（每部分必答；推导须按 15 步全流程重现）：

   • 目的与前期准备：该理论/推导为什么存在、准备条件；
   • 输入：公理、定理、假设、假说、模型（逐项列出）；
   • 输出（应是什么）：公式、定理、假说、理论预言、判断；
   • 整体推理框架：推导/论证主线；推导关键细节：关键步骤、近似、边界条件；
   • 任务如何正确执行：推导/计算/实验的正确步骤；
   • 实际执行情况 / 实际输出情况：实测过程与实测公式/数据；
   • 结果分析：结合图表/终端输出/文件解读（含量纲检查与极限校验）；
   • 物理图像：一句话图像 + 直观理解（图像先行，公式后到）；
   • 模型设定：自由度、参数、几何/边界条件；
   • 公式推导链：逐步推演、每步标注依据（定义/对称性/近似/量纲）；
   • 极限与退化校验：极端参数下公式行为合理、量纲自洽；
   • 综合分析、结尾总结、结尾评价、补充说明（适用范围/未验证预言）、参考源与附录。

3. 交叉框架（每部分必答）：

   • 代码-物理映射表：符号 | 对象 | 物理含义与参考源（双向可查；参考源用 \texttt{\nolinkurl{...}} 放 X 列防溢出，见模板映射表结构）；
   • 逐符号解释：代码段直引 + 对象语言讲"为什么这样做"再讲"怎么实现"；
   • 其余步骤（目的/输入/输出/实际执行/实际输出/结果分析/综合分析/总结/评价/ 补充/参考源）按 A 框架（代码工作）组织，物理元素并入对应步骤。

4. 证据必须真实存在：引用前用 read/grep 核实行号与实际内容；

5. 公式核验：从推导写出公式后对照原文献/源码重新核对一遍（不凭记忆）；

6. 视觉交接记录：对每个进入 report 的公式、代码片段、表格、图或流程记录以下最小字段： 对象/主张 | 来源 | 视觉类型 | 宽度位置 | 高度等级 | 不可拆单元/拆分点 | 风险与缓解； 高度等级按短/中/高估计，代码附行数、公式附行数、表格附行数、流程附节点数；TikZ 风险细分为节点外框、 路径标签、独立标签和箭头包围盒，不以 Overfull=0 推断不存在遮挡。 将其整理为与 analy 一致的 content_payload： content_id | claim_id | evidence_ids | visual_type | width_budget | height_budget | min_font_pt | item_count | split_allowed | split_boundary | risks | mitigation；公式/表格/代码/流程分别填公式行、表格行、代码行/片段行数或节点数。

7. 主题在仓库中无依据时：记录"未找到相关证据"，报告阶段如实说明。

Step 6. 生成 LaTeX 源文件

生成 docs/pure_<slug>_<YYYYMMDD>.tex，必须遵循 references/latex-template.md（唯一权威模板）：

# 复制模板骨架后填充
# 模板路径: <本技能目录>/references/latex-template.md

• 形式规范：documentclass/宏包顺序/色板/框/样式与模板逐项一致，不自行增删；
• 色彩标识：场景色按语义使用（algo 橙=算法、phys 紫=物理、map 玫红=映射、 warn 橙红=未验证、hl 浅黄=要点），同色同义；
• 科研严谨：结论分级标注（确证/推断/未验证）、公式编号引用、每表注明数据来源；
• 逻辑通顺：一条主线——定位与清单→逐部分深剖→独特性→片段与公式→参考源→结论； 节间过渡句衔接，各核心部分剖析互相呼应；
• 内容丰富：核心部分清单表（三态填满）、映射表、独特性评估表齐全； 纯物理报告保证公式密度（推导链带编号）；每个"深挖"部分按 15 步全流程重现 （目的/输入/输出/框架/细节/正确执行/实际执行/实际输出/结果分析/综合分析/ 总结/评价/补充/参考源/附录），缺证据步骤标注 未验证 不跳过编号；
• 防溢出与视觉交接：grep -c Overfull 与 grep -c "Float too large" 交付前均为 0—— 长表一律 xltabular 跨页（table 环境不可跨页）、图片限宽高 （width=0.9\textwidth,height=0.6\textheight,keepaspectratio）， 全部规则与模板第 4 节一致；公式/代码/表格/流程必须附视觉类型、宽高等级、拆分边界和风险记录， 无警告也要逐页渲染检查遮挡、截断和页面外框；TikZ 标签优先用 above/below/left/right 加显式安全间距， 不能压入节点或箭头端点。

Step 7. 编译 PDF 到 docs/

cd docs
# 在临时目录编译两遍；终端输出在内存中检查，不污染 docs/
tex_name="pure_<slug>_<YYYYMMDD>.tex"
pdf_stem="${tex_name%.tex}"
build_dir=$(mktemp -d)
render_dir=$(mktemp -d)
trap 'rm -rf "$build_dir" "$render_dir"' EXIT
compile_output="$(xelatex -interaction=nonstopmode -halt-on-error -file-line-error \
  -output-directory "$build_dir" "$tex_name" 2>&1 &&
  xelatex -interaction=nonstopmode -halt-on-error -file-line-error \
  -output-directory "$build_dir" "$tex_name" 2>&1)" || {
  printf '%s\n' "$compile_output"
  exit 1
}
pdf_file="$build_dir/$pdf_stem.pdf"
test -s "$pdf_file"
overfull_count=$(printf '%s\n' "$compile_output" | grep -c 'Overfull' || true)
float_count=$(printf '%s\n' "$compile_output" | grep -c 'Float too large' || true)
overfull_hbox=$(printf '%s\n' "$compile_output" | grep -c 'Overfull \\hbox' || true)
overfull_vbox=$(printf '%s\n'  | grep -c  || )
underfull_count=$(   | grep -c  || )
  \
      
  -eq 0
  -eq 0
  -eq 0
  -eq 0
pdfinfo  | rg 
pages_actual=$(pdfinfo  | awk )
pdftoppm -png -r 100   >/dev/null
rendered_pages=$(rg --files  | rg -c  || )
   
  -eq 

  

编译警告为零后仍要执行页面级检查：用 pdftoppm 将 PDF 全部页面渲染到 mktemp -d，逐页检查公式盒、 代码框、表格列、TikZ 外框、彩色框内距和页脚是否相互侵入；对可疑页在临时诊断编译中加入 \overfullrule=5pt 定位盒体。诊断标记不进入最终 PDF，渲染目录检查后清理。

• 编译错误：依据终端编译输出中的 file-line-error 行号定位（宏错误/转义错误/缺宏包），修复后重编；
• Overfull > 0：按模板第 4 节定位（缩减代码片段行数/表格列文本/公式换行），修复后重编 直至为 0（循环尝试）；
• "Float too large" > 0：表格改 xltabular 跨页、图片限宽高（width=0.9\textwidth, height=0.6\textheight,keepaspectratio），修复后重编直至为 0；
• 编译警告为 0 但出现遮挡/截断：用临时 \overfullrule=5pt 诊断编译和逐页渲染，检查公式盒、 代码盒、TikZ 实际边界、表格列宽、彩色框内距及页脚保留区；按语义拆分或收窄局部对象，不能用 整页缩放掩盖；
• TikZ 节点/标签相互遮挡：把 \node、路径 node{...}、独立标签和箭头分别作为包围盒检查；为标签设置 above/below/left/right=<安全间距>，缩短或拆分文字后重新渲染，不能只看编译警告；
• Underfull 较多：先判断是否只是 \raggedright 下的可接受短行；若形成可见大空白、错位或层级断裂， 收紧表格列定义或改写单元格，不把所有警告机械归零；
• 缺宏包（如 ctex）：先尝试 tlmgr/发行版包管理器安装；无法安装则改写模板避开该宏包。

Step 8. 验证产物

ls -lh docs/pure_<slug>_<YYYYMMDD>.pdf        # 存在且非空
pdftotext docs/pure_<slug>_<YYYYMMDD>.pdf - | head -50   # 抽查文本（标题/结论/清单出现）

• PDF 页数、大小、抽检文本与报告预期一致；记录 pages_expected=pages_actual=pages_rendered=pages_checked，并给出 occlusion_pairs=0、clipped_objects=0、outside_safe_area=0 的逐页证据；
• 验证失败（PDF 缺失/空白/乱码）→ 回到 Step 6/7 修复重编。

Step 9. 总结（结构化输出）

✓ 剖析完成
   主题:   <解析出的任务定义>
   性质:   <纯代码向/纯物理向/交叉向（判定依据）>
   清单:   <核心部分 N 个: 深挖 A / 浅析 B / 排除 C（穷尽三态闭环）>
   证据:   <参考源 N 处，其中代码片段 M 处（lstinputlisting 直引）>
   输入:   <analy 整体参考是否取得；继承的范围/入口与本次核实结果>
   索引:   <C1/C2/... 对应的文件/函数/公式/物理对象与验证状态>
   产物:   docs/pure_<slug>_<YYYYMMDD>.pdf (N 页, X KB, Overfull=0, Float=0, occlusion=0)
   源码:   docs/pure_<slug>_<YYYYMMDD>.tex
   结论:   <最强竞争力总结>
   局限:   <排除项理由/未验证项，无则省略>

报告模板与生成要点

报告 .tex 必须遵循 references/latex-template.md（同目录下，唯一权威模板）。 本技能与 analy 模板形式完全一致（documentclass/宏包序/防溢出/严谨规范）， 仅场景色板（algo/phys/map/warn/hl）与报告骨架按 pure 定位调整。

生成要点（模板细节以 references 文件为准）：

1. 一条主线：摘要（供后续 agent 快速读取的任务定义、整体接口与性质判定）→ 项目定位与核心部分清单（穷尽枚举）→ 核心部分深度剖析（逐部分）→ 独特性评估 → 关键片段与公式 → 本次大任务图表与实测输出详览（穷尽清单+逐项详介，置于结果/综合分析与附录合理位置） → 参考源清单 → 结论；
2. 层次分明：每部分剖析遵循 原理→证据→独特点 三层；同一部分内容不散落多节；
3. 色彩语义唯一：algo 橙=算法、phys 紫=物理、map 玫红=映射、 warn 橙红=未验证/局限、hl 浅黄=要点——同色同义，禁止混用；
4. 代码保真：所有代码片段用 \lstinputlisting[firstline=,lastline=]{绝对路径} 直引；
5. 公式规范：核心公式编号 + \eqref 引用；推导每步标注依据；
6. 特殊字符：正文 $ % # & _ { } 转义，路径/代码走 \detokenize/\lstinputlisting；
7. 表格数据：清单三态、行号与 Step 3-5 实测一致，不臆造。
8. 图表与实测输出详览（大任务必备）：本次大任务全部图表与终端实测输出逐项落位——结果分析中逐项解读、综合分析中关联；每项含来源、生成方式、数据含义、详尽解读与结论关联，配 文件:行号 或命令引用；以清单闭合为交付前提。
9. 细节参考索引：在摘要或结论前给出 C1/C2/... 到文件、函数/符号、公式/物理对象、验证状态 和可继续动作的映射；明确哪些结论继承自 analy、哪些由本次 pure 新增，方便后续 agent 精确跳转。

质量检查清单（交付前逐项核验）

• 主题已解析为一句任务定义并在终端摘要中说明；含糊主题已向用户确认
• 核心部分候选清单已穷尽枚举且三态（深挖/浅析/排除）填满，无"未处理"
• 项目性质判定有实测依据（代码/公式/映射占比）并写入报告
• 每个"深挖"部分按对应框架剖析完整（代码:原理/复杂度/正确性/独特性； 物理:图像/模型/推导链/极限校验；交叉:双向映射表/逐符号解释）， 且按 15 步全流程重现（目的/输入/输出/框架/细节/正确执行/实际执行/实际输出/ 结果分析/综合分析/总结/评价/补充/参考源/附录），缺证据步骤已标注"未验证"
• 结果分析步已实际查看/引用生成的图表、终端输出、其他文件后撰写，非空谈
• 本次大任务全部图表与终端实测输出已穷尽收录（清单闭合），每项配详尽介绍（来源/生成方式/含义/解读/关联）并置于结果分析与综合分析的合理位置
• 每个结论附 文件:行号 参考源；行号引用前用 read/grep 核实过
• 代码片段全部用 \lstinputlisting 直引（无手抄转写）；公式对照原文献/源码核验过
• 报告结构遵循模板主线；场景色语义统一（algo/phys/map/warn/hl），无额外颜色
• 结论分级标注（确证/推断/未验证）；无依据结论已如实标注
• PDF 编译成功；grep -c Overfull 为 0 且 grep -c "Float too large" 为 0； pdftotext 抽检标题/结论/清单出现；全部页面已渲染并检查边界、遮挡与截断
• 交给 report 的每个密集对象都有“证据—视觉”记录：视觉类型、宽度位置、高度等级、拆分边界、风险与缓解
• 总结输出覆盖：主题/性质/清单三态/证据/产物/结论/局限

示例

示例 1（纯代码向） 输入：{~pure src/ 下最核心的算法} 任务定义："剖析主题：src/ 核心算法（穷尽枚举 + 独特性评估）" 产物：docs/pure_algos_20260815.pdf，含核心部分清单表（三态填满）、每个深挖算法 复杂度分析与正确性论证、与朴素实现对比表、\lstinputlisting 直引核心函数。

示例 2（纯物理向） 输入：{$ 格点 QCD 的物理图像与核心公式推导} 任务定义："剖析主题：格点 QCD 物理图像、作用量与推导链" 产物：docs/pure_qcd_20260815.pdf，含物理图像框（plaquette 图像一句话）、 模型设定（晶格/边界/耦合）、作用量推导链（编号公式逐式标注依据）、 极限校验（$m\to 0$ 手征极限、$a\to 0$ 连续极限）。

示例 3（交叉向） 输入：{~pure 代码与物理图像的一一对应} 任务定义："剖析主题：格点代码符号 ↔ 物理对象双向映射" 产物：docs/pure_map_20260815.pdf，含双向映射表（plaquette 变量 ↔ 最小格点环元、 hopping 项 ↔ 夸克相邻格点跃迁）、逐符号代码直引与对象语言解释。

错误处理

场景	处理
非 git 仓库	git rev-parse --is-inside-work-tree 校验失败时报告；仍可按普通目录分析并注明
主题含糊	一次性列出候选（自动判定/指定算法/指定物理模块）提问确认，不逐次追问
性质无法判定	列出实测占比数据向用户确认归类，不凭感觉归类
缺少 analy 整体参考	标注“未取得 analy 整体参考”，补齐最小上下文并降低整体性结论强度，不伪造继承关系
无 LaTeX 工具链	报告缺项；提供安装建议（apt install texlive-xetex texlive-lang-chinese 等），不静默跳过
缺 ctex/宏包	尝试安装；不可行则改用纯英文模板/替代方案并注明
无独特竞争力候选	如实报告"未发现显著独特部分"，附候选清单与排除理由供用户改题
公式无法核验	明确标注"推导未核验"，不写入报告正文作为确证结论
Overfull > 0	按模板第 4 节定位（缩减片段行数/表格列/公式换行）修复重编直至为 0
"Float too large" 警告	图表溢出页面：长表改 xltabular 跨页（table 环境不可跨页），图片限宽高（width=0.9\textwidth,height=0.6\textheight,keepaspectratio），修复重编直至为 0
编译警告为 0 但出现遮挡/截断	用临时 \overfullrule=5pt 诊断编译和逐页渲染，检查公式盒、代码盒、TikZ 实际边界、表格列宽、彩色框内距及页脚保留区；按语义拆分或收窄局部对象，不能用整页缩放掩盖
Underfull 较多	区分 \raggedright 下的可接受短行与可见大空白/错位；只修复影响阅读的页面，并调整列定义或单元格
LaTeX 转义错误	正文特殊字符转义；代码/路径走 \detokenize/\lstinputlisting
编译失败	依据终端编译输出定位行号修复重编（循环尝试直至成功），失败原因在终端摘要中说明
路径含空格/中文	\lstinputlisting 用绝对路径引号包裹；PDF 文件名用拼音 slug 规避
产物重名	追加序号（_2），不覆盖已有 PDF
候选清单过长	全量清单进报告（longtable 跨页），深挖子集进主体节，两处计数一致
引用行号与实际不符	引用前用 read/grep 核实，绝不凭记忆写行号

注意事项

• 剖析过程对源文件只读；docs/ 下的 .tex 与 .pdf 是本技能产物，按公共 Git 契约检查，不自动提交或推送；
• 穷尽是核心：候选清单三态必须填满并重述计数，只剖析而不证明穷尽会漏掉核心部分；
• 公式不可凭记忆转写：从推导写出后对照原文献/源码核验，量纲检查 + 极限校验双保险；
• 物理图像先行：先讲清"这是什么对象/图像"，再讲"怎么推导/怎么实现"；
• 报告用色规范统一（accent/evidence/reference/conclusion/codebg + algo/phys/map/warn/hl）， 不引入额外颜色；新增颜色须同步更新 references 模板色板表；
• 交付给 report 的密集公式、代码、表格和流程必须保留视觉占用与拆分信息；“编译成功/无警告”不替代逐页渲染检查；
• 交付前 grep -c Overfull 与 grep -c "Float too large" 均必须为 0 （长表 xltabular 跨页、图片限宽高，模板防溢出规则见 references/latex-template.md）；