agentic-ctx/skills/academic-figure-reviewer.md

Academic Figure Reviewer

用于审查或生成论文、技术报告、正式 slide 中的静态学术图。目标是让图可读、可复现、风格一致，并且能直接进入 LaTeX 或 slide。

Core Contract

• 一个脚本只产出一张论文图。
• 每张图同时输出 .pdf 和 .png。
• 图中所有样式来自 named constants，不在 draw 函数里写 magic numbers。
• 每个 Axes 都经过统一样式函数。
• 不在 committed script 中调用 plt.show()。

Canonical Script Shape

# Section 1: Imports
# Section 2: Style Config
# Section 3: Helpers
# Section 4: Draw Functions
# Section 5: Main

Style Rules

• 字体格式最多三种。大小变化、bold、italic 都算一种格式。
• 不重叠。legend、tick label、axis label、subplot 之间必须有可见 whitespace。
• 最小文字插入论文后应接近正文或 caption 可读大小。
• 颜色和 marker 从固定 palette 顺序取，不临时发明颜色。
• top/right spine 隐藏，保留 thin left/bottom spine。
• 图例默认无边框，用 whitespace 组织，而不是画框。
• 保存时使用 bbox_inches="tight" 和高 dpi PNG。

Review Inputs

• 图像文件、matplotlib 脚本、或 figure description。
• 目标载体：paper single-column / double-column / slide。
• 图要支撑的 claim。

Output

# Academic Figure Review

## Claim

## Blocking Issues

## Major Issues

## Minor Issues

## Required Edits

## Reproducibility Notes

Checklist

• 图的第一视觉焦点对应主 claim。
• caption/title 说结论，不只说图类型。
• 轴标签含单位。
• legend 不遮挡数据。
• tick label 不贴边、不挤、不旋转到难读。
• palette 对色盲友好；不用只靠颜色编码。
• 多子图共享风格、尺度和命名。
• 脚本可重跑，输入数据路径清楚。
• 输出 PDF 用于 LaTeX，PNG 用于预览或 slide。

Suggested Defaults

• FONTSIZE = 6.5 for single-column paper figures, then按目标模板微调。
• line width 约 0.7。
• marker size 约 1.5。
• 颜色顺序：blue, red, green, purple, orange。
• 对 CDF/line 图，优先清晰展示趋势和 tail，不用装饰性网格。