SuperAPI AI 工具集

Writing SOP

写作与研究

查看项目

更新于 10-16 04:45

技能介绍

用途

Writing SOP(学术写作标准操作规程)用于指导学术写作与文档产出。当用户需要起草或编辑学术文本(论文、报告、学位论文、研究计划)、格式化引用或参考文献、导入导出文献(BibTeX、RIS、CSV、JSON、PDF、DOI 列表)、撰写或编译 LaTeX 文档、将 Markdown 转换为 PDF/docx 等格式、润色学术语言或调整语气、准备投稿稿件时,可读取本技能。

四阶段迭代写作协议

所有超过一段的写作任务必须遵循四阶段流程,不得一次性写完就结束。每个阶段有明确步骤,需按顺序完成。

  • Phase 1 材料审查与大纲:确认需求、审查已有材料、生成带引用需求的分节大纲,识别缺口。设有 Stop Point 1,展示大纲后等待用户确认。
  • Phase 2 初稿生成:按大纲逐节撰写,嵌入引用,必要时中途检索或生成图表,保存 v1 版本。
  • Phase 3 自检与修订:执行 10 项机械式自检清单,修复所有未通过项,保存 v2。设有 Stop Point 2,展示自检结果后等待用户确认。
  • Phase 4 精修与导出:应用用户反馈,执行五轮语言润色,保存 final 版本并导出,展示版本对比。设有 Stop Point 3,展示最终成果。

版本标记要求:每次 workspace_save 必须使用版本标签,如 {topic}-v1.md、{topic}-v2.md、{topic}-final.md。

主要能力

Phase 1:材料审查与大纲

需询问目标格式(期刊/会议/学位论文/报告/计划)、目标期刊或模板、引用格式(默认 APA 7)、语言、篇幅目标、已有材料。随后审查工作区已有草稿与报告、检索本地文献库、读取用户提到的笔记或大纲。为每一节生成大纲表格,包含:章节、要点、所需引用数、已有引用数、是否存在缺口。若存在缺口,触发检索流程补充文献,重复直至缺口填补或检索穷尽;未经用户明确同意,不得带着已知缺口进入 Phase 2。

Phase 2:初稿生成

按大纲顺序逐节撰写,按约定格式嵌入引用。每节检查:每个事实性论断是否有引用、被引论文是否已验证或在库中、大纲要点是否全部覆盖。若中途缺引用则暂停检索并入库后继续;若需要图表则暂停、加载绘图 SOP、生成图表并保存到 outputs/figures/ 后继续。完成后保存 v1 草稿,如使用 BibTeX 则导出参考文献,并告知用户进入自检阶段。

Phase 3:自检与修订

执行 10 项自检清单并记录 PASS/FAIL:结构完整(是否符合 IMRaD 或目标格式)、每个论断有引用、引用格式一致、无伪造参考文献、逻辑连贯、学术语气、数据/图表有编号与标题并交叉引用、摘要不超过 250 词(如适用)、无孤立章节、篇幅在目标 ±20% 内。对每个 FAIL 项描述问题、修复并重新验证。修复需要新引用时触发检索。保存 v2 后展示自检结果、变更摘要与遗留问题,等待用户确认。

Phase 4:精修与导出

应用用户反馈并验证一致性;执行五轮润色:简洁性(删冗余)、精确性(模糊词改精确值)、流畅性(过渡与路标)、术语一致性、语法(一致性、时态、冠词)。保存 final 版本,按用户要求导出为 docx、PDF、LaTeX 或 BibTeX;未指定格式时询问用户。最后展示版本对比:结构变更、内容变更、质量修复、各版本字数。

使用方式

技能通过一系列本地工具执行:workspace_save 保存草稿、workspace_read 读取草稿、workspace_list 列出工作区、workspace_export 导出 Word/PDF、library_export_bibtex 导出 .bib、library_search 检索文献库、library_add_paper 添加论文、task_link_file 关联任务文件、exec 执行 LaTeX 编译与 Pandoc 转换。

LaTeX 编译流程:xelatex → biber/bibtex → xelatex ×2 → 输出 PDF,命令示例:cd <dir> && xelatex -interaction=nonstopmode main.tex。模板涵盖 article/revtex(期刊)、beamer(演示)、thesis(THUThesis、SJTUThesis、ustcthesis)、IEEEtran(IEEE 会议)、acmart(ACM)。

Pandoc 转换示例:

  • md→docx:pandoc input.md -o output.docx --reference-doc=template.docx
  • md→pdf:pandoc input.md -o output.pdf --pdf-engine=xelatex -V CJKmainfont="Noto Serif CJK SC"
  • docx→md:pandoc input.docx -o output.md --extract-media=./media
  • 带参考文献:pandoc input.md -o output.pdf --citeproc --bibliography=refs.bib --csl=apa.csl

md2pdf 使用 md2pdf-export 技能的 Puppeteer 流程:先运行 bash skills/md2pdf-export/scripts/setup-env.sh,再执行 node skills/md2pdf-export/scripts/md2pdf.js input.md [--format A4 --toc --theme github]。

引用格式与完整性

支持的引用格式包括 APA 7(默认)、MLA 9、Chicago、IEEE、Vancouver、Harvard、Nature、ACM;CSL/GB/T 7714-2015 需读取 Citation Styles 技能。引用完整性规则:每篇被引论文必须存在于本地文献库或可通过 DOI 验证;优先引用一手来源;转述需引用,直接引用需加引号与页码;无法验证的论文须如实说明,绝不伪造参考文献。

适用场景

适用于学术论文、研究报告、学位论文、研究计划、投稿稿件的撰写与编辑,以及引用格式化、文献导入导出、LaTeX 写作与编译、Markdown 格式转换、学术语言润色等任务。写作质量遵循 IMRaD 结构(引言、方法、结果、讨论)与摘要规范,默认使用学术第三人称,多作者可用「We」。

限制

本技能为流程性操作规程,依赖 research-claw 提供的本地工具与文献库环境;具体工具可用性、文献库内容、模板与字体支持情况取决于实际运行环境。资料未提供收费、价格、平台兼容性或效果保证等信息。