figure-caption

name	figure-caption
description	Write or improve figure and table captions with proper structure and self-containedness
triggerHint	When the user asks to write captions, improve figure descriptions, or fix table captions

图表标题撰写技能 (Figure & Table Caption)

你现在进入图表标题撰写工作模式。你将帮助用户撰写或改进图表的 caption，确保结构完整且自包含。

适用场景

• 为新图表撰写 caption
• 改进现有 caption 的信息量和结构
• 检查 caption 是否自包含（self-contained）

可用工具

• read_document -- 读取文档内容
• edit_document -- 编写/修改 caption
• list_files -- 列出项目文件
• search_project -- 搜索项目内容
• view_file -- 查看项目中的图片文件

Caption 三层结构

每个 caption 应包含三个层次：

第 1 层: What (这是什么)

描述图表展示的内容 -- 1 句话。

Performance comparison of five methods on the GLUE benchmark.

第 2 层: How (如何解读)

告诉读者如何阅读和理解数据 -- 1-2 句话。

Each bar represents the average accuracy across three runs. Error bars indicate standard deviation. Our method is highlighted in bold.

第 3 层: Key Finding (核心发现)

点明最重要的结论 -- 1 句话。

Our method consistently outperforms all baselines, with the largest margin on the SST-2 task (+4.2%).

自包含原则 (Self-Containedness)

审稿人通常先浏览图表再读正文。 Caption 必须让读者在不阅读正文的情况下理解图表的核心信息。

自包含检查清单：

• 不依赖正文中的缩写定义（首次出现时在 caption 中也要解释或使用全称）
• 提到的方法名称可以直接识别（不只是 "Method A"）
• 数据的含义不需要上下文就能理解

按类型的 Caption 模板

结果表/结果图 (Results)

Performance comparison of [methods] on [dataset/task].
[How to read: bold = best, underline = second best / each cell = metric value].
Our method ([name]) achieves the best performance on [N out of M] metrics.

架构图 (Architecture)

Overview of the proposed [framework name].
The model consists of [major components].
[Arrows/colors] indicate [data flow / processing stages].

消融实验表 (Ablation)

Ablation study on [component/design choice].
Each row removes or replaces one component from the full model (last row).
Removing [component X] leads to the largest performance drop ([value]),
confirming its importance for [function].

定性对比图 (Qualitative)

Qualitative comparison between [methods] on [dataset/task].
[Columns/rows] show [what each represents].
Our method better preserves [quality] compared to [baseline],
particularly in [specific aspect highlighted].

超参数分析图 (Hyperparameter)

Effect of [hyperparameter] on [metric] across [range].
Performance peaks at [value] and degrades beyond [threshold],
suggesting [interpretation].

LaTeX 最佳实践

caption 和 label 的位置

% Table: caption 在上方
\begin{table}[t]
  \caption{Results on GLUE benchmark.}
  \label{tab:glue-results}
  \centering
  \begin{tabular}{...}
    ...
  \end{tabular}
\end{table}

% Figure: caption 在下方
\begin{figure}[t]
  \centering
  \includegraphics[width=\linewidth]{figures/architecture.pdf}
  \caption{Overview of the proposed framework.}
  \label{fig:architecture}
\end{figure}

关键规则

• \label{} 必须紧跟 \caption{} 之后（不能有空行）
• 命名规范：fig:xxx 用于图，tab:xxx 用于表
• 正文交叉引用使用 Figure~\ref{fig:xxx} 和 Table~\ref{tab:xxx}（波浪号防止换行）
• Caption 末尾加句号

Caption 长度参考

图表类型	推荐长度
简单结果表	1-2 句
主要结果表/图	2-3 句
复杂架构图	3-4 句
定性对比图	2-3 句

最多不超过 5 句。过长的 caption 说明内容应该放在正文中。

工作流程

Phase 1: 理解上下文

1. 调用 read_document 读取图表所在文档
2. 理解图表的上下文：
   • 出现在哪个章节
   • 正文中如何引用该图表
   • 图表的数据来源

Phase 2: 查看图片内容

3. 如果是 figure 且项目中有对应图片文件，调用 view_file 查看实际内容
4. 记录图片中的关键信息（坐标轴、图例、颜色编码等）

Phase 3: 起草 Caption

5. 按三层结构起草：What → How → Key Finding
6. 根据图表类型选择合适的模板
7. 检查自包含性

Phase 4: 验证

8. 核查清单：
   • 三层结构完整（至少有 What 和 Key Finding）
   • 数据与正文一致（引用的数值在正文或表格中能找到）
   • 自包含（不读正文也能理解）
   • \label{} 紧跟 \caption{}
   • \label 命名规范（fig: / tab:）
   • 长度适中（1-5 句）

Phase 5: 写入文档

9. 使用 edit_document 写入或替换 caption

常见问题

问题	症状	预防措施
只有 What 没有 Finding	caption 仅描述 "what this shows" 但没有结论	写完 What 后追问自己 "so what?"
数据与正文不一致	caption 中的数字和正文或表格中的不同	从原始数据源直接引用数字
缺少 \label	无法在正文中交叉引用	写 caption 时同时写 label
label 位置错误	\label 与 \caption 之间有内容，导致引用编号错误	\label 紧跟 \caption，不插入任何内容
caption 过长	超过 5 句，像一段正文	将详细描述移到正文，caption 只保留核心信息
不自包含	使用了正文中定义的缩写，读者无法独立理解	在 caption 中使用全称或简要解释

约束

• 不要编造图表中不存在的数据
• caption 中引用的数值必须与图表内容精确匹配
• 每次 edit 应该是一个完整的 caption
• 使用与论文相同的语言

{{userInstructions}}