技能介绍

要解决的具体问题

前期探索阶段一切正常，但到了最终长文档生成环节，常常卡在 Proofing / Transmuting 状态。当上下文已经很大时，模型仍倾向于一次性组织完整方案，而非分步推进。同一轮任务里耦合了阅读项目、架构分析、方案设计、写完整 Markdown、保存文件等多项操作，导致流程难以中断或恢复。用户打断并要求“先输出 Part 1 / 先写骨架”时，模型依然回到长时间的校对或组织状态，无法快速响应分步需求。

核心能力与关键步骤

需要了解状态文件和章节标记时，读取 references/artifact-schema.md；执行完整流程时，读取 references/workflow.md。

工作流分为以下步骤：

明确目标产物路径和目标读者
若任务依赖大项目上下文，先读取 .project-context/ 摘要，避免重新大范围读源码
创建 Artifact Brief，记录痛点、目标、范围、非目标、参考材料和章节计划
创建文档骨架：只写标题、章节标题和每章一句话摘要，总字数控制在 500 字以内
逐章扩写：每次只扩写一个章节，默认 800-1200 字，不顺手补全其他章节
每章落盘后立即验证：文件存在、章节标记存在、状态更新、只改目标章节
所有章节完成后做最终整理，仅修目录、术语、交叉引用和格式，不全文重写

脚本只做确定性文件操作，不生成正文内容。必须遵守的规则包括：不在扩写阶段重新进行大范围项目探索，不一次性扩写多个章节，不删除章节标记，不在最终整理阶段重写全文，发现信息不足写入“缺口清单”而非临时展开长探索，每次修改后更新章节状态并验证。

与 project-memory 的分工：project-memory 负责项目结构、知识图谱、会话摘要和上下文恢复，本技能负责长产物的分块生成、章节状态和落盘验证。推荐组合是先恢复 .project-context/，再初始化长文档 artifact，然后逐章撰写。

适用边界与注意点

当用户要求一次性生成完整长文档、目标文档路径不明确、需要覆盖已有非本技能标记的文档、单章内容需要新增大量项目事实超出已有 .project-context/、章节计划发生结构性变化时，必须暂停并询问。本技能不负责项目知识沉淀，需要项目上下文时应先用 project-memory 恢复摘要后再使用本技能。