ibp-001：安全库存计算系统

安全库存计算系统（ABC(D)XYZ × 6 公式）

版权声明 本 skill 版权所有归 集成供应链专家 黄河老师，电话 13767478486。 仅供企业内部学习、咨询交付与技术交流使用；未经授权不得用于商业售卖或二次分发牟利。

概述

本 skill 将一套经过实战打磨的「安全库存精准计算体系」封装为可直接交付的工具：录入物料主数据 + 过去 16 个月出库流水（Excel），系统自动完成 ABC(D)XYZ 分类，并为每类匹配最合适的安全库存公式，输出每物料的安全库存、可覆盖天数、再订货点，可一键导出 Excel/CSV。

核心理念：同一 SKU 用错公式，安全库存可差 10 倍。正确做法不是"全用一个公式反复调参"，而是"先分类、再按不确定性来源选公式"。

完整方法论（分类规则、6 公式表达式、判定树、服务水平 Z 映射、健壮性回退）见 references/methodology.md，在需要向用户解释原理或做方案时加载。

何时使用

遇到以下诉求时触发本 skill：

• 用户要计算安全库存、再订货点，或问"SS 怎么算"。
• 用户要做库存 ABC/XYZ 分类、呆滞料（D 类）判定。
• 用户提到"不同物料服务水平/提前期不一样、该用哪个安全库存公式"。
• 用户需要在咨询项目中向客户演示/交付安全库存计算工具。

使用流程

第 1 步：部署计算器（生成 HTML 到工作目录）

运行内置脚本，把自包含的 HTML 计算器复制到当前工作目录，并拿到输出路径：

python "<skill_dir>/scripts/launch_calculator.py" "<目标工作目录>"

• <skill_dir> 为本 skill 的安装目录（通过脚本自身 __file__ 定位，无需手动拼路径；也可直接用该脚本的绝对路径）。
• 脚本会打印复制后的文件绝对路径，例如 C:/.../安全库存计算系统.html。

第 2 步：打开并交付给用户

用 present_files 打开该 HTML，让用户在其浏览器/预览面板中使用：

present_files(["<第1步输出的 HTML 路径>"], explanation="安全库存计算系统：录入16个月出库数据自动分类并计算安全库存")

第 3 步：指导用户录入数据

告知用户工具使用三步：

1. 全局参数：服务水平口径（默认 CSL，制造业推荐；零售业可选 Fill Rate）、默认提前期 L、盘点周期 T、年持有/缺货成本率。
2. 导入 Excel：
   • 主数据表头：SKU,名称,单价,提前期L,σLT,盘点周期T,服务水平%,RMSE月度,年持有成本率%,缺货成本率%（后几列可空，用全局默认补齐；每行可单独覆盖服务水平/提前期/盘点周期）。
   • 出库流水表头：SKU,月份,出库数量,出库金额（16 个月，每月一行；金额=数量×单价，用于 ABC 金额排名，数量用于算波动率 CV）。
   • 可点「下载Excel模板」获取含两个 sheet 的样例文件。
3. 计算与导出：点「计算安全库存」出结果矩阵与逐 SKU 明细，可导出 CSV / Excel。

第 4 步：结果解读（需要时）

按 references/methodology.md 解释：

• 分类列显示组合如 AX / AZ / D；D 类（CV>125%）安全库存为 0。
• 公式选择按优先级：σLT/L>15%→F2；X类+有RMSE→F4；Z类+A价值→F6；T>0→F3；否则→F1。
• 服务水平 Z 由 ABC 决定（A=98%/B=95%/C=90%），可被主数据逐行覆盖。

资源

assets/

• 安全库存计算系统.html —— 自包含计算器（SheetJS 已内联，单文件离线可用，约 0.95MB）。

scripts/

• launch_calculator.py —— 将 HTML 复制到指定工作目录并输出路径（第 1 步使用）。

references/

• methodology.md —— 完整方法论：分类规则、6 公式、判定树、Z 映射、回退原则。向用户讲解原理或撰写方案时加载。

合规与署名

• 对外交付物（HTML、导出结果、基于此方法的 PPT）应保留「版权所有：集成供应链专家 黄河老师，电话 13767478486」字样。
• 本 skill 内置 HTML 的工具界面页脚已固化该版权声明，请勿移除。