把三期报表合成一张
与一键体验入口一致把这三期临期报表合成一张汇总:按期次排序,逐条标已过期 / 历史临期 / 新增,带上首次出现期次和累计期数。
一份报表进来,一张协作表出去
区域每期上报临期品报表,需要逐期对比识别「新增 / 历史 / 已过期」,再分发到门店协作处理。人工比对 Excel 易漏易错,且无统一台账。
从输入到输出 · 每个节点谁在做什么
WorkBuddy 环节遇到的问题与解法
卡点 1(对应第 2 步) · 多期比对时「同一个商品」的认定口径易漂移
解法:主键锁定「商品编码 + 仓位编码」,四期必须一致,写成不可破坏的硬约束
卡点 2(对应第 2 步) · 一条商品同时符合多类,会被重复计数
解法:三分类互斥,按「已过期 > 历史 > 新增」优先级只归一类
卡点 3(对应第 3 步) · 比对结果错了很难被发现
解法:自检等式作为交付门槛:三类之和 = 总数、写入数 = 有效行数,不成立就停下报错
参考输入 · 本页的目标企业是 5 家示例企业(见推荐任务第 1 条), 直接把它们换成你自己的目标企业即可,字段、来源范围、评分口径都不用动。名单里的工商信息不预填,由 Agent 逐家检索。
企业微信(可选)· 接入企业微信后,跑完直接写成一张智能表,采购打开就能建联。 没有接入也能跑完:结果以 Excel 交付,按三步导入企微即可(智能表格 → 导入 Excel → 选文件)。
前提 · 多期报表必须用同一套主键认定「同一个商品」;三类标签互斥、每条只归一类;交付前自检等式必须成立(三类之和 = 总数、写入数 = 有效行数)。
操作步骤
交付有两种落法:已接入企业微信 → 直接建智能表并回链接;未接入 → 输出可导入的 Excel + 三步导入说明,内容一致。
以下提示词用于让 WorkBuddy 搭建这个场景的技能,不是单次任务提示词;使用时按交互选项确认门店范围、快照时点与是否生成派发草案,示例数据随技能包提供。
你好 WorkBuddy,请严格按本文件执行以下任务。
## 你的角色与核心功能
你是零售临期品数据处理助手。用户会上传多期「商品临期预警报表」(Excel,每期一个文件)。你需要:
1. 读取全部报表,按期次时间线排序(最早 → 最新),以最新一期为基准。
2. 逐条判定每个商品归入三类之一:**已过期 / 历史临期品 / 新增临期品**。
3. 为每条生成可追溯溯源信息(首次出现期次、出现过哪几期、累计出现期数、数据来源行号)。
4. 在**企业微信智能表格**建一张多人协作汇总表,写入结果,设好默认视图,预留协作填写列。
5. 返回表格在线链接。
## 前置条件与依赖(开工前先确认)
- 已连接并**授权「企业微信」连接器**。若未授权,停下来提示用户去授权。
- `wecom-cli` ≥ 1.2.1;缺失或过低则自动安装/升级。
- Python + `openpyxl`;缺失则装到隔离环境。
- 用户报表必须含以下**必要字段**(列名要能对上,缺失则停下来问用户,不要猜):
`商品编码`、`仓位编码`、`距离失效日期天数`、`距离临期天数`、`失效日期`。
可选字段:`小类名称`、`经营大类`、`数量`、`是否可退`、`采购部门`、`原因分析`。
## 【配置区】(用户可改这里;未改则用默认值)
{
"periods": "AUTO",
"primary_key": ["商品编码", "仓位编码"],
"expire_threshold_days": 0,
"unprocessed_rule": "跨期仍出现 且 处理措施为空",
"tag_priority": ["已过期", "历史临期品", "新增临期品"],
"include_disappeared": false,
"keep_multi_batch": true,
"output_platform": "wecom_smartsheet",
"table_name": "临期品协作汇总表",
"sheet_title": "临期品协作汇总",
"default_view": {
"group_by": "分类标签",
"sort_by": "距离临期天数",
"sort_desc": false,
"frozen_field_count": 2
}
}
### 配置项含义
- periods:期次顺序与最新期,默认 AUTO(从文件名「X月上/下旬」自动识别并升序,末位为最新);可手动数组如 ["6下","7下","8上","8下"]
- primary_key:判定「同一个商品」的主键,默认 ["商品编码","仓位编码"];可选 ["商品编码"](跨仓合并)/ ["商品编码","失效日期"](按批次)
- expire_threshold_days:已过期判定,距离失效日期天数 ≤ 此值,默认 0
- unprocessed_rule:未处理口径,默认「跨期仍出现 且 处理措施为空」
- tag_priority:命中多类时的归类优先级,默认 已过期 > 历史临期品 > 新增临期品;三类互斥,每条只归一类
- include_disappeared:是否纳入「历史出现过、最新期已消失」的商品,默认 false
- keep_multi_batch:同主键同期多行(不同批次)默认 true 保留多行
- output_platform:wecom_smartsheet / local_excel / tencent_docs
- default_view:分组字段=分类标签,排序=距离临期天数升序(最紧急在前),冻结前 2 列
## 列结构(建表时按此初始化)
- **A 报表关键列(只读参考)**:分类标签、商品编码、小类名称、经营大类、仓位编码、数量、失效日期、距离失效天数、距离临期天数、是否可退、采购部门、系统原因(参考)
- **B 溯源列(比对自动生成)**:首次出现期次、出现期次、累计出现期数、数据来源
- **C 协作填写列(留空待人工填)**:原因分析、处理措施
字段类型:`分类标签`=单选(已过期/历史临期品/新增临期品);`数量`/`距离失效天数`/`距离临期天数`/`累计出现期数`=数字;其余=文本。
## 执行步骤
1. 读取全部报表,**过滤商品编码为空的脏行**;按 periods 排序,确定历史期与最新期。
2. 建立「主键 → 出现期次集合」映射。
3. 对最新期逐条按 tag_priority 判定:
- 距离失效日期天数 ≤ expire_threshold_days → **已过期**
- 否则主键在任一历史期出现过 → **历史临期品**
- 否则 → **新增临期品**
4. 生成溯源列;按 include_disappeared、keep_multi_batch 处理边界。
5. 打印分类统计(三类各几条、总数)给用户确认。
6. 按 output_platform 落地。企微智能表格流程:`wecom-cli smartsheet create` 一次性初始化字段 → 读单选选项**真实ID** → 批量 `records add` 写入 → `views update` 设分组/排序/列宽/冻结。
7. 返回表格在线链接。
## 验证是否成功(逐项自检并报告)
1. 建表接口返回 errcode: 0,拿到可访问链接。
2. 写入记录数 == 最新期有效行数(已去空编码行)。
3. 三类标签数量之和 == 总记录数。
4. 抽查一条「历史临期品」其「出现期次」含历史期;抽查一条「新增临期品」其「出现期次」仅含最新期。
5. 打开链接确认:已按分类标签分组、按距离临期天数升序、字段全可见、协作列为空待填。
## 调整约束(改配置时你必须遵守)
- **可自由改**:表名/子表名、列宽、视图分组排序、过期阈值、C 组协作列增减、落地平台。
- **谨慎改** primary_key:它决定「同一商品」判定;**四期必须用同一套主键**,否则跨期比对失效。
- **不可破坏的核心**:① 空编码行过滤;② 三类标签互斥、每条只归一类;③ 跨期用统一主键。
- 改完任何配置,**必须重跑验证第 2、3 条**(两个等式成立即说明核心未被破坏)。
## 执行完成后:把本流程保存为可复用 skill
任务成功交付(表格建成并通过验证)后,请把本套流程固化为一个 skill,方便我以后一句话复用:
1. 在 ~/.workbuddy/skills/retail-nearexpiry-wecom-sheet/ 目录下创建 SKILL.md。
2. SKILL.md 需包含 YAML front-matter(name: retail-nearexpiry-wecom-sheet、一句话 description),正文把「核心功能、前置依赖、配置区、列结构、执行步骤、验证方法、调整约束」完整写入。
3. 额外记录两个已知坑:① 读 Excel 时每行要立即解析成 dict,禁止在循环内用闭包延迟捕获变量;② `wecom-cli smartsheet views update` 同时传 property 与 col_infos 可能把 field_visibility 全置 false,需随后单独再发一次 views update 把所有字段设回可见。
4. 创建完成后告诉我 skill 已安装,并说明之后触发方式(例如说「用临期品比对」并上传报表即可)。
若我本次只想一次性执行、暂不保存,可忽略本节。
本页按真实链路走一遍;看的是每一步交出去什么、卡在哪、哪些必须人来定
把下面这条链路按顺序跑一遍,产出物直接可派发。看的是每一步的输入输出,以及哪些环节会被拦下来要人确认。
产出物按源材料的交付形态给,能直接派发
示例数据仅用于体验与功能演示,不代表真实经营结果;换自己的数据,替换「输入参考文件」里的三期报表即可。
多期比对时「同一个商品」的认定口径易漂移
判断依据:主键锁定「商品编码 + 仓位编码」,四期必须一致,写成不可破坏的硬约束
一条商品同时符合多类,会被重复计数
判断依据:三分类互斥,按「已过期 > 历史 > 新增」优先级只归一类
比对结果错了很难被发现
判断依据:自检等式作为交付门槛:三类之和 = 总数、写入数 = 有效行数,不成立就停下报错
本次演示的技能与输入参考文件在同一个技能包里。下面这段与方案详情页「一键体验」入口给出的安装说明一致 —— 手动复制提示词到 WorkBuddy 前,先按它装一次即可:
【准备】这个场景的规则都在「供应商寻源助手」技能里。如果还没装,依次执行下面两条命令把它装好(两个链接都是公开地址,不需要登录;装过会自动跳过,可放心重复执行): curl -L -o install_skill.py "https://workbuddy-space-static.codebuddy.work/page/C4IMIxqXQDzznN6KEtzqft/1/install_skill.py" python3 install_skill.py "https://workbuddy-space-static.codebuddy.work/page/SvGJ9doPDCJ1Qp5d46NM0q/3FPDHByGjMxW/pkg.zip" 脚本会把技能装到本机技能目录,并把本次的演示数据取到当前目录的「输入参考文件」里。如果没有 curl,用任意方式把脚本文件下载下来再执行即可。
点「复制」拿走整段描述,粘进 WorkBuddy 即可
把这三期临期报表合成一张汇总:按期次排序,逐条标已过期 / 历史临期 / 新增,带上首次出现期次和累计期数。
只看本期新增的临期品:商品、门店、到期日、剩余天数、来源行号。历史的先不管。
给每条记录补溯源:首次出现在哪期、哪几期出现过、累计几期、源文件哪一行。缺的标「待补」。
按剩余天数排序,最紧急的放最前,同一天到期的按门店分组。给前 20 条。
把这批数据建成企微智能表:分类分组、冻结关键列,预留处理人 / 处理方式 / 完成时间三列。建不了就给可导入 Excel。
核对期次与源文件:每期条数、日期范围、有没有重复导入同一期。输出对账表。
把已过期的单独拉一张表:商品、门店、到期日、应下架时间、责任人待填。
把门店范围换成另一个区,重跑一遍,说明哪些商品是这批门店独有的。
给门店写一段派发话术:这批临期品有几条、最急的几号到期、要在什么时间前处理完。不夸大。
把这套流程沉淀成模板:期次命名、判类规则、汇总列、协作列各一页,下周只换文件。
Live Demo 里有这个场景从两份蓝本到字段结构的完整走法;推荐任务里还有另外 9 条可以换着试的任务
回到场景引入看这个场景的痛点、做法与边界;或者去推荐任务,换着试另外 9 条任务
返回场景引入查看痛点、做法与边界,或返回 Live Demo 查看操作流程。