用途
Work-Order Write-up 用于生成人类可读的工单文档：从 templates/work-order-writeup-template.md 渲染，仅使用合同载荷中的数据填充，包括已组装的上下文、最相似的历史工单、备件就绪情况、推荐的下一步最佳行动以及任何未决升级项。目标读者可以是技术人员（现场记录）或计划员（摘要）。
主要能力
- 根据合同载荷生成工单写作文档。
- 填充模板，涵盖资产与工单标识、问题摘要、适用 SOP、带引用的最相似历史工单、备件就绪表、推荐的下一步最佳行动、"未决升级"块以及合同载荷附录。
- 渲染为请求的格式（markdown；通过平台文档组件可输出 DOCX/PDF）。
- 选择受众语气：面向技术人员的简洁现场记录，或面向计划员的带成本/优先级框架的摘要。
- 将写作文档标记为草稿——等待计划员/主管审核。
使用方式
在 parts-readiness 之后使用，以闭环流程。触发语句包括："Draft the technician notes"、"give me the planner summary"、"what's the next best action?"。
输入为 work-order-packet.json（合同 mfg.work-order-assist.v1，包含 {parts_readiness} 跳，含 similar_work[]、parts_readiness{}、superseding_fix{}、next_best_action、escalations[]）。
步骤：
- 根据合同验证输入。
- 填充 templates/work-order-writeup-template.md。
- 渲染为请求的格式。
- 选择受众语气。
- 标记为草稿。
输出：WO-<work_order_id>-writeup.md（或 .docx）——合同流程的终端产物。
适用场景
适用于需要在备件就绪评估后生成工单文档的场景，面向技术人员或计划员。
限制
- 草稿优先：v1 中不进行 CMMS/EAM 回写、不排程、不承诺库存。写作文档是建议，不是已执行的操作。
- 写作文档中不得出现合同载荷中不存在的内容。
- 范围止于草稿；自动排程和库存承诺不在范围内（Wave 3）。
- 如果 escalations[] 非空，写作文档必须在推荐行动上方以可见的"未决升级"块呈现它们——尤其是重复故障、被取代的 SOP 部件或 BLOCKED 备件状态。
grounding 要求
每个相似匹配追溯到 engine:similar_work；就绪情况追溯到 engine:parts_readiness；SOP/手册和标准引用参考文件。