临期品预警

一份报表进来,一张协作表出去

一业务背景

区域每期上报临期品报表,需要逐期对比识别「新增 / 历史 / 已过期」,再分发到门店协作处理。人工比对 Excel 易漏易错,且无统一台账。

二这件事原来卡在哪

1
多期报表人工比对,耗时且易漏
2
「新增/历史/已过期」分类口径不一
3
预警结果散落邮件群,无协作追踪载体

三工作链路

从输入到输出 · 每个节点谁在做什么

第 1 步
人工输入
上传多期报表上传本期 + 历史期临期预警报表(如江西 4 期)
第 2 步
WorkBuddy
跨期比对分类以最新一期为基准,逐条判断:已过期 / 历史临期 / 新增临期,并记录首次出现在哪一期
第 3 步
WorkBuddy
统计自检打印三类各多少条供确认;自动校验「三类之和 = 总数」等式成立才继续
第 4 步
企业微信输出
建协作汇总表在企微智能表建表:按分类分组、最紧急的排最前、冻结关键列
第 5 步
人工
门店在线协作处理门店在表里直接填写原因分析与处理措施,形成处理台账

四难点与解法

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 已安装,并说明之后触发方式(例如说「用临期品比对」并上传报表即可)。
    
    若我本次只想一次性执行、暂不保存,可忽略本节。
    全文约 3238 字

    想看具体怎么跑?

    Live Demo 里有这个场景从两份蓝本到字段结构的完整走法;推荐任务里还有另外 9 条可以换着试的任务