Prose Writer(证据优先)是一个面向技术综述写作的技能,目标是从已批准的大纲和证据包生成 output/DRAFT.md 或 output/SNAPSHOT.md,使草稿读起来像真实论文,而不是大纲占位符的扩写。
用途 该技能充当综合引擎:输入为小节简报(subsection briefs)与证据草稿(evidence drafts),输出为段落级的“主张 → 证据 → 综合”(带引用)。触发词包括:write draft、prose writer、snapshot、survey writing、写综述、生成草稿、section-by-section drafting。
主要能力 技能定义了三个角色卡:Section Author(内容专家)负责将每个小节写成论证而非论文列表,要求以具体张力开篇、段落一以论点收尾、明确 A-vs-B 对比、每个 H3 至少一个协议感知的评估锚点(任务/指标/约束)、跨论文综合(同一段落至少 2 个引用);Evidence Steward(怀疑者)负责在证据薄弱或未充分说明时拒绝填充,要求每个 H3 预检 4 行(张力/对比/评估/局限)、量化主张限定范围、需要猜测时停止并向上游路由;Coherence Editor(连接者)负责让论文读起来像单一论证,要求在相邻单元间编织 1-2 句有内容的过渡句,并避免规划者口吻与重复话语词干。
写作要求(明确契约) 每个 H3 小节需包含以下论证动作:论点前置(段落一以结论先行的论点句收尾,无叙述性开头);对比(至少两个明确的 A-vs-B 对比,使用对比词,不逐篇论文写一段);评估锚定(至少一段陈述基准/数据集/指标/协议及相关约束);跨论文综合(至少一段在同一段落含 ≥2 个引用,解释模式/权衡);局限性(至少一个与证据粒度相关的明确警示,如协议不匹配、缺少消融、威胁模型不清)。引用要求:只使用 citations/ref.bib 中的引用键;引用放在承载主张的句子内;避免像标签一样的引用堆砌。风格要求:不叙述大纲、不使用幻灯片导航、证据政策限制只在前言写一次、避免重复的综合词干。
使用方式 工作流(v3:规划者↔写作者,逐节进行):写作前加载结构性与连贯性输入(outline/outline.yml 章节顺序、outline/transitions.md 过渡映射,可选 outline/claim_evidence_matrix.md 作为证据索引)。门控检查(HITL):读取 DECISIONS.md,若 Approve C2 未勾选,则写一个简短请求块(计划写什么 + 依赖哪些证据包)后停止。输入完整性检查(快速失败):读取 outline/subsection_briefs.jsonl 确认每个 H3 都有简报且 scope_rule、rq、axes、clusters、paragraph_plan 字段已填写且非占位符;读取 outline/evidence_drafts.jsonl 确认每个 H3 都有证据包且 blocking_missing 为空、evidence_snippets 非空、concrete_comparisons ≥ 3。规划者阶段(不写散文):为每个 H3 决定论点、两个对比、一个局限/失败模式、引用放置;若需猜测则停止并向上游推送缺口。写作者阶段:每个 H3 按 paragraph_plan 写 6-10 段,目标约 800-1400 词(证据包明确薄弱时可更短并标记为暂定)。编织过渡(连贯性):在相邻小节/章节间添加 1-2 句反映分类逻辑的过渡句。整合跨切面产物:若存在 outline/tables_appendix.md,将其内容作为附录块放入草稿(建议在结论后);不要将 outline/tables_index.md 粘贴进论文;timeline.md 与 figures.md 默认可选/中间产物。自检与修订(硬失败信号):若草稿包含 ...、Unicode 省略号 …、脚手架短语或重复样板句,视为流水线失败信号并重写。
辅助脚本(引导) 辅助脚本是门控包装器:它会阻塞直到批准与前置条件满足且存在真实的 output/DRAFT.md(无脚手架标记)。写作本身由 LLM 驱动。 快速开始: uv run python .codex/skills/prose-writer/scripts/run.py --help uv run python .codex/skills/prose-writer/scripts/run.py --workspace <workspace> 示例:在 DECISIONS.md 中勾选 Approve C2 后运行: uv run python .codex/skills/prose-writer/scripts/run.py --workspace <workspace>
输入与输出 输入:outline/outline.yml、outline/subsection_briefs.jsonl、outline/transitions.md、outline/evidence_drafts.jsonl;可选:outline/tables_index.md、outline/tables_appendix.md、outline/timeline.md、outline/figures.md、outline/claim_evidence_matrix.md;citations/ref.bib;DECISIONS.md。输出:output/DRAFT.md 和/或 output/SNAPSHOT.md。快照与草稿的决策:快照为要点优先、约 1 页,总结存在哪些证据与缺失什么;草稿为逐节散文,遵循每个小节的 paragraph_plan 并使用段落级引用。
适用场景 适用于技术综述写作、草稿生成、快照生成、逐节撰写等场景,尤其适合需要以证据驱动、引用可验证、避免模板化写作的综述项目。
限制 非可选项:无批准不写作(综述需 DECISIONS.md 中 Approve C2);不虚构引用(只用 citations/ref.bib 中存在的键);不泄漏占位符(若上游产物仍含脚手架标记/省略号/TODO,则不写作,阻塞并请求修复证据);不泄漏流水线术语(如 working claim、enumerate 2-4、scope/design space/evaluation practice)。若无法在不猜测的情况下写出对比或评估锚点,应停止并向上游路由。其他具体功能、收费、价格、平台、效果或使用步骤暂未提供。