mcpField
I
intro-drafter

intro-drafter

github.com/hkustdial文档处理11.0k733 次安装2 周前更新
代码仓库

关于 intro-drafter

intro-drafter 是面向 STEM 研究者的写作技能,可根据研究领域、局限、核心思路和挑战生成论文引言正文。它采用六段逻辑组织内容,并要求事实依据来自用户材料或已核实资料。

主要功能

  1. 01生成六段式引言正文
  2. 02围绕研究背景与贡献组织论述
  3. 03遵循证据纪律避免编造细节
  4. 04可按明确要求输出引言提纲

适用场景

  1. 01根据研究构想起草论文引言
  2. 02将已有文献材料融入引言论述
  3. 03为 STEM 论文梳理引言逻辑结构

安装

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

$npx skills add https://github.com/hkustdial/supervisor-skills --skill intro-drafter

安装后在 Claude Code 中输入/intro-drafter确认已加载。

包含的文件

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

references/
contribution-patterns.md
evidence-discipline.md
flowchart.md
paper-types.md
prose-delivery.md
running-example.md
worked-examples.md

详细介绍

引言起草器

概述

引言是整篇论文的精简版本。必须在一页半到两页内说明研究对象、问题的重要性、现有工作为何不足、论文的贡献,以及这些贡献如何对应到各个章节。审稿人会在读完引言时决定是否继续阅读,因此,论述的逻辑主线必须严密无隙。

此技能是一个正文生成器,而非大纲生成器。它接收少量输入(研究领域、局限性、核心想法、挑战、解决方案概述、可选参考文献),并生成六段完整的引言正文。六段式流程图在底层作为内部框架使用,绝不会出现在输出中。

交付的文本必须读起来像是研究人员写的:行文流畅,不含行内标签,不带“第 1 段:背景”之类的标题,也不包含严重性表格或一致性报告。只呈现引言正文。

仍可使用显式大纲:见下文“大纲模式”。

证据规则(继承)

此技能遵循共享的证据规范:每项事实性陈述都必须能追溯到用户提供的材料、本次会话中经核实检索的信息,或领域常识;模型记忆绝不能作为来源;交付的正文不得含有任何方括号占位符标签;用户未提供的细节(具体场景、机制、量级、流程、标识符)应予以省略,不得凭空编造。

参见:references/evidence-discipline.md 和 references/prose-delivery.md(与 paper-writer 共用)。

何时使用此技能

  • “写引言。”“根据这个想法起草引言。”
  • 用户提供了一段研究思路,希望将其写成完整正文,而不是要点列表。
  • 用户已经确定目标和核心想法,但还没有引言文本。
  • 用户粘贴了参考文献,并要求将其融入引言。

何时不要使用此技能

  • 基准测试论文:使用 benchmark-paper-template(其流程图有所不同)。
  • 非引言章节:使用 paper-writer。
  • 已有正文需要润色:使用 paper-polish。
  • 用户希望评估论文是否已准备好投稿:使用 pre-submission-reviewer。

预检查:是否属于 STEM

六段式模型(背景、局限性、目标、挑战、解决方案、贡献)是为 STEM 和技术类论文设计的。如果研究在方法上不属于 STEM(人文学科、社会科学、经济学、法律),不要强行套用此框架;应将任务交给 paper-writer,其 CER 规划涵盖这些研究范式,同时仍须遵循所有证据规则。判断依据是研究方法:实验、基准测试、模型或算法适用此技能;其他情况则交由 paper-writer。

核心流程(STEM)

先在内部思考,再写正文。中间思考过程均不输出。

步骤 1:论文类型定位(内部)

参见:references/paper-types.md,了解“技术方法”与“新问题/新设定”的区别,以及来自 Alpha-SQL、AFlow 和 LEAD 的实例。

  • 技术方法论文:贡献是针对已有问题提出新方法;叙述主线是核心想法;第 3 段是简短的衔接段。
  • 新问题/新设定论文:贡献本身就是问题形式化;第 3 段是关键段落。
步骤 2:规划六段内容(内部)

参见:references/flowchart.md,了解各段的目的、写作要点和常见问题。

对每一段,确定其目的、从用户输入中提炼的两到四个具体写作要点,以及信息缺口(即输入尚未涵盖的内容)。正文写完后,再向用户报告这些缺口;切勿将其写入正文。

  1. 背景与动机、贯穿全文的示例、问题的重要性。
  2. 现有工作的局限性(最多三项)。
  3. 问题本质与目标;明确说明硬性约束。
  4. 关键挑战(最多三项)。
  5. 解决方案概述;每项挑战对应一个模块。
  6. 贡献(共三至四项,每项对应一个章节)。
步骤 3:贯穿全文的示例(内部)

参见 references/running-example.md,了解设计原则和模式。

如果用户没有提供贯穿全文的示例,不要编造示例。 参考文件的第一条原则是:示例必须真实,取自真实数据或真实部署。根据用户自己的抽象问题描述撰写背景段落,并在结尾注释中询问:“一个具体的贯穿全文示例会让第 1 段更有说服力;你能分享一个来自实验或部署的真实案例吗?”

步骤 4:对齐检查(内部,在撰写前)

参见 references/contribution-patterns.md,了解有力与薄弱的贡献模式。

默默核验:第 1 段中的贯穿全文示例是否在第 5 或第 6 段再次出现;每项挑战是否对应某项局限或硬性约束;目标是否与贡献 1 一致;挑战是否与模块一一对应;贡献是否为 3 或 4 项,且每项都对应一个章节,没有含糊不清的贡献(“大量实验”不算贡献)。

任何一项检查未通过,都要在撰写正文之前修正计划。绝不要试图绕过有问题的逻辑链。

步骤 5:撰写正文

撰写六段连贯的正文,并遵守以下要求:

  • 输出中不要标注段落标题。 通过自然过渡来承载结构(“尽管已有这些进展,……”“在本文中,我们……”“我们的贡献总结如下。”)。
  • 每段为一个整体, 长度约为 100–250 词,并根据论文类型调整篇幅(参见 references/paper-types.md)。
  • 引用:按首次出现的顺序使用数字引用序列 [1]、[2]……一篇完整的六段式引言通常会穿插 15–25 条参考文献:背景部分 3–5 条,局限性部分 5–8 条,第 3 至第 5 段每段 2–4 条,贡献部分 0–2 条。参考文献过少会让文章读起来像观点评论。撰写前先检索:使用不同关键词进行 3–5 轮检索,以构建文献池;论证应围绕检索到并核实的文献展开。若找不到某项论断的来源,就改写该论断,使其不再需要引用,切勿添加标记。正文后须附上与引用标记双向对应的 References 列表。引用达到 3 条或以上时,运行 paper-writer 定义的独立引用核验流程(如环境允许,在新上下文中核查每条条目;否则如实说明并披露降级处理)。
  • 数字与论断:不得编造百分比、速度提升或基准测试数字。只有用户提供了具体收益数据时,才能写出具体收益;否则写“优于以往基线”,且不附加任何说明。
  • 时态:以过去时描述既有工作和观察;对论文中尚未验证的主张使用现在时或将来时(“本文提出”)。如果没有用户提供的结果,绝不要写“我们取得了”或“我们证明了”。
  • 语气检查:定稿前,去除带有 AI 腔调的表达和缺乏依据的最高级措辞,并确保动词与证据强度相符(共同词表所在位置见下方“语气参考”部分)。
步骤 6:简短结尾注释(可选,最多三行)

正文(以及 References)之后,最多添加一条简短的白话注释:指出用户需要补充的信息、因输入不足而暂定撰写的段落,或步骤 3 中提出的贯穿全文示例请求。不要使用表格、列表或严重程度标签。若没有有用内容可说,则不添加注释。

用户将收到的内容

  • 六段引言正文,段落之间以空行分隔,引用格式为 [1]、[2]……
  • 如有引用,正文后紧接 References 列表。
  • 可选:一条一至三行的白话注释。

其他内容一概不包含。完整的禁止事项清单(标题、检查结果、严重程度摘要、占位符标签、流程前言)见 references/prose-delivery.md,且必须遵守。

大纲模式(仅在明确请求时)

当用户明确要求提供大纲而非散文(“只要大纲”“先给我框架”)时,请改为返回经典结构:类型定位(类型、理由、影响);然后针对六个段落,分别列出其目的、写作要点,以及带严重程度的缺漏;最后列出五项一致性检查(贯穿全文的示例闭环、局限到挑战、目标到贡献 1、挑战到模块的映射、贡献到章节的映射)。收到请求后,再将同一份内部规划完整呈现一次。

语气参考

共享风格参考及其权威版本位于 paper-polish 中(ai-tone-guardrails、academic-phrasebank、section-conventions),适用于此技能的散文润色流程;如需更精细的措辞支持,请通过该技能的参考资料查阅。

技能间交接

  • 已完成引言,接下来需要撰写论文其余部分:paper-writer。
  • 散文已就位,但显得生硬:paper-polish。
  • 怀疑这个想法本身不足以支撑一篇顶级会议论文:不要将此写入引言;在结尾说明中写一句,并指向 idea-evaluator。

输出语言

优先遵循明确的语言要求;指定中文期刊或中文论文即表示使用中文;否则默认使用英文。绝不要根据用户消息的语言推断输出语言。

评论

支持 Markdown