scientific-writing

科学写作（编排器）

概述

这是一个三阶段工作流，可将包含代码和结果的仓库转化为论文草稿。每个阶段都有专属技能，并在使用该技能的仓库中的 docs/writing/<story-slug>/ 下保存一个持久化产物。此技能会将任务路由到正确阶段，并根据已有产物继续处理。

方法论基础——十五个步骤

该工作流将 Drake 和 Han 的 《如何用十五个步骤撰写科学论文》（PLOS Comput Biol，2025）付诸实践。其核心原则是：先完成思考，再斟酌措辞；只有研究完成后才动笔。 完整详情——包括每个步骤，以及各阶段会用到的图注、CARS 和连接词测试的具体要求——见 scientific-writing/fifteen-steps.md。各阶段负责一个连续的步骤区块：

步骤	阶段	交付内容
1–2	故事	核心观点 + 两部分叙事弧线
3–12	大纲	方法／结果／发现列表 → CARS 引言、发现 + 问题／回应式讨论、收尾论点、各段落的目的陈述、图表
13–15	草稿	主题句／支撑句／总结句

贯穿各阶段，也适用于这个 Agent：生成式 AI 是步骤 13–15 的工具（用于措辞），而非步骤 1–12 的工具（用于思考）。 在润色行文前，先完成构思并塑造各阶段的产物；绝不要让流畅的表达代替未经证据支持的论点。

阶段

阶段	技能	读取	写入
1. 故事	scientific-writing-story	仓库	story.md
2. 大纲	scientific-writing-outline	story.md	outline.md、references.md
3. 草稿	scientific-writing-draft	outline.md、references.md、story.md、风格指南	draft.md

路由

1. 查找 docs/writing/*/ 中已有的产物。
2. 从第一个未完成的阶段继续：
   • 没有 story.md → 调用 scientific-writing-story。
   • 有 story.md，但没有 outline.md → 调用 scientific-writing-outline。
   • 有 outline.md，但没有 draft.md → 调用 scientific-writing-draft。
   • 已有 draft.md → 所有阶段均已完成；询问用户是要修订 draft.md（重新进入 scientific-writing-draft），还是停止。
3. 如果用户明确指定阶段，按其要求执行。
4. 如果存在多个目标故事目录，请与用户确认目标目录。

用户在对话中的口头确认即为批准，而非磁盘上的标记。产物是否存在决定从哪个阶段继续；是否批准则决定能否进入下一阶段（每个阶段技能都会以“用户批准后，调用下一阶段”结束）。

调用技能前，务必先说明将进入哪个阶段以及原因。