关于 figure-table-planner
figure-table-planner 是面向研究者的论文写作技能,用于在已有结果后规划证据呈现。它将论文主张对应到图表,并检查每项材料是否支撑论证。
主要功能
- 01主张与图表对应
- 02选择图表类型
- 03规划正文与附录材料
- 04图注检查清单
- 05检查统计与视觉规范
适用场景
- 01安排论文结果的呈现
- 02精简重复的图表
- 03规划消融与失败案例证据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jurgendn/ agent-skills --skill figure-table-planner安装后在 Claude Code 中输入/figure-table-planner确认已加载。
附带文件evals/evals.json
详细介绍
图表规划器
图和表构成论文的证据架构。好的论文不会让读者从一堆图表中自行推断论点,而是展示足以让读者相信各项主张的最少证据。
适用场景
- 用户已有实验结果,需要决定如何呈现。
- 论文草稿中的表格过多、图表冗余或图注不清晰。
- 核心主张缺少清晰的图表证据。
- 用户需要规划主文与附录中的证据。
- 用户想规划消融实验、诊断分析、失败案例或规模变化图。
不适用场景
- 用户需要决定要开展哪些实验。请使用
experiment-design或hypothesis-and-ablation-planner。 - 用户需要撰写结果章节的正文。证据布局明确后,请使用
results-writeup。 - 用户需要绘图代码的实现细节,除非他们明确要求提供代码。
工作流
1. 先列出主张
规划图表前,先提取论文的主张:
- 核心实证主张
- 机制或消融主张
- 鲁棒性或普适性主张
- 效率或成本主张
- 定性结果或失败模式主张
- 理论或概念主张
每个图或表都必须有其支持的主张。
2. 选择合适的证据形式
选择最便于读者判断比较结果的形式:
- 表格 — 精确比较不同方法、数据集、指标或消融实验。
- 折线图 — 展示随规模、时间、数据量、计算量或超参数变化的趋势。
- 柱状图 — 展示类别较少且精确数值不太重要的比较。
- 散点图 — 展示两个连续变量之间的关系。
- 示意图 — 展示方法结构、流程或概念性贡献。
- 示例网格 — 展示定性输出、失败模式或可解释性案例。
- 附录表格 — 展示详尽结果,为论文主要论述提供支持,但不承担核心论证。
读者需要精确数值时,优先使用表格。主张涉及形态或趋势时,优先使用图表。
3. 规划主文中的证据
力求形成简洁的顺序:
- 如果贡献在结构上难以理解,先放置方法或问题示意图。
- 放置支持核心主张的主要结果表格或图表。
- 放置支持机制主张的消融表格或图表。
- 加入鲁棒性或失败分析,明确主张的适用边界。
- 仅当效率属于贡献的一部分时,才加入效率或资源相关证据。
如果两个证据形式以相同方式支持同一主张,就将它们合并,或将其中一个移至附录。
4. 明确图注的作用
图注应告诉读者该关注什么,以及图表证明了什么。
图注检查清单:
- 写明实验设置和指标
- 陈述主要结论
- 在适用时说明数值越高或越低越好
- 定义缩写
- 在相关时说明不确定性或实验运行次数
- 不夸大图表所展示的内容
5. 检查统计与视觉规范
检查以下问题:
- 缺少基线
- 指标不一致
- 坐标轴或单位不清晰
- 标签难以辨认
- 变异较重要时未提供置信区间或标准差
- 挑选有利示例
- 仅用颜色区分,未添加标签
- 正文未引用附录中的图表
输出格式
# Figure/Table Plan
## Claim-to-artifact map
| Claim | Artifact | Type | Main/appendix | Status |
|---|---|---|---|---|
## Recommended main-paper sequence
## Appendix evidence
## Caption drafts
## Redundant or missing artifacts
## Visual/statistical risks
质量标准
读者应能快速浏览图、表和图注,无需通读每个段落,就能理解论文的论证。
评论
支持 Markdown