SuperAPI AI 工具集

paper-result-asset-builder

写作与研究

查看项目

更新于 10-13 14:58

技能介绍

Paper Result Asset Builder 用于把 CSV 实验结果输出转成论文面向的证据资产,包括表格、图表、标题/标注与溯源记录,是从原始结果文件到论文产物的桥梁。

用途

该技能适用于以下任务:盘点 CSV 结果文件及其列、指标、方法、数据集、随机种子与运行标识;判断哪些 CSV 切片可支撑某项论文主张;生成或更新 tables/.tex、figures/.pdf、figures/.png 与 figures/.tex;记录过滤、聚合、取整、加粗、绘图与溯源规则;区分论文面向可视化与实验期调试图;为 table-results-review、figure-results-review 与 experiment-story-writer 准备资产。

该技能不用于判断论文主张是否值得提出,此类判断应使用 paper-evidence-board 或 paper-evidence-gap-miner;不用于撰写结果叙述,应等资产存在后使用 experiment-story-writer;也不适用于实验期调试仪表盘。

技能目录结构

已安装技能目录包含:SKILL.md;scripts/inventory_csv_results.py;references/csv-result-contract.md 与 references/paper-asset-rules.md;templates/plot_style.yaml、templates/result-inventory.md 与 templates/result-asset-provenance.md。

渐进式加载

始终阅读 references/csv-result-contract.md 与 references/paper-asset-rules.md。在把大型结果文件读入上下文前,使用 scripts/inventory_csv_results.py 检查 CSV 文件。创建 paper/.agent/result-inventory.md 时使用 templates/result-inventory.md;创建 paper/.agent/result-asset-provenance.md 时使用 templates/result-asset-provenance.md;初始化 code/config/plot_style.yaml 用于论文面向图表生成时使用 templates/plot_style.yaml。在存在时,阅读本地 paper/.agent/writing-contract.md、paper/.agent/paper-evidence-board.md、paper/.agent/writing-memory/、paper/.agent/evidence-completion-plan.md、paper/.agent/visual-style.md、paper/.agent/style-lessons.md、code/config/plot_style.yaml、figures/.tex、tables/.tex 以及当前结果章节。

核心原则

论文资产用于支撑主张,而不是堆砌所有可用结果。CSV 文件是源证据;论文中的表格和图表是这些源的策展视图。实验期可视化与论文面向可视化是不同产物。论文面向资产可能被共同作者、审稿人、arXiv 或出版商看到;CSV、绘图脚本、notebook、溯源台账与内部诊断图默认是私有的,除非明确为这些受众清理。每个表格或图表都需要源 CSV 路径、过滤规则、聚合规则、指标方向、取整、样式与主张映射。样式应来自论文/项目约定;若 paper/.agent/visual-style.md 或 code/config/plot_style.yaml 已定义,就不要自创每脚本的字体大小、图例大小、颜色或导出格式。优先复用已有 CSV 结果,再请求新的计算。绝不在没有溯源的情况下静默手工输入数字。如果资产需要缺失的结果,先路由到 paper-evidence-gap-miner,而不是编造占位符。构建资产后,路由到 table-results-review 或 figure-results-review。

步骤 1 - 定位 CSV 结果源

搜索可能位置:code/docs/results//*.csv、code/docs/runs//.csv、code/docs/reports/**/.csv、code/outputs//*.csv、code/results//.csv、outputs/**/.csv、results/**/*.csv。如果项目使用不同的结果路径,遵循用户路径。需要时运行盘点脚本:python3 <installed-skill-dir>/scripts/inventory_csv_results.py <project-dir>。将策展后的盘点保存到 paper/.agent/result-inventory.md;如果没有 paper/ 目录且当前目录是论文仓库,则保存到 .agent/result-inventory.md。

步骤 2 - 定义论文资产任务

对每个请求的表格或图表,写明:Asset ID、Asset type(table / figure)、Paper location、Claim supported、Reviewer question answered、Source CSV files、Required rows/slices、Metrics、Aggregation、Uncertainty、Styling、Output paths。如果无法写出这些,路由到 paper-evidence-board 或 paper-evidence-gap-miner。

步骤 3 - 构建表格或图表视图

使用结构化 CSV 解析,而不是临时复制粘贴。

表格:围绕读者比较路径选择行与列分组;在取整前聚合随机种子/重复;定义加粗/下划线与缺失值规则;适当时加入指标方向箭头;输出独立 tables/<name>.tex;除非项目明确选择发布,源 CSV 与生成脚本应留在作者可见/公开论文源之外。

图表:根据主张选择绘图类型——柱状图、折线图、散点图、热力图、帕累托前沿、校准曲线、切片图、定性网格或附录诊断;存在时应用 paper/.agent/visual-style.md 与 code/config/plot_style.yaml,若两者都存在,将 Markdown 文件视为论文面向理由,YAML 文件视为机器可读生成约定;尽可能按最终插入尺寸生成图表,以免 LaTeX 大幅缩放字体、线宽、标记或图例间距;坐标轴标签、刻度标签、图例、注释、面板标签、线宽、标记大小、导出格式与 DPI 来自样式约定,或记录为有意本地设置;导出稳定论文资产如 figures/<name>.pdf,可选 figures/<name>.png;输出带标题与标签脚手架的 LaTeX 包装 figures/<name>.tex;默认将私有绘图代码、notebook 与调试图排除在作者可见/公开源之外。

步骤 4 - 记录溯源

更新 paper/.agent/result-asset-provenance.md。对每个资产记录:源 CSV 路径与文件哈希(可行时);run IDs、配置、随机种子、数据集、划分、方法与指标;过滤与聚合代码或确切规则;取整与加粗规则;绘图参数与视觉样式决策;样式约定来源,包括与 paper/.agent/visual-style.md 或 code/config/plot_style.yaml 的任何偏差;手工编辑(如有);主张 ID 与论文位置;不确定性或缺失溯源。

步骤 5 - 交接给审查与写作

创建资产后:对 tables/.tex 使用 table-results-review;对 figures/.pdf、figures/.png 与 figures/.tex 使用 figure-results-review;对结果正文使用 experiment-story-writer;用资产到主张的映射更新 paper-evidence-board;当新增或变更资产影响标题、结果正文、摘要、引言、局限性或结论时,更新 paper-writing-memory-manager;项目记忆存在时,用 CSV/报告到资产的追踪、聚合规则、脚本与论文位置更新 memory/provenance-board.md;当生成的资产面向作者可见、匿名、arXiv、camera-ready 或出版商可见源表面时,更新 memory/source-visibility-board.md 或路由到 submit-paper;用就绪的交接更新 memory/handoff-board.md,交给 figure-results-review、table-results-review、experiment-story-writer 或 paper-evidence-board;当项目从证据生产进入论文资产构建或起草时,更新 memory/phase-dashboard.md。

最终检查

定稿前:每个数字或绘图点都能追溯到 CSV 源;过滤与聚合规则明确;论文面向视觉样式与实验期可视化分离;图表排版、尺寸、图例、线宽、标记大小与导出格式遵循样式约定或有明确本地例外;输出文件是论文就绪资产,不是原始调试图;表格/图表任务映射到某项主张或审稿人问题;缺失结果被路由到 paper-evidence-gap-miner;溯源已保存或返回;私有源文件如 CSV、notebook、绘图脚本与溯源台账未被放入可见论文源,除非有意清理。