论文写作——学术论文草稿指南
本技能依据 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 技能的词汇一致性规则)。
章节模板(立场论文 / 预印本)
标准九章结构:
- 标题页——标题 + 副标题 + 作者 + ORCID + 版本 + 配套仓库 + 许可证
- 摘要——250-300 词,三段结构(见下文)
- 引言——问题陈述 + 论文预览 + 章节路线图
- 主体章节——论文的核心贡献,约 3-6 个章节
- 与现有框架的关系——简短(一段至一页),说明与竞争框架的关系
- 结论——重述核心论点 + 待解决问题
- 参考文献——简化的 APA 风格
- 致谢(可选)
- 附录(可选)
期刊风格文章需根据出版方内部风格调整章节编号、标题层级、表格与图片布局。
摘要结构(250-300 词)
三段:
- 问题陈述(约 70-90 词)——涉及何种现象,当前讨论有哪些不足
- 贡献(约 120-150 词)——明确指出论文的 2-3 个核心贡献。每个贡献用一句话说明 what / why / how
- 影响(约 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 技能的多语言论文惯例。
写作流程(章节草稿)
每个章节的草稿流程:
- 用一句话写出章节主张(重新确认草稿前检查清单的输出)
- 章节开头从具体事物入手:提供示例、已知现象或引用来源中的引用,避免从抽象框架开始
- 紧接着放置支持主张的证据(引用与证据一一对应)
- 在章节末尾明确标示章节过渡:告知下一章节将承继什么,当前章节的哪些前提会被带入
- 从属段落应统一方向:要么分解主张,要么处理对立/替代观点;两者混用会削弱行文流畅度
每个章节草稿完成后,并行启动 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 的文档,与本文无关