academic-writing:把学术写作规范固化进 SKILL.md

前言

给 Agent 喂一篇论文初稿,最常见的失败不是写得不通顺,而是引用对不上:正文里标了 [1],参考文献里找不到这条;或者把博客、维基百科当学术来源引了进去。通用模型知道学术写作大概长什么样,但不会自己守住一套固定规范。下面介绍的 academic-writing 就是一个把规范写进 SKILL.md 的 Skill,用来约束 Agent 在论文、文献综述、研究方法、学位论文这几种写作任务里的输出格式和引用行为。

这是什么

academic-writing 是 teamolab 发布在 ClawHub 上的 Skill,坐标 @teamolab/academic-writing,当前版本 v1.0.0,许可证 MIT-0。官方简介是:擅长学术写作,包括论文、文献综述、研究方法及论文撰写,严格遵守学术规范和引用标准。

它解决的问题不是”帮我润色一句话”,而是给 Agent 一份可复用的操作规程:用什么格式输出、引用哪些来源、正文里的引用标注怎么编号、参考文献列表怎么排、表格和图怎么处理。这份规程写在 SKILL.md 里,SkillHub 页面标注分类为 professional。

该 Skill 无需 API Key,安全审计结果为 Pass。SkillHub 页面显示评分 100000、下载 31827、安装 2155。

核心能力

SKILL.md 里的能力约束是分层次写的,下面按主题拆开。

输出格式

  1. 全部写作输出使用 Markdown。
  2. 正文主体内容用标签包裹,与开头、结尾的说明性文字区分开,方便直接取用核心信息。
  3. 输出语言与用户提问语言保持一致;除专有名词和不可翻译的术语外,不出现中英混排。

学术诚信

SKILL.md 明确写了一条硬约束:不得编造数据、证据或引用,所有参考文献必须是真实且可验证的。这条写在 Core Requirements 里,意味着它在每次输出前都会被 Agent 重新读到,比口头提醒可靠。

引用规范

引用来源的范围被限定在同行评审期刊论文、会议论文集、学术专著、官方报告、学位论文这几类。明确禁止的来源包括博客、CSDN、个人网站、维基百科、新闻文章(除非用于时事分析场景)。推荐检索的数据库是 arXiv、PubMed、IEEE Xplore、ACM Digital Library、SpringerLink、ScienceDirect 等学术库。

正文标注用方括号数字,从 [1] 开始连续编号,放在被引陈述之后或句末。SKILL.md 给的示例:

Deep Diffusion Models Achieve Data Generation by Defining a Forward Diffusion Process and Learning an Inverse Denoising Process[1]。

参考文献列表固定以 “References” 小节收尾,格式为:

[1] Author(s). (Year). Title of the paper. Journal/Conference Name, Volume(Issue), Page numbers. URL

示例条目:

[1] Ho, J., Jain, A., & Abbeel, P. (2020). Denoising diffusion probabilistic models. Advances in Neural Information Processing Systems, 33, 6840-6851. https://arxiv.org/abs/2006.11239

内容结构

比较性数据、多属性信息或需要系统化呈现的内容,用 Markdown 表格,且表格内数据必须有出处。需要可视化表达时用 Mermaid 生成图,图中的数据同样要求准确并标注引用。

行文层面要求保持正式学术语气,用词精确,章节划分清晰,包含 introduction、methodology(如适用)、main content、conclusion 的完整链路。

交付前自检

SKILL.md 末尾列了四条检查项,Agent 在给出最终回复前应逐条过一遍:

  1. 核实所有引用链接指向合法学术来源;
  2. 确认引用编号从 [1] 起连续无跳号;
  3. 确认参考文献列表格式符合规定;
  4. 确认全文语言一致。

安装与启用

官方安装命令走 OpenClaw 的技能 CLI,把坐标直接交给它即可:

openclaw skills install @teamolab/academic-writing

安装完成后,通过 prompt 或 CLI 方式触发即可。ClawHub 页面同时提供了 npx skills 的入口提示,页面标注为 “Install CLI npx skills / Prompt”。

需要说明的是,目前官方资料只给出了 OpenClaw 这一条安装路径,Cursor、Codex CLI、Claude Code 等环境的接入方式没有被 SKILL.md 或 ClawHub 页面记录,这里不做推测。要在这些工具里用,需要自行把 SKILL.md 内容按对应 Skill 的加载规则接进去。

典型用法

SKILL.md 本身不内置固定模板,它提供的是约束。实际使用方式是把写作任务连同要求一起交给 Agent,让它在这套规范下生成。几个可复现的入口:

生成论文章节

输入研究主题和已有素材,让 Agent 按 academic-writing 的规范写出引言、方法、结果、讨论。它会用 Markdown 输出,正文包裹在标签内,章节结构按 academic tone 组织。

整理文献综述

给出一批已核实的论文条目,让 Agent 生成综述并标注引用。它会按 [1]、[2] 顺序编号,并在结尾给出符合上述格式的 References 列表,同时把来源限定在学术数据库范围内。

检查已有草稿的引用

把一篇已有草稿交给 Agent,让它按交付前四条自检项逐条核对:引用是否指向合法学术来源、编号是否连续、参考文献格式是否正确、全文语言是否一致。这一步对草稿改动最小,也最容易见效。

生成对比表格和示意图

需要呈现多个属性的对比或流程说明时,直接要求 Markdown 表格或 Mermaid 图,SKILL.md 已经把这两类输出的格式和数据准确性要求写进去了。

适用场景与注意

适合这几类人:在 Agent 里做论文起草或润色、需要反复保证引用格式一致、希望综述的参考文献只来自学术库而不混入博客或新闻的开发者和研究者。

需要注意的地方:

  1. 规范只管格式和来源边界,不保证内容正确。SKILL.md 要求不得编造引用,但检索到的文献仍需你自己核实真实存在。
  2. 引用来源清单里有明确的排除项,如果你的分析依赖行业新闻或官方公告的时效信息,需要单独说明,否则会被当作禁止来源处理。
  3. 输出格式被锁定在 Markdown,如果目标期刊要求 LaTeX 或 Word,需要在拿到 Markdown 后自行转换。
  4. 语言一致性约束是”匹配提问语言”,中英混排只在术语层面允许,不适合需要大量保留原文引号的写作场景。

结尾

academic-writing 的价值在于把一套可重复执行的学术写作规范写进了 SKILL.md,让 Agent 每次输出都走同一套格式和引用约束,省去每次重新交代要求的重复劳动。如果你要做的是论文结构搭建、文献综述整理或引用格式核查,可以从这里开始。

官方地址:https://clawhub.ai/teamolab/academic-writing
SkillHub 页面:https://www.skillhub.cn/skills/clawhub_teamolab/academic-writing

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye