azhi-ss/academic-figure-skills/fig-analyze

fig-analyze

把仓库、论文或草稿、参考图分析成可交接结果。本 skill 不写 prompt，也不生图。

先检查输入内容，再选择路径。不要把所有 URL 当成仓库：打开页面或正文后，再判断它是论文、代码仓库，还是图。

检查时看这三件事：

• 正文、章节或 LaTeX/Markdown 结构 → 论文或草稿
• 源码、README、依赖与入口脚本 → 仓库
• 图本身、图注，或 PDF 里的嵌入图 → 参考图

路由

草稿、大纲或完整手稿

Markdown、LaTeX、PDF 正文，或论文 URL 打开后的正文，读 references/paper.md，产出 Figure Plan v1。

• 笔记、大纲、早期草稿：只规划 Figure 1（Overall Framework），不要强行补实验图。
• 含实验结果的完整手稿：按论文主张规划多图。
• 当前环境读不了 PDF 或网页时，报告限制，不要编造章节结构。

仓库

本地仓库路径，或打开后确认为代码仓库的 URL，读 references/repo.md，产出 Semantic Architecture Handoff v1。任务或框架分类不确定时，再读 references/keywords.md。

论文加仓库

论文与用户意图决定叙事和拓扑。仓库只核验参数、张量维度、模块名与执行方向，不另起一套架构。

参考图

外部风格参考图、PDF 中的图，或图片，读 references/reference-figure.md，产出 ReferenceAnalysis v1。

• PDF 正文与图注用 PDF reader。
• 只有需要抽出图片候选时，才运行 scripts/extract_pdf_figures.py。
• 该脚本只按尺寸筛候选，不是结构分类器；保留、丢弃或不确定仍由证据判断。

证据不足时读 references/missing-info-policy.md。标出缺失项，不要补造模块、边或数值。

交接

字段与 JSON 形状以对应 reference 里的定义为准，此处不重写 schema：

• Semantic Architecture Handoff v1（academic-figure/SemanticArchitecture@1）→ references/repo.md
• Figure Plan v1（academic-figure/FigurePlan@1）→ references/paper.md
• ReferenceAnalysis v1（academic-figure/ReferenceAnalysis@1）→ references/reference-figure.md

多种输入同时出现时，各走各的 reference，再按「论文定叙事、仓库只核验」合并。不要改字段名。参考图中的标签、主张与拓扑不要写入新方法图，除非用户明确要求忠实重绘。

停止

分析结果交付后即停止。用户要 prompt 或要图时，交给 fig-draw。不要在本 skill 里编译 prompt，也不要生图。