hhzz-production-launch

新品投产到生产任务

开始前必须阅读 ../hhzz-shared/SKILL.md。查询前读取目标操作的 --help；每个写步骤先读取 hhzz-cli schema <业务对象> <操作>。对象特殊规则可按需读取对应对象 Skill。

适用请求

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

只查询已有物料、BOM 或工单时，不使用本工作流，直接运行对应对象 CLI。

必要输入

确认成品编码和单位、计划数量、投入物料及用量、工序、工作中心、工艺路线、BOM 版本、计划时间。新建数据统一使用唯一隔离前缀；已有同编码对象的业务含义不一致时停止，不覆盖。

信息不完整时，先按业务顺序追问用户无法由系统推导的内容：成品及数量与时间、投入物料及用量、工序顺序与工作中心。单位 ID、物料 ID、工作中心 ID、现有版本和启用状态必须通过查询取得，不得要求用户提供或自行猜测。每轮只追问当前步骤继续执行所必需的信息；用户只要求检查已有投产条件时，不进入创建流程。

执行流程

1. 使用 material 和 unit 查询并准备成品、投入物料及单位。代码型新增默认使用 material import，只有完整结构化 ID 合同才使用 material create；逐个按唯一编码查回。
2. 使用 process、work-center 和 process-route 准备生产定义。代码型工序新增或维护默认使用 process import；验证路线节点顺序、工作中心和启用状态。
3. 使用 bom import 新增或普通维护 BOM；bom update 只用于用户明确提出的 ERP 对接更新。验证版本、投入行、用量、产出率、路线和启用状态。
4. 使用 work-order import 先执行 --dry-run，获得授权后执行 --confirm。
5. 查询工单基本信息、产出、用料和工序计划；任一项与目标不一致就停止。
6. 获取下发数据并执行 work-order issue，再查询工单状态和下发证据，禁止重复下发。
7. 使用 produce-task list 按工单定位任务，再用 produce-task detail 查询任务、工单、工序和状态；计划数量必须通过 produce-task list planned-amount --task-id <任务ID> 单独查回。

完成标准

必须同时满足：成品和投入物料可查回；工艺路线和 BOM 可用；工单投入、产出及工序计划正确；工单已下发；生产任务详情包含任务编号、工单编号、工序和“待执行”状态，计划数量查询返回目标数量。

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

失败与重复执行

• 写响应异常时先按隔离编号反查；对象已存在则记录返回合同异常，禁止重复创建。
• 前置数据缺失、状态不可用、权限不足或查回结果不一致时，停止依赖该条件的后续写入。
• 重复执行先复用已经验证通过的对象，只补齐缺失步骤。
• 认证失败时不执行任何业务请求；部分步骤已经成功而后续失败时返回“部分完成”，列明已落库对象和最短恢复点，不回滚或重建已经验收的对象。

输出

按共享规则的六部分格式返回。关键数据至少包含成品、路线、BOM、工单和生产任务的编号或必要 ID、计划数量及状态；CLI 证据列出实际执行的脱敏命令。

案例

金属软管只是参数化验证案例，不是固定行业或默认数据：

• references/metal-hose-factory.md
• references/verified-result.json

案例编号和 ID 只能用于解释证据，不得复制到其他租户执行。