hhzz-bom

物料清单管理

开始前阅读 ../hhzz-shared/SKILL.md。查询读取目标操作的 --help；写入先读取 hhzz-cli schema bom <操作>。

何时使用

用户需要查询某个 BOM 版本，维护父项、投入物料、产出率或关联路线，或者批量启用、停用 BOM 时使用。

不在本 Skill 范围

• 只维护物料或工艺路线时，直接使用对应 CLI。
• 从主数据一路推进到待下发生产工单时，使用 hhzz-production-launch。
• 不负责领料、投料、报工、完工或其他现实生产执行。

目标与完成边界

完成结果是目标 BOM 能按稳定标识查回，结构、版本、路线和状态与请求一致。BOM 已启用只证明生产定义可用，不表示已经创建工单或开始生产。

必要输入或前置条件

查询详情需要当前命令要求的唯一 ID，或完整的父项物料编码与 BOM 版本组合。写入前确认父项、投入物料、单位和工艺路线有效；具体字段、枚举和定位方式只从当前 --help 或 schema 读取。

命令选择

• 详情使用当前命令要求的唯一 ID，或完整的物料编码与版本组合。
• 普通新增使用 bom import；ERP 对接更新使用 bom update。两个命令的请求合同不同，不得混用字段。
• 批量启用或停用使用 bom update status，其中 0=停用、1=启用；只能按正整数 ID 列表，或按父项物料编号与 BOM 版本号列表定位，不能同时使用两种方式。

关键业务约束

• 写入先 --dry-run，授权后 --confirm。
• 工单引用前必须确认 BOM 已启用。
• 启停请求可能进入审批，不得仅凭成功计数宣称状态已经变化。

重复执行与错误恢复

• 写响应异常时先按原定位方式回查；已落库或状态已经变化时禁止重复写入。
• 批量启停可能部分成功；核对请求数与成功、失败总数，展示失败明细，并按原定位方式逐条运行 bom detail 回查。请求可能进入审批，不得仅凭成功计数宣称状态已经变化。
• 认证、权限、对象关系或结构校验失败时停止，不用其他近义命令绕过。

结果与证据

返回 BOM 父项、版本、投入行、产出率、关联路线、状态、失败明细和下一步。没有状态回查证据时，只能说明写请求已被接受。