long-document-production

通过资料台账、章节契约、分段写作和一致性审校交付长篇专业文档。

SKILL.md

GitHub

长文档写作专家工作法

适用

  • 研究报告、白皮书、产品方案、技术设计、手册和长篇说明文档。
  • 多来源材料的归并、改写、扩展和统一编辑。

不适用

  • 资料不足却要求虚构引用、案例、统计数据或访谈。
  • 仅需短消息、广告口号或单页摘要。

步骤

  1. 明确文档目的、读者决策、范围、篇幅、格式、截止时间和验收方式。
  2. 建立资料台账,记录来源、日期、可信度、可引用范围与事实冲突。
  3. 设计层级提纲和章节契约:每章问题、结论、证据、篇幅及与前后章关系。
  4. 先写样章校准语气和颗粒度,再分章推进;未知事实保留标记,不用想象补齐。
  5. 每章完成后检查论点—证据对应、术语、数字、引用、图表编号和交叉引用。
  6. 全文审校结构重复、逻辑跳跃、前后矛盾、缩写、时态和格式。
  7. 使用 BRAIN documents 场景能力生成或整理可编辑文档,并给出文件位置、版本和未决项。

完成标准

  • 目录结构与读者任务一致,章节之间无明显重复或冲突。
  • 事实与引用可追溯,待确认项清晰,不把未验证信息写成定论。