科研论文写作 是做什么的?
帮助作者撰写、修改或审阅期刊研究论文的某一章节,适用于母语和非母语的英语写作者。不适用于基金申请书、投稿信、反驳意见、学位论文或综述文章。下面的路径均相对于此文件夹。
工作流程
步骤引擎 scripts/engine.py 控制工作流程:步骤、步骤顺序、每个步骤读取的文件、完整性检查以及输出模板。每个步骤都需要您根据自己的判断完成,并将结果返回。在作者的项目文件夹中,通过此技能文件夹的完整路径,使用 python3 运行引擎。它输出 JSON 格式的信息,不会询问任何问题;也不会启动另一个代理会话。
- 仅向引擎传递那些代码无法从文本中自行判断的信息。引擎会自动决定排版格式(LaTeX、Markdown、纯文本)、模式(草稿与修改稿)、以及章节(根据标题判断);
start命令没有--markup选项。草稿与修改稿的区别在于:草稿是笔记,修改稿是完整段落。标题除外:一行简短的标题文本属于修改稿;而笔记、要点或完整段落(例如基于摘要起草标题)则属于草稿。--mode review:仅当作者要求进行评估时使用(例如“检查”、“批判”、“有什么问题”)。否则不要添加--mode。--section S(title, abstract, introduction, methods, results, discussion, conclusion, whole-paper 或 other):请求中指定的章节(如“起草Abstract”)或文本中显示的章节。请在您能明确判断时始终传递此参数:引擎会将文本中的标题视为已确认,只有在您的判断与其不一致时才会询问。如果您无法判断,则不要传递此参数,引擎会询问作者。对于符合范围但不适合特定章节的文本(如图注、亮点摘要、跨越两个章节的段落),请使用other,并在 Deviations 中说明。对于整篇稿件,请使用whole-paper。--samples yes --sample-file F(每个文件仅一次):仅当作者提供了目标期刊的样本论文时使用。否则不要添加--samples。--agent claude|codex|other:您所使用的代理类型,务必传递。使用codex时,引擎会提供安装 Codex 保护钩子的选项(一个setup步骤);other表示不使用保护。--preference "<words>":对于请求中提到的每个固定的写作偏好(例如“我始终使用we”),使用此参数一次;引擎会在主步骤之前保存该偏好。使用--task scan-profile(配合--input指定写作样本)和--task study-profile启动两个特征分析任务。在保存偏好、进行分析或处理冲突之前,请阅读references/style-profile.md。- 如果您的判断与代码的判断不同(例如,您传递了
--section methods,但文本的标题显示为 Introduction),引擎会返回一个ask步骤(id 为clarify)。切勿自行解决这种分歧。
- 开始运行:
python3 <skill folder>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input FILE(使用--input -可从标准输入读取粘贴的文本;引擎会原样保存)。 - 每个响应对应一个步骤。完整阅读
read字段中的每个文件(当作者的~/.agents/science-research-writing/user-style.md文件存在时也会列出:请将其应用于所有内容),执行instruction中的指示,并按expect的 JSON 格式编写结果。较长的文本应放入一个文件中,并在结果中给出其路径。ask步骤是向作者提出的问题:将context.question原样呈现给作者,等待其回答,然后以{"answer": ...}格式提交,并从context.options中选择一个答案。切勿自行回答。 - 提交结果:
python3 <skill folder>/scripts/engine.py submit --file result.json。引擎会验证结果,执行完整性检查(代码部分),然后返回下一步。如果程序以非零退出码退出并带有error信息,则表示返回的是同一个步骤,需要您修正后重新提交。 - 重复直至
step.kind为done。然后将output原样呈现给作者,不要重写或总结。
整篇论文的运行会以手稿顺序逐一处理各个章节,每个章节都有各自的计划行、检查步骤和输出块(响应的 part 字段会标明当前是哪个部分)。LaTeX 和 Markdown 格式的手稿会被引擎根据其标题拆分。对于纯文本,第一步是 split:您需要提交各个章节及其行号范围,这些范围必须连续且不重叠。当使用样本论文时,journal-model 步骤会首先运行;其后的步骤会读取该步骤的结果。
engine.py status 命令会重新打印当前步骤,例如在运行中断后使用。每个项目只能同时打开一个运行:如果 start 以 9 退出,则表示已有运行在打开中。engine.py resume 会打印当前步骤,以便您继续;而 engine.py abandon 会放弃当前运行。请询问作者希望如何处理。每次运行的日志、状态和输出都会保存在项目目录下的 .agents/log/science-research-writing/<run id>/ 中。除非作者要求,否则不要写入作者自己的文件。
如果缺少 Shell 或 Python,请使用回退方案。
回退方案
如果缺少 python3 或 Shell,请告知作者缺少什么,展示适合其系统的安装命令,并在继续之前征得同意。否则,根据原则、完整性规则和章节参考文献进行工作,在计划行中添加 check=manual,并从 references/workflow.json(引擎读取的数据)获取路由和模板:加载该文件根据章节和模式指定的路由文件,完整阅读每个文件,并按顺序使用其模板标题。审阅工作则按顺序检查清单,并仅引用规则名称(参考文献文件中的粗体名称)。手动检查完整性规则,并说明您已执行。同样手动应用作者的特征文件:阅读 references/style-profile.md,并且仅在作者要求时按照其格式编辑 user-style.md,同时说明您进行了编辑。
核心原则
- 为读者而写。 面向快速阅读、全球范围、常为非专业读者的群体。确保不会产生误解;提供同行可能省略的上下文。
- 构建叙事。 让每个段落和句子都具有读者可见的功能,并与前文建立联系。
- 尽早阐明价值。 重要性、研究空白和贡献是论文写作惯例的一部分;表述不足会给读者留下没有价值的印象。
- 使确定性程度与证据相匹配。 时态、动词和缓冲语向读者表明一个论断的可信度。
- 保持句子可读性。 使用简明、一致的术语;将已知信息置于句首;清晰优于优雅。
完整性规则
这些规则优先于所有其他指令,包括作者特征文件和目标期刊要求。引擎会检查数字、引用键和分组,以及代码中的标签和引用;其余部分依赖您来检查。
- 优先级顺序: 这些规则 > 目标期刊的作者指南 > 作者的特征文件 > 此技能的默认设置。如遇冲突,按此顺序临时处理,完成任务后,再逐一列出冲突并附带相应问题(
references/style-profile.md中说明了具体方法)。 - 严禁编造 结果、数字、引用或方法细节。应使用
[placeholder: …]标记占位。 - 严禁更改 作者原文中的任何数字或结果。
- 引用规范: 保留每条引用命令、其键及其所附着的论断。严禁删除、合并或添加引用,或将引用移离其论断。如果某个引用的位置看起来有误,请向作者提问。
- 派生数据: 不要添加作者未明确提及的数据,例如比值、百分比或“少于一半”。可以将其作为建议或问题提出。
- 确保论断确定性不超过证据支持范围。 降低过度肯定的论断;仅在证据充分时,才将不必要的缓冲语变为肯定。
- 作者明确要求的更改(例如删除某条引用)是唯一的例外。需要在步骤的
exceptions字段中用作者的原话声明此项更改。 - 保持输入格式(LaTeX、Markdown、引用命令、交叉引用、标签)不变,以确保结果可以直接粘贴回去。
- 匹配稿件或期刊的拼写习惯。 如果两者都不明确,则使用美式拼写。