关于 write-abstract
write-abstract 是面向研究者的摘要撰写技能,可按特定会场要求起草或修改摘要。它检查结构、篇幅、关键词和已核实结果,并可在会场设有单独摘要截止日期时整理注册信息。
主要功能
- 01按五步结构起草摘要
- 02检查会场篇幅和关键词要求
- 03检查摘要文本与 LaTeX
- 04仅使用已核实的结果和数字
- 05整理摘要注册所需信息
适用场景
- 01为目标会场修改摘要
- 02检查摘要是否符合字数限制
- 03准备摘要注册元数据
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ shaishavmaisuria/ research-paper-lifecycle-skills --skill write-abstract安装后在 Claude Code 中输入/write-abstract确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/abstract-structure.mdkeywords-blocks.mdvenue-norms.mdscripts/abstract_check.pyabstract_registration.pykeywords_block.pyvenueyaml.py详细介绍
撰写摘要
生成符合会议要求的摘要——长度合适、关键词区块齐全、采用五步结构,且只使用已核实的数据;如果会议设有单独的摘要注册截止日期,还要准备完整的注册信息卡片(标题、摘要、作者、主题、利益冲突名单),可直接粘贴到投稿表单中。
适用场景
- 为特定会议或模板系列(acmart / IEEEtran / llncs / NeurIPS 风格)起草或改写摘要。
- 满足摘要字数限制,或补充缺失的 CCS Concepts / Index Terms / 关键词区块。
- 摘要注册截止日期临近,用户必须在论文 PDF 提交前注册标题 + 摘要 + 主题 + 利益冲突信息。
相关技能:tailor-to-venue(调整整篇论文以适配目标会议)、parse-cfp(构建缺失的会议信息档案)、preflight-check(终稿拒稿风险检查)、verify-citations(所有参考文献相关工作的把关流程)。
输入
- 草稿(优先提供主
.tex文件——这样可以在上下文中检查关键词区块),或纯文本摘要;如果是新写的摘要,则提供论文贡献和用户已核实的结果。 - 会议信息档案:
venues/conferences/<id>.yml或venues/families/<f>.yml(架构:venues/schema.yml)。如果两者都不存在,不要编造会议相关信息——对 CFP URL 运行parse-cfp,或直接引用当前 CFP 内容。
流程
1. 确认会议规范,然后重新核实(必须)
加载档案(format.abstract_words、format.keywords、deadlines.abstract/paper + timezone、review.blind)。档案可能过时:用户要依据字数限制、关键词要求或任何截止日期采取行动之前,必须对照当前的 cfp_url 重新核实,并说明核实了什么以及核实时间。如果无法获取 CFP,则将每项源自档案的信息标记为“UNVERIFIED — confirm on CFP”。当 abstract_words 为 null 时,应将 150-250 词说明为惯例,而非会议规定——参见references/venue-norms.md。
2. 按照五步结构起草(或诊断)
根据动机 → 缺口 → 方法 → 结果 → 影响的结构撰写摘要,并根据会议类别选择合适的语气和各部分字数预算: references/abstract-structure.md。
起草时的硬性规则:
- 结果数据必须来自草稿中的评估结果或用户提供的数据——绝不可编造、向上取整或外推。量化结果是摘要中预测力最高的单一表述;没有它,结果→影响的论述链就无法达到最高评分档。如果结果尚未确定,只能留出一个带类型的量化结果占位符——它必须是结构化约定,包含指标名称、单位、正负号/方向和对比对象,例如
[RESULT: +XX% Recall@20 vs best hashing baseline under matched budget]——绝不能只写[RESULT: ...]或使用自由文本。任何方括号占位符都会使摘要处于草稿状态,不能提交;交付前必须用已核实的值填入每个占位符。约定详情见:references/abstract-structure.md。 - 摘要中不得出现
\cite、\ref、数学公式或未定义的缩写(摘要作为独立元数据提交)。如果正文中提及的既有工作需要引用,应通过verify-citations流程处理。 - 对双盲评审的会议,不得泄露身份信息(机构、资助编号、“我们的先前工作”、个人仓库 URL)。
改写时,先运行检查器,再根据其发现的问题进行修改。
3. 进行确定性检查
从仓库根目录运行(或传入绝对路径):
python3 skills/write-abstract/scripts/abstract_check.py <main.tex|abstract.txt|-> \
--venue venues/conferences/<id>.yml [--strict]
报告长度与会议限制的对比、关键词区块是否存在及其结构、自包含性(引用/参考文献/数学公式/URL/占位符)、带类型的量化结果槽位不变量、acmart 摘要必须位于 \maketitle 之前这一易错点,以及词汇层面的移动信号。修复 RISK 和 WARN 发现的问题,然后重新运行,直到没有 RISK。若没有会议配置文件,--venue 也接受系列配置文件。
槽位检查不可绕过:脚本会打印未填槽位数量;只要仍有任何 [LABEL: ...] 槽位,就会以非零状态码硬性失败(无论是否使用 --strict),并将摘要标记为 DRAFT-not-submittable。只有当唯一一个带类型的 RESULT 槽位,以及任何 [CONFIRM: ...] 槽位,都已填入经核实的值并写入正文后,待结果草稿才算通过。切勿通过编造数字来满足检查。
4. 生成关键词区块
与用户一起选择关键词(问题 + 技术 + 领域;在属实的前提下,参照 CFP 主题列表,指南见 references/keywords-blocks.md),然后生成符合系列要求的 LaTeX:
python3 skills/write-abstract/scripts/keywords_block.py \
--venue venues/conferences/<id>.yml --keywords "kw1, kw2, kw3"
对于 ACM 会议,脚本会生成 CCS 框架,其中的概念 ID 必须通过官方工具 https://dl.acm.org/ccs 填入;切勿编造 CCSXML 概念 ID。对于 NeurIPS 风格的会议,脚本会正确地不生成区块(主题填写在投稿表单中)。
5. 生成注册信息卡(适用于设有摘要截止日期的会议)
如果设置了 deadlines.abstract——NeurIPS、ICML、KDD、CVPR、CHI、SIGSPATIAL 都会在论文截止日期前 2-7 天注册摘要——则整理好表单要求的所有信息:
python3 skills/write-abstract/scripts/abstract_registration.py \
--venue venues/conferences/<id>.yml --title "<title>" \
--abstract-file <main.tex|abstract.txt> \
--authors "Name <email> (Affiliation)" --topics "t1; t2" \
[--coi-file conflicts.txt] [--track <Track>] [--out abstract-registration-<id>.md]
信息卡包含带会议时区的截止日期倒计时(留意非 AoE 时区的会议——SIGSPATIAL 使用太平洋时间)、占位符政策警告(KDD/AAAI 会对虚构摘要进行惩罚)、根据用户近期合著者/导师/机构整理的利益冲突(COI)核对清单,以及投稿系统 URL。帮助用户根据实际近期论文填写 COI 列表;会议表单规定的时间范围和类别具有权威性。规范见:references/venue-norms.md。
6. 交付
提供最终摘要(LaTeX 版本 + 纯文本表单版本)、关键词区块、检查器的无问题报告;如适用,在草稿旁写入 abstract-registration-<venue-id>.md。明确说明由用户自行注册/提交。
输出
- 目标会议的摘要须同时提供 LaTeX 和纯文本版本,通过
abstract_check.py检查且没有 RISK 和未填槽位(待结果草稿须明确标记为 DRAFT-not-submittable,直至填入带类型的 RESULT 槽位)。 - 符合会议要求的关键词区块(或说明该系列没有关键词区块)。
- 对于要求注册摘要的会议,提供
abstract-registration-<venue-id>.md,其中包含标题、摘要、作者、主题、COI 核对清单、截止时间计算和核实记录。
安全约束
- 切勿为摘要编造结果、数字或主张;未经核实的值须保留为唯一一个带类型的量化结果槽位(指标、单位、正负号/方向、比较对象),并将摘要标记为 DRAFT-not-submittable,直至所有槽位都根据真实数据填妥。
- 切勿编造引用或 CCS 概念 ID;引用须通过
verify-citations核实,CCS ID 只能来自 dl.acm.org/ccs。 - 切勿凭记忆陈述会议限制或截止日期——只能依据配置文件和实时 CFP 核实;无法核实的事实须标记为 UNVERIFIED。
- 切勿代表用户在任何投稿系统中注册、提交或输入任何内容;交付内容仅限信息卡。
- 切勿将其他论文的摘要文本作为模板粘贴;范例研究须通过
study-exemplars技能临时完成。