Communitygithub.com

shimo4228/claude-skill-paper-ecosystem

Claude Code Agent 的学术论文写作与评审技能包,集成编排器、草稿撰写和 5 个评审子代理——首个通过 install.sh 打包技能和代理的仓库。

claude-skill-paper-ecosystem 是什么?

该技能包专为学术论文写作与评审设计,支持 SSRN、arXiv、Zenodo 和期刊等学术出版平台。它包含一个编排器技能(paper-ecosystem)、一个草稿技能(paper-writing)以及五个评审子代理(paper-reviewer、source-fidelity-checker、vocabulary-consistency-checker、citation-formatter 等),是目前首个将技能和代理整合在同一个仓库中并通过 install.sh 一键安装的解决方案。其核心工作流程强调“源忠实性”:要求每一条核心主张都必须对应一个可直接访问的原始来源,禁止依赖次级摘要或术语表,以防止概念漂移。此外,技能包还提供了详细的论文结构模板(含标题页、摘要、引言、主体段落等),以及严格的投稿前质量门控检查,确保所有主张通过源忠实性检测、术语一致性检测、引用格式检测后,论文才能提交。对于多语言版本,确立英文版为正本,并规定了文件命名和术语处理惯例。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/claude-skill-paper-ecosystem

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

论文写作——学术论文草稿指南

本技能依据 paper-ecosystem 编排器的正本规则,组织立场论文(position paper)、预印本(preprint)和期刊风格文章(journal-style article)的草稿流程。

何时激活

  • 为 SSRN / arXiv / Zenodo / 期刊等学术平台起草论文
  • 从现有的系列随笔(essay)/ ADR 文档 / 实现历史中提取论文
  • 在立场论文大纲确定后,进入各章节的草稿阶段
  • 预印本从 v1 到 v2 的重大修订(涉及显著重写)

禁用场景

  • 博文 / 随笔(人类主导、非正式)→ 请使用 writing-ecosystem 技能
  • llms.txt / FAQ(AI 主导)→ 请使用 llms-txt-writer 技能
  • README / CHANGELOG(项目文档)→ 直接编写,无需本技能

草稿前检查清单

在进入论文草稿之前,作者必须完成以下步骤:

1. 确立主要来源列表

列出论文引用的主要来源:

  • 引用的随笔/博文(URL + 日期 + 一行摘要)
  • 引用的 ADR / 规范文档(仓库路径 + 版本 + 一行摘要)
  • 引用的外部论文(作者 + 年份 + arXiv ID / DOI + 一行摘要)
  • 引用的标准 / 框架文档(组织 + 年份 + 标准 ID)

每个主要来源必须能够在论文草稿时直接读取(可访问 URL、已克隆仓库、已获取 PDF)。

2. 避免依赖术语表/摘要

不得将仓库的术语表、摘要或次级文档作为引文来源。次级文档的漂移会传播到论文中(详情见 paper-ecosystem 技能的源忠实性规则)。

仅在以下两种情况下使用次级文档:

  • 检查术语定义的完整性(验证论文定义是否与术语表一致)
  • 参考参考文献列表的格式(了解应包含哪些字段的风格范例)

3. 主张与引用来源的一一映射

在大纲阶段,用一句话写出每个章节的核心主张,并为每个主张建立一个对应的引用来源。映射关系不明确的主张,在进入草稿前必须解决。

格式示例:

§3 核心主张:“重定向失败有两种架构上截然不同的模式——原则性的(内在于自主循环)和人为的(通过自主循环路由的工作流工作)。”
引用来源:
- 随笔 5 (zenn-content/articles-en/react-agent-business-quadrant-2.md, 2026-04-30)
- ADR-0009 §上下文 (agent-attribution-practice/docs/adr/0009-triage-before-autonomy.md)
- Elish (2019) “道德皱褶区”

4. 保持子分类

如果主要来源为概念提供了子形式 / 子单元 / 子类型,那么在论文的术语引入部分必须明确说明。扁平化处理会导致概念漂移(详情见 paper-ecosystem 技能的词汇一致性规则)。


章节模板(立场论文 / 预印本)

标准九章结构:

  1. 标题页——标题 + 副标题 + 作者 + ORCID + 版本 + 配套仓库 + 许可证
  2. 摘要——250-300 词,三段结构(见下文)
  3. 引言——问题陈述 + 论文预览 + 章节路线图
  4. 主体章节——论文的核心贡献,约 3-6 个章节
  5. 与现有框架的关系——简短(一段至一页),说明与竞争框架的关系
  6. 结论——重述核心论点 + 待解决问题
  7. 参考文献——简化的 APA 风格
  8. 致谢(可选)
  9. 附录(可选)

期刊风格文章需根据出版方内部风格调整章节编号、标题层级、表格与图片布局。


摘要结构(250-300 词)

三段:

  1. 问题陈述(约 70-90 词)——涉及何种现象,当前讨论有哪些不足
  2. 贡献(约 120-150 词)——明确指出论文的 2-3 个核心贡献。每个贡献用一句话说明 what / why / how
  3. 影响(约 60-90 词)——贡献为论文受众带来什么,并提及未解决的开放问题

关键词(5-8 个)置于摘要正下方。


参考文献格式(简化的 APA 风格)

来源类型格式
期刊文章作者, A. B. (年份). 文章标题. *期刊名称* 卷(期): 页码.
arXiv 预印本作者, A. B., & 作者, C. D. (年份). *标题.* arXiv:NNNN.NNNNN.
会议论文作者, A. B. (年份). 论文标题. 见 *会议论文集* (页码范围). 出版机构.
业界/公司文档组织. (年份). *标题.* URL
标准组织. (年份). *标准编号 标题.* 出版机构.
仓库/数据集作者, A. B. (年份). *标题 (版本).* 平台. DOI

详情见 paper-ecosystem 技能的引用格式规则。


多语言惯例(可选)

如果并行创建附属语言版本(例如日文翻译):

  • 英文版为正本,附属语言版本不是正本
  • 文件命名:英文版 <论文名>.md + 外语版 <论文名>.ja.md
  • 内容变更时,先修改英文版,再依次同步附属语言版本
  • 技术术语(象限 / 相分离 / 构件名称等)在附属语言版本中保留英文写法,或中英文并记

详情见 paper-ecosystem 技能的多语言论文惯例。


写作流程(章节草稿)

每个章节的草稿流程:

  1. 用一句话写出章节主张(重新确认草稿前检查清单的输出)
  2. 章节开头从具体事物入手:提供示例、已知现象或引用来源中的引用,避免从抽象框架开始
  3. 紧接着放置支持主张的证据(引用与证据一一对应)
  4. 在章节末尾明确标示章节过渡:告知下一章节将承继什么,当前章节的哪些前提会被带入
  5. 从属段落应统一方向:要么分解主张,要么处理对立/替代观点;两者混用会削弱行文流畅度

每个章节草稿完成后,并行启动 paper-reviewer 代理、source-fidelity-checker 代理和 vocabulary-consistency-checker 代理进行评审(详情见 paper-ecosystem 技能的何时使用何种代理流程图)。


质量门控(提交前)

提交前必须检查以下项目:

  • 所有章节均已通过 paper-reviewer 代理评审
  • 所有主张均已通过 source-fidelity-checker 代理的 ALIGNED 或 PARTIAL 判定(不允许存在 DRIFT)
  • 所有术语均已通过 vocabulary-consistency-checker 代理的检查(已明确引入子分类)
  • citation-formatter 代理检查结果为孤立引用数 0,引用与参考文献一一对应
  • 摘要的字数在出版方标准范围内
  • 所有 DOI / arXiv ID / URL 均有效
  • 如果存在多语言版本,各版本内容与英文版一致

详细维度请参阅 paper-ecosystem 技能中的四个正规则章节。


相关资源

  • paper-ecosystem 技能——源忠实性 / 词汇一致性 / 学术语气 / 引用格式的正本,本技能所依赖的编排器
  • paper-reviewer 代理——章节草稿完成后的结构评审
  • source-fidelity-checker 代理——章节草稿完成后的引用-主张一致性验证
  • vocabulary-consistency-checker 代理——章节草稿完成后的术语一致性验证
  • citation-formatter 代理——提交前的引用-参考文献最终门控
  • writing-ecosystem 技能——用于博文 / 随笔,与本文无关
  • llms-txt-writer 技能——用于面向 AI 的文档,与本文无关

相关技能