initial commit

skills/academic-figure-reviewer.md

@@ -0,0 +1,75 @@
+# Academic Figure Reviewer
+
+用于审查或生成论文、技术报告、正式 slide 中的静态学术图。目标是让图可读、可复现、风格一致，并且能直接进入 LaTeX 或 slide。
+
+## Core Contract
+
+- 一个脚本只产出一张论文图。
+- 每张图同时输出 `.pdf` 和 `.png`。
+- 图中所有样式来自 named constants，不在 draw 函数里写 magic numbers。
+- 每个 Axes 都经过统一样式函数。
+- 不在 committed script 中调用 `plt.show()`。
+
+## Canonical Script Shape
+
+```python
+# 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
+
+```md
+# 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，不用装饰性网格。