关于 paper-evidence-board
paper-evidence-board 是用于维护论文主张、证据、图表位置和审稿风险对应关系的研究工作流技能,面向论文撰写与投稿准备。它将证据缺口分类为实验、分析、改写、引用等后续行动,并可与项目记忆和相关技能协作。
主要功能
- 01提取论文主张并标注位置
- 02将证据映射到主张及图表
- 03分类证据缺口并安排行动
- 04整合审稿风险
- 05维护图表视觉风格记录
- 06将状态写回项目记忆
适用场景
- 01投稿前检查主张与证据是否对应
- 02新实验结果出现后更新论文结构
- 03确定缺口应由补实验还是改写解决
- 04把审稿意见转化为具体任务
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ a-green-hand-jack/ ml-research-skills --skill paper-evidence-board安装后在 Claude Code 中输入/paper-evidence-board确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/board-schema.mdevidence-gap-triage.mdpaper-section-map.mdreport-template.mdreviewer-risk-integration.mdupdate-protocol.md详细介绍
论文证据看板
维护研究项目面向论文的视图:论文提出了哪些主张、哪些证据支持这些主张、它们出现在哪里、审稿人可能会质疑什么,以及投稿前需要采取哪些行动。
在以下情况使用此技能:
- 写作时发现论文主张缺乏证据
- 新的实验结果需要更新论文叙述、图表或章节
- 模拟审稿后产生了实验或写作行动
- 投稿前需要使论文草稿中的主张与证据保持一致
- 需要将图表映射到论文主张
- 需要跟踪图表样式这一写作决策,包括调色板、标记、符号、排版,以及面向投稿场合的视觉惯例
- 用户想要一份持续更新的论文证据看板
- 项目需要判断某个缺口应通过补充实验、重写、缩小主张范围还是删减材料来解决
此技能比 research-project-memory 更具体:它以项目记忆作为跨组件事实来源,同时为写作和审稿决策创建面向论文的看板。
将此技能与以下技能配合使用:
research-project-memory:用于项目级的主张/证据/溯源/风险/行动/交接 ID 和回写paper-writing-memory-manager:当主张/证据变更应将论文位置标记为过时、更新依赖关系或创建写作线程时使用paper-evidence-gap-miner:当某项主张缺乏证据,且应先挖掘现有结果 CSV,再规划新的计算任务时使用paper-result-asset-builder:当需要将 CSV 结果转化为面向论文的表格、图表和溯源记录时使用conference-writing-adapter:当看板显示需要进行结构或段落层面的写作修改时使用experiment-design-planner:当看板发现缺少证据,需要开展新实验时使用result-diagnosis:当新证据削弱或使某项主张变得复杂时使用paper-reviewer-simulator:当需要从审稿人角度对看板进行压力测试时使用figure-results-review:当需要审查图表的主张支持、标题、统计或视觉样式时使用citation-coverage-audit:当发现创新性或相关工作方面的缺口时使用
技能目录结构
<installed-skill-dir>/
├── SKILL.md
└── references/
├── board-schema.md
├── evidence-gap-triage.md
├── paper-section-map.md
├── report-template.md
├── reviewer-risk-integration.md
└── update-protocol.md
渐进式加载
- 始终阅读
references/board-schema.md、references/evidence-gap-triage.md和references/update-protocol.md。 - 从草稿构建逐章节看板时,阅读
references/paper-section-map.md。 - 使用模拟审稿、真实评审意见或特定投稿场合的风险信息时,阅读
references/reviewer-risk-integration.md。 - 对内容较多的看板报告,使用
references/report-template.md。 - 当特定投稿场合的证据预期很重要时,核实当前投稿规则或审稿表。
核心原则
- 每项重要的论文主张都应标明论文位置、证据状态和审稿风险。
- 证据应指向源文件,而不只是文字记忆。
- 每张图表都应有明确用途:支持某项主张、回答审稿人的问题,或界定范围。
- 面向论文的图表还应遵循论文的视觉样式规范,而不只是展示正确的数值。
- 缺少证据不一定是写作问题;它可能需要实验设计、结果诊断、缩小主张范围或引用文献。
- 不要隐瞒负面或薄弱结果。应标明它们如何影响主张。
- 让看板具备可操作性:每个未解决的缺口都应指向后续技能或行动。
步骤 1 - 定位论文和项目记忆
查找:
- 论文根目录:
paper/、当前目录或用户提供的路径 - 项目根目录(如果不同)
memory/claim-board.mdmemory/evidence-board.mdmemory/provenance-board.mdmemory/risk-board.mdmemory/action-board.mdmemory/handoff-board.mdmemory/phase-dashboard.mdpaper/.agent/paper-status.md- 论文源文件,例如
main.tex、paper.tex、sections/*.tex、图表和附录
如果缺少项目记忆,仍应根据草稿构建论文看板,但建议初始化 research-project-memory。
Step 2 - 提取论文主张
阅读草稿或提供的笔记,并提取:
- 标题和摘要中的主张
- 引言中的贡献要点
- 方法主张
- 理论主张
- 实验主张
- 相关工作中的创新性边界
- 局限性和范围主张
分配或复用 CLM-### ID。对每项主张,记录:
- 论文中的确切位置
- 主张类型
- 强度
- 当前措辞风险
- 预期证据
- 现有证据
不要将抱负性的贡献表述视为已证实的证据。
Step 3 - 将证据映射到主张
阅读 references/board-schema.md。
对每项证据:
- 确定来源路径、运行 ID、表格、图、定理、引文或评审文本
- 关联主张 ID
- 标记状态:计划中、运行中、已观察、已报告、过时、矛盾或已删去
- 标记确定性:已观察、用户陈述、推断、过时或需要验证
- 说明局限性
如果证据仅存在于每日日志或聊天笔记中,应据此标记,并创建一项操作来验证源文件。如果证据可能存在于 CSV 结果文件中,但尚无面向论文的表格或图,则在将差距标记为需要新增计算之前,先交由 paper-evidence-gap-miner 和 paper-result-asset-builder 处理。如果证据变更会影响现有论文文本,则交由 paper-writing-memory-manager,将相关标题、摘要、章节、图注、局限性或结论标记为过时。
Step 4 - 构建章节和图表映射
阅读 references/paper-section-map.md。
创建:
- 章节映射:章节 -> 主张 -> 证据 -> 风险 -> 操作
- 图表映射:图表 -> 证据 -> 主张 -> 必需的图注信息 -> 过时状态
- 视觉风格映射:配色、方法与标记的对应关系、字体排版、符号、图形尺寸和表格规范
- 附录映射(如适用)
识别:
- 在多个位置重复出现但强度不一致的主张
- 没有对应主张的图
- 缺少预期的图、表、证明或引文支持的主张
- 新结果出现后已过时的图
- 论文图表中不一致的颜色、符号、方法名称、字号或图形尺寸
- 正文中未讨论的结果表
Step 5 - 对证据差距进行分诊
阅读 references/evidence-gap-triage.md。
对每项差距,确定应采取的处理方式:
mine-existing-results:需要paper-evidence-gap-miner在进行新计算前搜索现有 CSV、日志、报告和资源build-result-asset:需要paper-result-asset-builder将可复用的 CSV 证据制作为论文表格或图new-experiment:现有结果不足,需要交由experiment-design-planner处理result-diagnosis:现有结果含义不明确或存在矛盾rewrite:证据存在,但正文夸大了结论或掩盖了证据narrow-claim:证据只支持范围更小的主张citation-work:主张需要补充相关工作或出处说明cut:该主张不值得支持accept-risk:可以陈述局限性,而非解决该问题
每项高风险差距都应创建一项操作。
Step 6 - 整合评审风险
阅读 references/reviewer-risk-integration.md。
使用:
paper-reviewer-simulator模拟的评审风险citation-coverage-audit发现的引文风险rebuttal-strategist发现的真实评审风险- 已知的特定会议预期
将每项风险映射到:
- 主张
- 论文位置
- 证据差距
- 修复类型:实验、分析、证明、引文、改写、图表、局限性或回复审稿人
- 优先级
Step 7 - 生成看板和操作
使用 references/report-template.md 输出完整内容。
如果要保存到项目中,且未提供路径,则使用:
paper/.agent/paper-evidence-board.md
输出:
- 论文概览
- 主张-证据矩阵
- 章节映射
- 图表映射
- 视觉风格映射
- 证据差距
- 评审风险映射
- 行动计划
- 项目记忆回写
步骤 8 - 回写项目记忆
如果项目使用 research-project-memory,请更新:
memory/claim-board.md:主张状态、措辞、论文位置,以及弱化或删除的主张memory/evidence-board.md:证据来源路径、图表映射、过时状态和局限memory/provenance-board.md:从运行记录、CSV、报告、引用、图、表、图注和结果文本到EVD-###与CLM-###的可追溯性memory/risk-board.md:证据缺口、写作、新颖性、基线和审稿人风险memory/action-board.md:实验、诊断、改写、引用、图表和审阅操作memory/handoff-board.md:必须由另一项技能处理的证据缺口、素材构建需求、审阅修改或写作依赖memory/phase-dashboard.md:当主张支持力度变化足以推动项目阶段前进或倒退时,更新当前论文/证据关卡paper/.agent/paper-status.md:当前论文各部分的状态paper/.agent/visual-style.md:当视觉规范具有实质影响时,更新面向论文的图表样式政策paper/.agent/paper-evidence-board.md:面向论文的看板
不要重复冗长的实验报告。请添加报告链接。
最终检查
定稿前,请确认:
- 每项主要主张都有对应位置和证据状态
- 无证据支持的主张已标记为计划中、已缩小范围或已删除
- 每张主要图表都有对应主张的用途
- 面向论文的图表采用一致的颜色、标记、符号、字体、尺寸和记法
- 过时证据已标记
- 审稿人风险已关联到相应操作
- 后续操作已分配给合适的技能
- 存在项目记忆时,已更新项目记忆