hhzz-production-launch

新品投产到生产任务

开始前必须阅读 ../hhzz-shared/SKILL.md，并按共享规则发现命令、读取合同、确认写入和处理错误。只有命令选择或对象约束不明确时才按需读取对应业务动作 Skill，不遍历全部 Skill。

何时使用

适用请求：“帮我把这个新品投产，并生成生产任务。”“为这个成品建立工艺路线、BOM 和生产工单。”“把这张新品工单下发，并确认任务是否生成。”

本 Skill 固定使用“启用工艺路线、启用 BOM、工单使用 BOM”的完整路径，适合从生产定义推进到生产任务的业务动作。

不在本 Skill 范围

• 只查询或维护物料、工艺路线、BOM、工单中的单个对象时，不使用本工作流，直接使用对应 CLI 或已有业务动作 Skill。
• 不使用 BOM、手工搭建工序计划或只维护已有工单时，改用 hhzz-work-order。
• 用户要求领料、投料、报工、完工或现实生产执行时，不使用本工作流，也不得把当前终点扩展为这些动作。

目标与完成边界

完成结果必须同时证明：成品和投入物料可用；工艺路线和 BOM 已启用；工单产出、用料和工序计划正确且已下发；关联生产任务包含任务编号、工单编号、工序、目标计划数量和“待执行”状态。

终点仅为“生产任务已生成”。没有领料、投料、报工或产出证据时，不得说明生产已经开始或完成。

必要输入或前置条件

用户需要决定成品及计划数量和时间、投入物料及用量、工序顺序与工作中心，以及希望使用或新建的业务编码。信息不完整时，只追问当前阶段中用户无法由系统推导的内容。

单位 ID、物料 ID、工作中心 ID、现有版本和启用状态必须通过查询取得，不得要求用户提供或自行猜测。新建数据统一使用唯一隔离前缀；已有同编码对象的业务含义不一致时停止，不覆盖。

执行路线

1. 主数据

• 动作：使用 material 和 unit 查询成品、投入物料及单位；代码型新增物料默认使用 material import，单位必须已经存在。
• 验收：逐个按唯一编码查回；物料详情查询必须包含字段 6，成品还必须包含字段 8，因为字段 1 不返回 bizRange。确认单位可用、投入物料有效，成品的 bizRange 包含 4=自制 且生产单位有效。
• 停止：对象不唯一、业务含义冲突、物料或单位不存在或不可用、认证失败或权限不足时停止后续写入；本流程不自动创建或修改单位。

2. 生产定义

• 动作：使用 process import、work-center import 和 process-route import 准备生产定义。
• 验收：将工艺路线导入为启用状态并回查，验证节点顺序、工作中心、适用成品、单位和状态。
• 停止：路线未启用，或节点、工作中心、成品、单位与目标不一致时停止。

3. BOM

• 动作：使用 bom import 新增或普通维护 BOM，并按停用状态导入。父项成品由 BOM 根节点表达，不得重复放入 bomOutputMaterials；该字段只用于副产出。指定工序投料必须通过 specificProcessInput 和 inputProcessNum 指向关联路线中的真实工序号。
• 验收：回查版本、投入行、用量、关联路线及指定投料解析到的路线节点；结构正确后使用 bom update status 启用，再回查状态。
• 停止：结构或路线节点不一致时不得启用；批量结果存在失败、进入审批或回查仍为停用时，不得进入工单阶段，也不得只根据 ok: true 宣称启用。

4. 工单与生产任务

• 动作：先复用前三阶段证据确认成品可自制且生产单位有效、目标 BOM 版本已启用、BOM 关联路线已启用并适用于成品；再使用 work-order import 创建工单，显式设置使用 BOM、工艺路线和已验收的 BOM 版本。主产出有且只有一行，物料为目标成品，计划生产数大于 0。验收通过后，对 work-order issue 执行业务审计、--dry-run 和用户确认。
• 验收：查询工单基本信息、产出、用料和工序计划；全部一致后下发并回查工单状态，再使用 produce-task list、produce-task detail 和 produce-task list planned-amount 验证关联任务、工序、计划数量和待执行状态。导入返回通用错误或结果未知时，先按唯一工单编号回查；已落库则继续验收且禁止重试。
• 停止：成品自制信息、生产单位、BOM 状态、路线状态或对象关系任一无法查证时不得导入；导入失败且未查到工单时返回这些前置证据和阻塞，不自动重试，也不得断言接口完全不可用。产出、用料或工序计划不一致时停止；工单已经下发时禁止重复下发。未找到唯一任务、关联错误、数量或状态不一致时，保留工单已下发证据并返回阻塞。

关键业务约束

• 每个阶段必须先完成回查验收，再进入依赖它的下一阶段；ok: true 不能替代对象、关系和状态证据。
• 所有内部 ID、版本和启用状态都必须通过 CLI 查询取得，不得要求用户提供或自行猜测。
• 工艺路线、BOM 和工单之间的物料、单位、版本和工序关系必须一致；任一关系无法闭合时停止。

重复执行与错误恢复

• 写响应异常时先按隔离编号反查；对象已存在则记录返回合同异常，禁止重复创建。
• 重复执行先复用已经验证通过的对象，从最短未完成步骤继续。BOM 已导入但停用时先回查结构，完整才从启用继续；工单已下发时只验收生产任务。
• 认证失败时不执行任何业务请求；权限不足时停止受影响阶段。部分步骤已经成功而后续失败时返回“部分完成”，列明已落库对象和最短恢复点，不回滚或重建已经验收的对象。

结果与证据

按共享规则输出面向业务人员的结果。关键数据至少包含成品、路线、BOM、工单和生产任务的业务编号、计划数量及状态；缺失项集中说明，不默认展示内部 ID 或 CLI 命令。

References

金属软管只是参数化验证案例，不是固定行业或默认数据。需要查看完整业务结构和脱敏验收结果时读取 references/metal-hose-factory.md，不得把案例标识复制到其他租户执行。