hhzz-work-order-readiness

工单齐套与开工检查

开始前必须阅读 ../hhzz-shared/SKILL.md。本 Skill 只查询，执行前读取 work-order、material-inventory、occupy-inventory、inbound-order 和 transfer-order 的相关 --help，不需要查询写入 schema。

何时使用

• “这张工单能不能开工，还缺哪些物料？”
• “检查 WO-001 是否齐套。”
• “这批生产缺料多少，哪些已经在途？”

不在本 Skill 范围

• 只查询工单基本信息或某个物料库存时，不使用本工作流。
• 不创建入库单、调拨单，不调整库存，也不执行开工、领料或投料。

目标与完成边界

完成结果必须给出“可开工”“存在风险”或“不可开工”之一，并能逐物料回指需求、当前可用证据、占用、在途和缺口。查询字段不足时只能判定“存在风险”，不能自行补算。

必要输入或前置条件

必须提供唯一工单编号或正整数 ID。仓库、质量状态和计划开工时间可选；未指定仓库时，按工单用料和返回的仓储范围查询，并在结论中说明范围。

用户只提供工单名称、部分编号或其他模糊描述时，先用列表查询候选并要求确认唯一工单。物料 ID、仓库范围、用量、库存、占用和在途信息全部由 CLI 查询，不向用户索取。只有仓库范围或质量状态会改变判断且无法从工单确定时才追问用户。

执行路线

1. 使用 work-order detail input-material --warehouse-flag 获取完整用料需求；必要时查询工单基本信息和计划数量。
2. 为每条投入物料使用 material-inventory list 查询库存明细，并按仓库、仓位、质量状态和批次保留可解释维度。返回的 amount 是库存明细数量，不得直接称为可用量。
3. 使用 occupy-inventory list 查询汇总数量：amountTotal 是仓储中总库存，occupyAmount.amountSum 是占用总量，enableOccupyAmount.baseAmount 是生产返回中明确命名的可占用数量，应优先作为当前可用证据；再用 occupy-inventory list relation 解释占用来源。enableOccupyAmount 缺失时，不得自行用总库存减占用量补算。
4. 使用 material-inventory list transit 查询在途量；在途量单独展示，不计入当前可用量。
5. 对存在缺口的物料查询相关 inbound-order 和 transfer-order，说明是否已有补充计划及其状态。
6. 汇总逐物料证据并给出总体结论。

关键业务约束

• 可开工：所有必需物料都有语义明确且满足需求的当前可用量，没有阻断状态。
• 不可开工：至少一个必需物料存在已确认的当前可用缺口。
• 存在风险：数量足够但质量、冻结、占用或仓储范围存在风险，或者返回字段不足以证明当前可用量。

只使用生产返回中语义明确的可用量字段。enableOccupyAmount.baseAmount 已体现可占用语义，不得再次扣减 occupyAmount；不得重复扣减已经体现在可用量中的冻结，也不得把在途量加到当前可用量。字段缺失或语义不能闭合时展示 amountTotal、occupyAmount 等原始业务量并判定“存在风险”，不自行发明计算公式。

重复执行与错误恢复

• 认证失败或关键接口权限不足时返回“未完成”，不得给出齐套结论。
• 非关键补充单据查询失败时返回“部分完成”，已有库存证据只能支持对应物料，不能外推到整张工单。
• 相同输入重复执行只重新查询，不产生写操作。

结果与证据

按共享规则返回业务结论，并增加逐物料表：物料、需求量、当前可用量、占用、在途、已知缺口、补充单据和结论。技术证据只用于内部核验，不默认展示给业务人员。

References

金属软管工单的脱敏生产验证结果见 references/verified-result.json [blocked]。案例编号和 ID 只能用于解释证据，不得复制到其他租户执行。