hhzz-material

物料管理

开始前阅读 ../hhzz-shared/SKILL.md。查询读取目标操作的 --help；写入先读取 hhzz-cli schema material <操作>。单位和 BOM 分别按 unit、bom 的当前 CLI 处理。

何时使用

用户需要查询物料主数据，或创建、导入、更新物料及其自定义字段时使用。

不在本 Skill 范围

• 只维护单位、BOM、工艺路线或库存单据时，直接使用对应 CLI。
• 从成品定义推进到待下发生产工单时使用 hhzz-production-launch；判断工单缺料时使用 hhzz-work-order-readiness。
• 物料可查回不代表 BOM、库存或生产条件已经建立。

目标与完成边界

完成结果是目标物料能够按唯一编码查回，所需投影字段、单位关系和业务范围与目标一致。只证明物料主数据状态，不证明库存或生产可执行。

必要输入或前置条件

查询至少需要可收敛为唯一对象的编码、名称或筛选条件。写入需要唯一编码和目标操作的完整 schema 请求。

Agent 先查询并核对用户提到的单位和业务范围。存在多个同名单位或多个可用单位且业务含义无法确定时，展示单位名称、编码和区别供用户选择，不要求用户提供内部 ID。

命令选择

• 通用筛选使用 material list；明确提供一个或多个编码并需要详情字段时使用 material detail。
• material detail 是按字段投影查询：字段 1 只返回基本信息和单位关系，不包含 bizRange；读取或回查业务范围必须包含字段 6，读取自制信息还必须包含字段 8。具体全集以操作级 --help 为准。
• 新建单个物料时，根据当前 schema 和用户已有数据在 material create、material import 中选择；不得把一个命令的字段套给另一个命令。
• 修改现有物料使用 material update；只修改自定义字段使用 material update custom-field。

关键业务约束

• baseInfo.bizRange 包含 1=仓储 时顶层 inventoryInfo 必须存在；不包含仓储时不得传入该对象。
• 写操作先 --dry-run，授权后 --confirm。

重复执行与错误恢复

• 写后按唯一编码和所需查询字段回读；回查 bizRange 必须包含查询字段 6。
• 响应异常但对象已能查回时禁止重复创建、导入或更新。
• 同编码对象已存在但业务含义不同，停止并报告冲突，不覆盖。

结果与证据

返回物料编码、名称、单位关系、所需业务范围和状态。未查询字段不得推断为默认值。