mcpField
F
flow-paper-lifecycle

flow-paper-lifecycle

github.com/jurgendn生产力1146 次安装6 周前更新
代码仓库

关于 flow-paper-lifecycle

面向研究者的论文流程编排技能,管理从构想到成果发布的项目进程。它通过阶段门协调专用技能并确保工作围绕主张和证据展开,但不亲自进行构思、实验或写作。

主要功能

  1. 01贯穿论文 15 个阶段的路由
  2. 02从项目当前阶段继续
  3. 03为各阶段设置决策门
  4. 04协调专用研究技能
  5. 05分阶段提供写作指导
  6. 06检查投稿与成果发布准备情况

适用场景

  1. 01管理论文的端到端流程
  2. 02从已有项目阶段恢复工作
  3. 03检查证据是否支持论文主张
  4. 04准备投稿与成果发布

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jurgendn/agent-skills --skill flow-paper-lifecycle

安装后在 Claude Code 中输入/flow-paper-lifecycle确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
writing-drafting.md
writing-evidence.md
writing-logistics.md
writing-math-prose.md
writing-structure.md

详细介绍

论文生命周期编排器

推动论文从构想到成果发布。它的职责是了解项目处于哪个阶段、下一个决策是什么,以及该交给哪个单例,并把控阶段转换,避免论文建立在薄弱基础上就贸然推进(贡献尚未稳定前不写作;论断尚未隔离前不扩大规模)。此文件只负责排序和把关;不会亲自进行构思、实验或撰写。

如果只需处理一个独立阶段,请跳过编排器,直接调用相应技能。用户希望管理整个流程时,才使用此编排器。

开始前:找到项目

只询问无法推断的信息。你需要了解:

  • 当前阶段——构想、文献综述、实验进行中、已有结果、撰写中、评审中、已接收。这决定了入口;大多数项目并非从第 1 阶段开始。
  • 预期贡献——哪怕只有一句粗略表述。整个流程都是为了让一个论断站得住脚。
  • 目标会议 / 截止日期——这会影响研究范围、基线要求,以及每个阶段的投入程度。

如果目前还完全无法表述贡献,从第 1 阶段开始。如果已有表述但还不够稳妥,从第 2 阶段开始。

流程

按顺序执行;从项目实际所处阶段进入,并从最后一个尚未通过的关卡继续。

1 Frame the idea → 2 Stress-test → 3 Ground in literature → 4 Design experiments
→ 5 Plan evidence (baselines/ablations) → 6 Implement & run → 7 Analyze results
→ 8 Plan figures/tables → 9 Plan the argument → 10 Write sections
→ 11 Audit citations → 12 Submission readiness → 13 Target a venue
→ 14 Rebuttal → 15 Release artifacts
阶段 1 — 构思框定 → paper-idea-and-scope-brainstormer

将原始构想整理成范围明确的贡献和候选论文主线。 **关卡:**已有一句话贡献和大致研究范围。

阶段 2 — 压力测试 → research-idea-stress-test

在投入资源前,以低成本检验构想:找出隐藏假设、虚假新颖性,以及成本最低但能做出决定的实验。 **关卡:**构想经受住低成本证伪;机制 / 论断 / 贡献分别表述清楚。(在此阶段放弃或重新框定,可节省数月时间。)

阶段 3 — 以文献为依据 → literature-triangulation

构建有来源支撑的全景图:最接近的已有工作、方法类别、基准和真实分歧。避免声称已有贡献其实早已存在。 **关卡:**已确定最接近的基线;贡献已根据真实且经核实的已有工作完成定位。

阶段 4 — 设计实验 → experiment-design

在开展昂贵实验之前,设计满足决策需求的最小实验,并设置公平的对照和明确的成功标准。 **关卡:**已有可证伪的实验计划和可衡量的成功标准。

阶段 5 — 规划证据 → benchmark-and-baseline-selector + hypothesis-and-ablation-planner

确定论断所需的最低限度与建议采用的基线 / 基准,并设计消融实验以隔离因果机制,而非仅仅充实论文。(根据项目惯例,每份提案都要进行基线 / 基准检查。) **关卡:**已就最低限度的基线 + 基准组合达成一致;消融实验与具体的替代解释一一对应。

阶段 6 — 实现并运行 → research-codebase(根据需要使用 pytorch-training-recipe / jax-training-recipe)

为快速检验假设组织代码库并实现实验。如果运行异常——如发散、崩溃、增益可疑、怀疑数据路径有错误,或不确定「接下来调哪个参数」——请返回 experiment-design;其诊断流程会先检查数据路径,再判断模型是否有问题。 **关卡:**实验可复现地运行,并产出计划中要求的指标。

阶段 7 — 分析结果 → model-eval-error-analysis → results-writeup

检查方法在哪些方面有效、在哪些方面失败(切片、失败类别),然后将实验结果整理成清晰的结果叙述。涉及显著性论断时,使用 statistical-testing-guide。 **关卡:**结果支持(或推翻)论断;已理解显著性和失败模式,而不只是平均值。

阶段 8 — 规划图表 → figure-table-planner

确定哪些内容用图、哪些用表,设计消融表格,并撰写自包含的图注。 **关卡:**每个论断都有相应图表作为支撑;可视化证据与论断已建立对应关系。

阶段 9 — 规划论证 → paper-argument-planner

在起草正文之前,锁定论文主线——从问题到贡献的贯穿脉络。 **关卡:**主线稳定;贡献已确定。通过此关卡前不要撰写章节。

阶段 10 — 撰写章节(写作阶段组)

此阶段由此处负责,而非委派出去:它是一个分为四个子阶段、受关卡控制的写作教练。除非用户明确覆盖此规则,否则不要提前起草当前关卡之外的内容。按下文所述,将范围较窄的章节工作委派出去。

只询问一次目标发表渠道类型——定理证明型数学、ML 会议,或混合/应用型——并据此调整框架:数学论文突出定义、定理陈述、证明架构以及与已知结果的关系;ML 论文突出贡献要点、方法、实验、消融、基线、可复现性和局限;混合型论文则在主张到证据映射中同时保留定理与实证主张,避免一方掩盖另一方。

逐步加载参考文件:references/writing-structure.md(10a)、references/writing-drafting.md (10b)、references/writing-math-prose.md(10c)、references/writing-logistics.md(10d);提供引用/可读性/标题/摘要建议时,加载 references/writing-evidence.md。

证据标记。每条写作建议都要带一个标记:[EXPERT](写作技艺共识,未经实证确立)、[SUPPORTED](有实证支持)、[CONTESTED](证据相互矛盾或因领域而异)、[REFUTED](数据已推翻的传统说法)。绝不要把 [EXPERT] 规则说成实证事实;不确定时,标为 [EXPERT],或说明证据等级未知。

10a — 叙事与框架。在起草任何内容前,先要求用户写出一句贡献陈述:“本文通过 <核心机制/证据> 展示/提出/证明/引入了 <新事物>。” 如果用户无法陈述,就停下来,只处理这句话。构建主张到证据映射(主张 → 支持证据/证明/结果 → 章节)。只起草引言的框架,不写润色后的正文。[EXPERT] **关卡 10a:**已有一句话贡献陈述;每项贡献都有对应的支撑章节;只读引言的读者能够说出新意所在。

**10b — 起草。**先起草技术核心,再写结果,然后写引言,最后写摘要。将生成与修订分开——先留下占位符,不要在起草过程中润色或追查事实核查事项。起草第 N 节后,执行 Halmos 螺旋:根据第 N 节揭示的内容,重写第 1..N−1 节。委派给 abstract-and-intro-writer(摘要与引言应成对处理)、method-section-writer、related-work-writer(依据阶段 3 的映射,而非凭记忆撰写)以及 results-writeup(撰写经过核实的数值表述)。 [EXPERT] **关卡 10b(逐节):**每节在第一段说明其目的;除明确标注的占位符外,不依赖尚未撰写的内容;其中的主张均出现在主张到证据映射中。

**10c — 数学表述检查。**建立符号表(符号、含义、类型/定义域、首次定义处、冲突)。每个符号都要先定义后使用。在量词表示全称时,将含糊的 “any” 改为 “each”/“every”。每个定理陈述都必须能独立理解——假设应写在陈述中,而不只是放在前一段。每个非平凡证明都要用一句话说明证明思路。对于每个 “it is easy to see”、“clearly” 或 “by a standard argument”,都要给出论证、引用依据,或将其删除。[EXPERT] **关卡 10c:**符号表完整;没有未定义符号;每个定理都能单独重新阅读;每条包含 clearly/easy/standard 的主张都有依据、引用,或已删除。 10d — 草稿交接。 在最终排版前检查与投稿场所的匹配度(范围、 受众、页数限制、样式文件、匿名要求、补充材料规则、截止日期)。征求合作者签字确认:冻结版本、列出未解决的风险、明确请求批准,不得意外更改作者名单。对于期刊,准备简洁的投稿附信,说明匹配度和贡献,不要重新论证论文。对于 ML 投稿场所,附上可复现性检查清单(代码/数据、随机种子、硬件、 超参数、数据划分、评估脚本、许可证、计算资源)。[EXPERT] Gate 10d: 一份完整草稿,其中所有章节都服务于主线,并记录投稿场所匹配度、合作者签字确认和可复现性材料。

若未通过关卡,返回一份精简的通过/未通过检查清单,并为每项失败引用确切的违规文本;若缺少材料,则引用缺失项的名称。

阶段 11 — 审核引用 → citation-auditor

验证参考文献确实存在、论述与来源相符,且没有幻觉或错误归因。 Gate: 已核实参考文献列表和文内引用。

阶段 12 — 投稿准备度 → submission-readiness-audit(+ professor-critic)

根据投稿场所的要求检查完整性、格式、论述与证据是否相符,以及可复现性声明。对于 OpenReview 时代的 ML/NLP/CV/AI 投稿场所,审核须明确涵盖审稿人可见的风险:缺乏支持的论述、创新点含糊、缺少明确列出的基线、可复现性漏洞、局限性/伦理问题、数据归属说明以及引用可靠性。然后进行清单无法完成的对抗性审查:将草稿交给 professor-critic,指定读者为“目标投稿场所中研究竞争方法的审稿人 2”,评判标准为“接收 / 大修 / 拒稿”——先给出结论,再进行彻底批评,在真正的审稿人发现之前揭示致命异议。(submission-readiness-audit 根据要求检查论文;professor-critic 模拟敌意读者。不要使用 peer-review-writer——它用于评审他人的论文。) Gate: 草稿通过投稿前审核,并且经受住对抗性审稿,没有未解决的致命问题。

阶段 13 — 选择投稿场所 → venue-targeting

为论文匹配投稿场所,并根据其惯例调整框架/范围(若提前运行,也可为早期阶段提供参考)。 Gate: 已选定目标投稿场所,并据此调整了论文框架。

阶段 14 — 回复审稿意见 → reviewer-response-strategist

收到审稿意见后,规划回复策略和任何补充实验。对于 OpenReview 式讨论期,回应关键问题,承认已解决的问题,在证据变化时更新论述或实验,并避免转移评判标准。 Gate: 回复计划涵盖了每位审稿人的关键问题。

阶段 15 — 发布材料 → artifact-release-packager(+ reproducibility-audit)

决定发布哪些内容并打包;审核结果是否确实可复现。 Gate: 发布的材料能够支撑论文论述,并复现其关键结果。

路由规则

  • 委派,不要重复。 每个阶段都交由一个专属负责人处理;本文件负责流程排序和关卡。阶段 10 是唯一例外——写作阶段由本文件负责,因为它的关卡与整个流程的关卡相同;但具体章节工作仍会委派给其他负责人。
  • 接续,不要重启。 从项目实际所处的阶段进入;从上一个尚未通过的关卡继续。
  • 阶段 10 之前必须通过硬性关卡。 论点/主线(阶段 9)稳定之前,不要开始写章节——基于不稳定的贡献起草最浪费时间。
  • 可以自由回退。 结果不理想(7)时,可以让项目退回设计阶段(4),甚至重新构思(2)。回退很正常,不代表失败。
  • 可以提前确定投稿 venue。 如果截止日期固定,先运行阶段 13,让其规范影响范围和基准。
  • 评审他人的论文是另一条流程。 如果用户担任评审,请转交给 peer-review-writer。
  • 在达到用户目标时停止。 并非每个项目都需要一次完成阶段 13–15。

评论

支持 Markdown