paper-explain-figures

name	paper-explain-figures
description	解读论文 Figure 的含义并输出一份“教会人类如何读图”的高可读性 Markdown 报告；支持输入 1 个或多个 figure 文件绝对路径与人工解读，自动尝试从图附近检索生成该图的源代码，并采用类似 parallel-vibe 的方式通过 `codex exec`/`claude -p` 以进程级隔离解读每张图（并发上限默认 3，可在 config.yaml 调整）。⚠️ 不适用：用户只是想改图尺寸/裁剪/改格式；或要求直接修改图片/源代码（本 skill 对图片与源代码全程只读，严禁修改）。
metadata	{"author":"Bensz Conan","keywords":["paper-explain-figures","explain-figures","paper reading","figure interpretation","vision","codex exec","claude -p"]}

paper-explain-figures

BenszAPI 任务工作区

本 Skill 的新任务中间文件统一写入 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/{skill名}/input|output|log/。同一任务复用一个任务根目录；多 Skill 协作才创建 shared/。正式交付物不写入该目录，历史隐藏目录只允许显式兼容读取、迁移或清理。

与 bensz-collect-bugs 的协作约定

• 因本 skill 设计缺陷导致的 bug，先用 bensz-collect-bugs 规范记录到 ~/.bensz-skills/bugs/，不要直接修改用户本地已安装的 skill 源码；若有 workaround，先记 bug，再继续完成任务。
• 只有用户明确要求“report bensz skills bugs”等公开上报时，才用本地 gh 上传新增 bug 到 huangwb8/bensz-bugs；不要 pull / clone 整个仓库。

目标

对用户提供的 1 张或多张论文 Figure：

• 将 Figure 转为 .jpg（用于视觉理解；转换失败则保留原图并显式说明）
• 在 Figure 附近自动检索“生成该图的源代码”（可能找不到；找不到则为 NULL）
• 综合三类信息输出可读性强的报告：
  • 理解 1：视觉理解（从 jpg/原图直接读图）
  • 理解 2：源代码理解（以代码为准；代码决定图的真实含义）
  • 理解 3：用户人工解读（帮助猜测用户关注点；可能有误）

强约束（必须遵守）

• 目录管理硬约束：所有中间产物必须托管在当前工作目录下的隐藏目录 .bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/paper-explain-figures/（该目录名在脚本中硬编码；不允许改到别处）。
• ：runner / 图片转换器产生的 HOME、TMP、XDG cache/state/config 等运行时辅助文件，也必须重定向并收纳到 内。