mcpField
P
paper-evidence-board

paper-evidence-board

github.com/a-green-hand-jack生产力53 次安装
代码仓库

关于 paper-evidence-board

paper-evidence-board 是用于维护论文主张、证据、图表位置和审稿风险对应关系的研究工作流技能,面向论文撰写与投稿准备。它将证据缺口分类为实验、分析、改写、引用等后续行动,并可与项目记忆和相关技能协作。

主要功能

  1. 01提取论文主张并标注位置
  2. 02将证据映射到主张及图表
  3. 03分类证据缺口并安排行动
  4. 04整合审稿风险
  5. 05维护图表视觉风格记录
  6. 06将状态写回项目记忆

适用场景

  1. 01投稿前检查主张与证据是否对应
  2. 02新实验结果出现后更新论文结构
  3. 03确定缺口应由补实验还是改写解决
  4. 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.md
evidence-gap-triage.md
paper-section-map.md
report-template.md
reviewer-risk-integration.md
update-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.md
  • memory/evidence-board.md
  • memory/provenance-board.md
  • memory/risk-board.md
  • memory/action-board.md
  • memory/handoff-board.md
  • memory/phase-dashboard.md
  • paper/.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:面向论文的看板

不要重复冗长的实验报告。请添加报告链接。

最终检查

定稿前,请确认:

  • 每项主要主张都有对应位置和证据状态
  • 无证据支持的主张已标记为计划中、已缩小范围或已删除
  • 每张主要图表都有对应主张的用途
  • 面向论文的图表采用一致的颜色、标记、符号、字体、尺寸和记法
  • 过时证据已标记
  • 审稿人风险已关联到相应操作
  • 后续操作已分配给合适的技能
  • 存在项目记忆时,已更新项目记忆

评论

支持 Markdown