SuperAPI AI 工具集

figure-qa

写作与研究

查看项目

更新于 10-16 06:50

技能介绍

用途:对科研图表做期刊投稿前的 QA,检查是否符合期刊要求、配色是否正确、文字是否清晰。触发语包括“QA this figure”“check this…”。

主要能力:由独立的全新上下文审查者执行,先识别输入类型,再用辅助脚本运行确定性检查(字体、配色、几何、透明度、分辨率、渲染文字),并加入视觉语言模型(VLM)对美学维度做评分。该技能本身是轻量调度器,检测逻辑、退出码约定、VLM 评分标准、报告格式和迭代循环都在 references/ 中,确定性引擎位于 figures 插件的 agents/figure-qa-scripts/。

使用方式:在图表需要投稿 QA 时启用,或在 figures 系列技能产出后启用,除非调用方传入 no-qa。每次调度需携带相同简报:图表路径与已知输入类型、目标期刊(nature、science、cell、pnas、poster、slide 或 generic)、主题路径 figures/theme.json(用于按项目规范判断配色)、图表被要求渲染的所有原样字符串(标题、面板字母、标签;缺少该列表则栅格文字检查静默关闭)、栅格输入的物理宽度(毫米,用于将文字高度换算为点)。

调度分支:Claude Code 使用 Agent(subagent_type: "figures:figure-qa", ...);Codex CLI 需先将 ${CLAUDE_PLUGIN_ROOT}/agents/templates/figure-qa.toml 复制到 ~/.codex/agents/ 或 .codex/agents/ 再调用;Copilot CLI 通过 .github/plugin/plugin.json 暴露的 .agent.md 审查者调用,或复制 agents/templates/figure-qa.agent.md 到 .github/agents/ 或 ~/.copilot/agents/;无子代理支持时走回退分支,先定位 references 目录,找不到则提示安装 figures 插件。

报告与循环:报告保留 markdown 分节,末尾附一个围栏 JSON 块,含 status(ship、revise、block)、findings[](check、severity、message、action、hint)、measurements 和五项 VLM 分数。references/iterate-loop.md 定义生成、QA、修复、再生成的循环(并行 N 个候选,每次迭代只做一处针对性修改,达到 ship 或三次迭代后停止)。

限制:需要 figures 插件及其脚本;无子代理时需手动定位 references;栅格文字检查依赖传入的渲染字符串列表;具体期刊规则与评分细节以 references 文件为准,资料未提供更多实现细节。