前言¶
O2O 门店运营里，热销品缺断往往要按店拉 ERP 导出、对照总部 TOP 品与仓库存，再手工拼周报和横向对比。门店一多，同一套表格就要重复做很多遍。下面介绍 SkillHub 社区 Skill「o2o商品缺断分析」，它把「多店 ERP 数据 → 单店周报 → 横向对比」写成 Agent 可执行的流程，并附带批量脚本，适合在 Cursor 等支持 Skills 的客户端里按需触发。
这是什么¶
o2o商品缺断分析（坐标 @user_40ba62fc/o2o-stockout-analysis，版本 1.0.0）是 SkillHub 上的社区 Skill，分类为 business-ops，发布者为 user_40ba62fc（页面标注作者为花哥）。包内 metadata.json 将其定位为「一键批量生成多家门店的热销品缺断周报」，技能类型为运营数据分析。
它不依赖外部 API Key（标签 requires_api_key=false）。官方入口：
- API 地址：https://api.skillhub.cn/user_40ba62fc/o2o-stockout-analysis
- SkillHub 页面：https://www.skillhub.cn/skills/user_40ba62fc/o2o-stockout-analysis
核心功能¶
根据包内 SKILL.md，启用后 Agent 会按下列能力协助你（事实以该文件为准）：
- ERP 数据预处理：将门店导出的
xls转为xlsx，便于后续模板处理。 - 单店缺断周报：基于通用模板生成「热销品缺断周报」，并按库存数量划分状态（完全缺断 0 件、库存紧张 1–5 件、库存偏低 6–15 件、库存正常 >15 件）。
- 多店批量：支持一次指定多家门店的导出文件与门店名，批量出报。
- 横向对比：可生成缺断率横向对比表，并输出 HTML 报告。
- 提醒：流程说明中包含「7 天后对比提醒」的设置意图。
单店周报 Excel 内说明包含 7 个 Sheet：汇总看板、完全缺断、库存紧张、库存偏低、库存正常、全部明细（文档写明 304 品完整数据）、建议补货表。
固定参考数据（文档要求放在本机桌面）：
| 文件 | 说明 |
|---|---|
国信TOP品.xlsx |
热销品目录（304 品） |
国信商品库存情况.xlsx |
仓库库存（约 38,000 条） |
触发关键词（便于在对话里唤起）：缺断周报、批量生成周报、门店周报、热销品缺断。
安装与启用¶
方式一：让 Agent 按 SkillHub 指引安装¶
SkillHub 页面给出的安装提示为：先阅读 https://skillhub.cn/install/skillhub.md，再安装坐标 @user_40ba62fc/o2o-stockout-analysis。
方式二：使用 skillhub CLI¶
若本机尚未安装 CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按官方文档执行（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
将 Skill 装到当前 Agent 能识别的 skills 目录（文档强调必须用 --dir，否则默认 ./skills/ 可能不会被加载）：
skillhub install o2o-stockout-analysis --namespace user_40ba62fc --dir ~/.cursor/skills/
其他客户端常见路径（来自 skillhub.md，按你实际环境替换 --dir）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，按你所用客户端要求重启或刷新 Skills 列表。
典型用法¶
下列示例摘自 SKILL.md，在对话中附上 ERP 导出文件即可复现意图（@ 表示把文件交给 Agent）：
基础用法：
生成缺断周报
@file1.xlsx 门店名1
@file2.xlsx 门店名2
批量生成：
批量生成以下门店周报：
@export瑞安信一店.xls 瑞安信一店
@export瑞安安阳分店.xls 瑞安安阳分店
带横向分析：
生成周报 + 横向分析
@门店1.xlsx 门店名1
@门店2.xlsx 门店名2
输出路径约定（相对工作目录）：
- 单店：
热销品缺断周报\{日期}第{周数}周\热销品缺断周报_{门店名}_清晰版.xlsx - 横向对比：
热销品缺断周报\{日期}第{周数}周\缺断率横向对比.xlsx - HTML：
热销品缺断周报\{日期}第{周数}周\缺断率横向对比.html
包内还提供入口脚本 scripts/批量生成.py：在配置区填写桌面路径、下载目录、工作目录与模板路径后，可扫描 Downloads 下 export*.xls / export*.xlsx 并调用子进程生成周报。metadata.json 将该脚本标为 entry。
适用场景与注意¶
适合谁
- 多门店 O2O / 零售运营，周期性要做「热销品缺断」周报与门店横向对比的团队。
- 已有一套国信系 TOP 品、仓库存表，且 ERP 导出字段包含商品编码、商品名、数量的场景。
限制与坑
- 输入规范：ERP 导出需为 xls 或 xlsx；文档建议文件放在 Downloads 或桌面，并与固定 TOP / 库存表配合使用。
- 路径与脚本：
SKILL.md写明中文路径场景应直接跑 Python 脚本，不要用python -c。发布包内当前可见脚本为scripts/批量生成.py；文档还提到scripts\缺断周报_通用模板.py与cache.pkl缓存——若你本地没有该模板，需按文档「改配置区三行」自行补齐或让 Agent 按 SKILL 说明生成等价逻辑。 - 环境差异：
批量生成.py默认配置段含 Windows 风格工作目录示例（c:\Users\...\WorkBuddy\...），在 Linux 或 macOS 上使用前必须改配置区，否则会找不到模板与输出目录。 - 社区维护：来源为 community，版本 1.0.0；SkillHub 页面显示评分 100000、下载约 769 次（数据以页面统计为准，会变动）。
结尾¶
「o2o商品缺断分析」把多店缺断周报从重复制表收敛成可对话触发的运营 Skill：统一缺断口径、批量出 Excel 与横向对比，并预留脚本化扫描导出文件的路径。若你的栈是 Cursor + SkillHub，可从官方页面或坐标 @user_40ba62fc/o2o-stockout-analysis 安装，再按上文关键词与 @文件 门店名 的格式开始第一轮周报生成。
官方地址：https://api.skillhub.cn/user_40ba62fc/o2o-stockout-analysis
