# Demand Deliverability Assessment

> Use when a user asks whether a product demand (an existing forecast or a new order) can be delivered on knowledge network supply_942_verify: locate the forecast, read the inventory metric, run the kitting / net-demand function, and, only after explicit user confirmation, raise the simulated replenishment action.

- Skill: `openbkn-ai/demand-deliverability-assessment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add openbkn-ai/demand-deliverability-assessment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openbkn-ai/demand-deliverability-assessment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: openbkn-ai (https://skillmd.com/u/openbkn-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/openbkn-ai/demand-deliverability-assessment

---


# 需求可交付性评估

这是一个**业务流程编排 Skill**。它不自带算法、不写 URL、不带 Token；所有取数与计算都通过当前知识网络已挂载的指标、函数和行动完成。Agent 读完本文后，按「能力依赖」表用平台工具逐步调用即可。

## Skill Card

| 字段 | 值 |
|------|-----|
| `bkn_scope` | `supply_942_verify` |
| `trigger` | 「这单能不能按期交」「预测单 X 现在能交多少」「新增 N 套 Y 产品能否承接」 |
| `优先指标` | **库存可用量** |
| `优先函数` | **要X套净需求与齐套**；解释缺料结构时补 **BOM清单** |
| `可选行动` | **模拟确认补货计划**（须用户确认） |
| `open_parameters` | `product`（产品编码）、`qty`（需求套数）、`substitute_enabled`（替代料策略）、`warehouse_scope?` |

## 能力依赖

Agent 用 `search_capabilities` 按**名称**在本网络内找到函数，用 `get_kn_detail` / `get_object_types` 找到指标与行动类型。名称与执行工厂、知识网络中的登记完全一致，不要改写。

| 名称 | 类型 | 用途 | 调用方式 | 结果怎么读 | 需确认 |
|------|------|------|----------|------------|--------|
| 库存可用量 | 指标 | 可用库存总口径 | `query_metric`，`time.instant=true`；需按物料拆分时加 `analysis_dimensions=["material_code"]` | `datas[0].values[0]` 为合计可用量 | 否 |
| BOM清单 | 函数 | 展开产品一级主料 | `execute_tool`，参数 `product`（必填）、`depth=1` | `l1_lines[]` 为一级主料，`line_count` 为 BOM 行数 | 否 |
| 要X套净需求与齐套 | 函数 | 齐套判断与缺料 | `execute_tool`，参数 `product`、`qty`、`substitute_enabled`（必须明确 true/false） | `kitting_ok` 为齐套结论；`gaps[]` 为缺料，取 `net_requirement` 与 `recommended_replenishment_qty` | 否 |
| l1_kitting_check | 函数 | 一级主料快速齐套检查（不含在途与替代料） | `execute_tool`，参数 `kn_id`、`product`、`qty` | `kitting_ok`、`gap_count`、`gaps[]`（`net_requirement`） | 否 |
| 模拟确认补货计划 | 行动 | 生成模拟补货计划回执 | 先 `get_action_info` 取参数 schema，再 `execute_action`；`dynamic_params.request_json` 为 JSON 字符串，`dynamic_params.simulation=true` | 回执带 `simulation=true`、`business_write=false`，不代表真实业务写入 | **是** |

不在依赖表里的能力不要调用；表里的能力若在本网络找不到，如实告知用户「该能力未挂载」，不要换用其他网络或平台级目录里的同名能力。

## Agent 执行步骤

1. **解析需求**：把用户给的产品解析为唯一编码。若给的是预测单号，用 `query_object_instance` 在「产品需求预测单」上按 `billno` 或 `material_number` 用 `match` 定位（这两个字段是全文索引字段，不要用 `==`），取出 `material_number` 与 `qty`。名称命中多个编码时先澄清。
2. **确认替代料策略**：`substitute_enabled` 未给出时先问用户，不得默认。
3. **读库存背景**：调用指标 **库存可用量**（instant），作为报告的库存基础数字。
4. **齐套判断**：调用函数 **要X套净需求与齐套**，传 `product`、`qty`、`substitute_enabled`。`kitting_ok=true` 直接给「可交付」结论并结束。
5. **解释缺料**：`kitting_ok=false` 时，按 `gaps[]` 的 `net_requirement` 从大到小列出前 5 项缺料；需要说明缺料来自哪一级主料时再调 **BOM清单**（`depth=1`）。
6. **询问是否补货**：向用户复述缺料清单与建议补货量，明确询问是否生成模拟补货计划。**未得到肯定答复不得执行行动。**
7. **执行行动**：用户确认后，先 `get_action_info` 取「模拟确认补货计划」的参数，再 `execute_action`。参数映射：取 `gaps[]` 中 `net_requirement` 最大的一项作为瓶颈料，`request_json` 为
   `{"request_id":"DEMO-DLV-<产品编码>","demo_approved":true,"eligible_on_hand":<该项 available_qty>,"reserved":0,"net_demand":<该项 recommended_replenishment_qty>,"safety_stock":0,"qualified_in_transit":<该项 in_transit_qty>,"moq":1,"pack_size":1}`，`simulation=true`。
8. **报告**：按 `references/report-spec.md` 输出。行动回执必须标注「模拟」，不得表述为已下达采购。

## 完成门槛

1. 产品已解析为唯一编码，`substitute_enabled` 已明确。
2. 指标与函数结果都来自本网络的调用，不在本地重算。
3. 行动只在用户明确确认后执行，且报告中标注为模拟。
4. 任一能力不可用时如实记录 `unavailable`，不得用估算值替代。

## 参考

- `references/report-spec.md`