a-docs/README.md

# 安徽万邦餐饮 · AI 技能仓库总览

> **组织**：`client-wanbang` · **仓库数**：20 + 1 公共库 · **维护方**：匠厂
>
> 所有技能均基于企业微信生态落地，知识源统一挂载 `wanbang-commons`，更新知识源后各技能自动同步。

---

## 目录

### 一、核心刚需：加盟商问答（RAG类）
- [answer-recipe-question](#1-answer-recipe-question)
- [answer-operation-sop](#2-answer-operation-sop)
- [answer-policy-question](#3-answer-policy-question)

### 二、新品与培训
- [broadcast-new-product](#4-broadcast-new-product)
- [generate-product-training-doc](#5-generate-product-training-doc)

### 三、招商线索管理
- [qualify-franchisee-lead](#6-qualify-franchisee-lead)
- [followup-inactive-lead](#7-followup-inactive-lead)

### 四、门店数据运营
- [collect-store-daily-report](#8-collect-store-daily-report)
- [summarize-store-weekly](#9-summarize-store-weekly)

### 五、内部管理提效
- [extract-contract-key-terms](#10-extract-contract-key-terms)
- [extract-invoice-info](#11-extract-invoice-info)
- [generate-meeting-minutes](#12-generate-meeting-minutes)

### 六、内容营销
- [generate-xhs-note](#13-generate-xhs-note)
- [optimize-xhs-tags](#14-optimize-xhs-tags)
- [write-franchise-story](#15-write-franchise-story)
- [reply-douyin-comment](#16-reply-douyin-comment)

### 七、采购与开店
- [compare-supplier-quote](#17-compare-supplier-quote)
- [write-store-opening-checklist](#18-write-store-opening-checklist)

### 八、公共知识底座
- [wanbang-commons](#19-wanbang-commons)

---

## 一、核心刚需：加盟商问答（RAG类）

---

### 1. answer-recipe-question

**仓库描述**：加盟商配方问答：在企微群自动识别"配方/比例/糖量/步骤"类问题，从产品标准手册中精准检索并回复，支持图文+文字，回复准确率与手册保持同步

**痛点背景**：1000家加盟商每天通过企微群大量咨询产品配方，如"芒果奶茶糖量是多少""玉米汁热饮和冷饮比例一样吗"，督导团队每天有大量时间消耗在重复性回答上。

#### 触发条件

| 触发类型 | 示例关键词 |
|----------|-----------|
| 配方询问 | 配方、比例、糖量、奶量、茶底、配料 |
| 步骤询问 | 怎么做、步骤、流程、顺序 |
| 规格询问 | 大杯、中杯、加冰、热饮、冷饮 |
| 新品询问 | 新品怎么做、XXX配方是什么 |

#### SOP 流程

```
1. 消息接收
   └─ 监听企微群内所有成员消息
   └─ 过滤非配方相关消息（不响应闲聊、投诉、与产品无关内容）

2. 意图识别
   └─ 判断是否为配方/操作类问题
   └─ 提取产品名称（如"芒果奶茶"、"玉米汁"）
   └─ 提取规格信息（如大杯/中杯、热/冷、加料）
   └─ 置信度 < 阈值 → 回复"请问您是想了解哪款产品的配方？"

3. 知识检索（RAG）
   └─ 从 wanbang-commons 产品配方手册向量库中检索
   └─ 匹配产品名称 + 规格组合
   └─ 返回最相关的配方条目（Top-3）
   └─ 若检索无结果 → 转人工并附注"暂无该产品配方记录"

4. 回复生成
   └─ 按标准格式输出：
      ✅ 产品名称
      📋 原料清单（含规格/克重/毫升数）
      📝 制作步骤（分步编号）
      ⚠️ 注意事项（如"热饮减冰不减糖"）
   └─ 如有配套图片 → 附带产品标准图

5. 兜底处理
   └─ 回复末尾统一附加："如有疑问请联系您的专属督导"
   └─ 识别失败或涉及定制要求 → @对应督导处理
   └─ 将本次问答记录写入日志（问题、产品、答复、时间、群ID）
```

#### 知识源要求

- `wanbang-commons/recipes/` 目录下全部产品配方文档
- 文档格式：每款产品独立文件，包含产品名、所有规格、原料表、步骤
- 更新频率：新品上线时同步更新，修改配方时72小时内同步

#### 输出示例

```
🧋 【芒一Q芒果奶茶 · 大杯 · 冷饮】

原料：
• 茶底（金萱乌龙）：350ml
• 鲜奶：100ml
• 芒果果酱：45g
• 糖浆：25ml
• 冰块：适量

制作步骤：
1. 杯中加入冰块至八分满
2. 倒入茶底350ml
3. 加入芒果果酱45g，搅拌均匀
4. 加入鲜奶100ml
5. 封杯摇匀，贴标出餐

⚠️ 注意：热饮版去冰，糖浆减至20ml
如有疑问请联系您的专属督导 🙋
```

---

### 2. answer-operation-sop

**仓库描述**：门店操作SOP问答：自动回答开店流程、设备清洁、卫生标准、收银操作等标准化操作类问题，知识源为总部SOP手册，回答格式按步骤结构化输出

**痛点背景**：加盟商在日常经营中频繁遇到操作规范类问题，如开店前检查流程、设备清洁周期、收银系统操作等。这类问题有标准答案但分散在多份手册中，加盟商懒得翻文档，习惯直接问人。

#### 触发条件

| 触发类型 | 示例关键词 |
|----------|-----------|
| 开关店 | 开店、关店、营业前、打烊、开店流程 |
| 设备操作 | 机器怎么用、设备、封口机、制冰机、奶茶机 |
| 卫生清洁 | 清洁、消毒、卫生、清洗频率 |
| 收银系统 | 收银、退款、打折、会员、小票 |
| 食品安全 | 保质期、存储、冷藏、过期 |

#### SOP 流程

```
1. 消息接收与意图识别
   └─ 判断是否为操作规范类问题
   └─ 提取操作场景（开店/设备/卫生/收银/食安）
   └─ 提取具体对象（如"封口机""冰箱""POS机"）

2. 知识检索
   └─ 从 wanbang-commons/sop/ 目录检索对应手册章节
   └─ 优先匹配精确场景，其次匹配相关章节
   └─ 无匹配结果 → 提示"请发送具体操作问题，或联系督导"

3. 回复生成
   └─ 输出格式：
      📌 操作名称
      🔢 步骤列表（编号，每步不超过2句）
      ⏱️ 频率/时间要求（如每日/每周）
      ⚠️ 常见错误提示
   └─ 步骤超过8步时：先输出摘要，再分段输出详细步骤

4. 兜底与升级
   └─ 涉及设备报修 → 引导填写报修单并推送督导
   └─ 涉及食品安全投诉 → 直接转人工，标记为紧急
   └─ 所有问答记录入日志
```

#### 知识源要求

- `wanbang-commons/sop/` 目录下：开关店SOP、设备操作手册、卫生标准、收银操作指南、食品安全规范
- 每份文档需有明确的章节标题和步骤编号，便于检索定位

---

### 3. answer-policy-question

**仓库描述**：加盟政策问答：自动回答加盟费用、区域保护、续约政策、违约条款等政策类问题，知识源为加盟合同与政策手册，敏感问题自动转人工

**痛点背景**：加盟商在经营过程中频繁询问政策问题，如"我能在隔壁区再开一家吗""合同到期续约费用是多少""我想提前退出怎么办"——这类问题若回答不准确会产生纠纷，需要从官方文件中精准检索。

#### 触发条件

| 触发类型 | 示例关键词 |
|----------|-----------|
| 费用类 | 加盟费、保证金、续约费、年费、服务费 |
| 区域保护 | 区域保护、能不能再开、隔壁、同城 |
| 合同类 | 合同、到期、续约、终止、违约 |
| 权益类 | 我有什么权利、总部义务、支持政策 |
| 退出类 | 不想做了、退出、转让、转让门店 |

#### SOP 流程

```
1. 意图识别与敏感度判断
   └─ 识别政策问题类型
   └─ 标记敏感等级：
      - 低敏：费用查询、续约时间等 → 直接回答
      - 中敏：区域保护争议、合同解释 → 回答+提示以合同为准
      - 高敏：违约、退出、投诉总部 → 直接转人工，不自动回答

2. 知识检索
   └─ 从 wanbang-commons/policy/ 检索对应条款
   └─ 精确引用条款编号和原文摘要（不做解释，只引用）
   └─ 多条款冲突时：全部列出，标注"请以最新版合同为准"

3. 回复生成
   └─ 低/中敏问题输出格式：
      📋 政策要点（1-3条）
      📎 依据来源（如"参见加盟合同第X条"）
      ⚠️ 免责声明："以上为一般性说明，具体以您签订合同为准，如有疑问请联系招商专员"
   └─ 高敏问题：
      "您的问题涉及合同条款，为保障您的权益，已为您转接专属招商专员，请稍候。"
      → 同步推送消息给对应招商专员，附带问题内容和加盟商信息

4. 日志记录
   └─ 记录：问题类型、敏感等级、是否转人工、加盟商ID、时间
   └─ 高频政策问题每周汇总推送给运营负责人，用于政策文件优化
```

---

## 二、新品与培训

---

### 4. broadcast-new-product

**仓库描述**：新品上线企微群播报：总部录入新品信息后，自动向所有加盟商企微群推送标准化通知（产品介绍/上架时间/定价/制作要点），并收集各群"已收到"回执统计

**痛点背景**：每次新品上线，运营人员需手动复制粘贴通知到几十个企微群，且无法确认哪些加盟商已读，事后还要逐一催确认。

#### SOP 流程

```
1. 信息录入（由总部运营人员操作）
   └─ 填写新品信息表单：
      - 产品名称、所属系列
      - 上架时间（精确到日期）
      - 建议零售价（各规格）
      - 制作要点摘要（3-5条）
      - 配套宣传图（1-3张）
      - 培训材料文件链接（关联 generate-product-training-doc）
   └─ 选择推送范围（全部群 / 指定区域群 / 指定门店）
   └─ 设置推送时间（立即 / 定时）

2. 自动推送
   └─ 按计划时间向目标企微群发送标准化消息
   └─ 消息格式：
      🆕 【新品上线通知】产品名称
      📅 上架时间：XXXX年XX月XX日
      💰 建议售价：大杯XX元 / 中杯XX元
      ✨ 产品亮点：（3条卖点）
      📋 制作要点：（3-5条关键步骤）
      🖼️ [产品图片]
      📥 完整培训文档：[链接]
      ---
      请回复"收到"确认已阅读 ✅

3. 回执收集
   └─ 监听各群"收到""✅""已阅"等确认关键词
   └─ 实时更新回执统计表（群名称、回复人、回复时间）
   └─ 推送后24小时内未回复的群 → 自动发送一次提醒
   └─ 48小时后仍未回执 → 推送至对应督导，由督导人工跟进

4. 统计报告
   └─ 推送完成后生成播报报告：
      - 总推送群数 / 已回执群数 / 未回执群数
      - 未回执群列表（含负责督导）
   └─ 报告推送给运营负责人
```

---

### 5. generate-product-training-doc

**仓库描述**：新品培训材料生成：输入新品名称、原料、卖点，自动生成加盟商培训文档（制作步骤/常见错误/推荐话术/顾客FAQ），格式统一可直接下发

**痛点背景**：每次新品上线，运营人员需从零撰写培训文档，格式不统一，耗时2-3天，且常遗漏常见错误提示和销售话术。

#### SOP 流程

```
1. 信息输入
   └─ 必填项：
      - 产品名称
      - 产品系列（奶茶/玉米汁/甜点/小吃）
      - 原料清单（名称+规格+用量）
      - 核心卖点（1-3个）
      - 目标客群（学生/白领/家庭等）
   └─ 选填项：
      - 竞品对比信息
      - 季节/节日属性
      - 特殊工艺说明

2. 文档生成
   └─ AI 自动生成标准化培训文档，包含以下模块：
   
   模块一：产品概述（1页）
   - 产品名称、所属系列、上市背景
   - 核心卖点（提炼为3句话）
   - 适用场景和目标客群
   
   模块二：制作步骤（详细版）
   - 所需原料和工具清单
   - 分步骤图文说明（每步附操作要点）
   - 出品标准（颜色、口感、温度）
   - 摆盘/包装规范
   
   模块三：常见错误与解决方案
   - 列举5-8个高频错误（如"糖浆加多了怎么补救"）
   - 每个错误附原因分析+解决方法
   
   模块四：销售话术
   - 主推话术（适用于主动推荐）
   - 应答话术（顾客问"这什么口味"等）
   - 促单话术（搭配推荐）
   
   模块五：顾客FAQ
   - 预设10个顾客常见问题及标准回答
   - 含过敏原、热量、可否定制等

3. 格式输出
   └─ 输出为 Word / PDF 双格式
   └─ 封面自动填入：产品名称、文档版本、生效日期、制作人
   └─ 同步上传至 wanbang-commons/training/ 目录归档

4. 关联推送
   └─ 生成完成后自动通知 broadcast-new-product 技能，提供文档链接
```

---

## 三、招商线索管理

---

### 6. qualify-franchisee-lead

**仓库描述**：加盟意向资质初筛：通过企微/公众号与意向用户自动对话，收集投资预算、目标城市、有无餐饮经验等关键信息，按预设标准评分并分级推送给对应招商专员

**痛点背景**：招商专员每天接待大量意向咨询，但很多咨询者资金不足或城市不符合开店条件，大量时间浪费在不合格线索上。

#### SOP 流程

```
1. 线索接入
   └─ 触发场景：
      - 公众号用户发送"加盟""合作""开店""代理"等关键词
      - 企微添加官方账号后首次发消息
      - 抖音/小红书私信引流至企微后的首次对话

2. 自动对话收集（5步问答，控制在3分钟内完成）
   
   第1问：您好！感谢您对芒一Q的关注 🎉
         请问您主要考虑在哪个城市/区域开店？
         （收集：目标城市）
   
   第2问：请问您计划的初期投资预算大概在哪个范围？
         A. 5万以内  B. 5-10万  C. 10-20万  D. 20万以上
         （收集：资金预算）
   
   第3问：您之前有过餐饮从业或经营经验吗？
         A. 有餐饮店经营经验  B. 有其他创业经验  C. 全新起步
         （收集：从业背景）
   
   第4问：您计划什么时候开始筹备开店？
         A. 1个月内  B. 1-3个月  C. 3-6个月  D. 6个月以上
         （收集：意向紧迫度）
   
   第5问：最后，请留下您的姓名和联系电话，
         我们的招商专员会在1个工作日内与您联系 📞
         （收集：姓名、手机号）

3. 资质评分
   └─ 按以下维度自动评分（满分100）：
      - 目标城市是否在可开放区域：30分（是30/否0/待核实15）
      - 投资预算是否达标（≥10万）：30分（达标30/接近20/不足0）
      - 意向紧迫度：20分（1个月内20/1-3月15/3-6月10/6月+5）
      - 有无经营经验：20分（餐饮20/其他创业12/全新6）

4. 分级推送
   └─ A级（80分以上）：
      → 立即推送给高级招商专员，标注"优质线索，建议当日跟进"
      → 同步发给意向用户："您的信息已提交，招商专员将在2小时内联系您"
   └─ B级（50-79分）：
      → 推送给招商专员，标注"普通线索，3个工作日内跟进"
   └─ C级（50分以下）：
      → 进入培育池，由 followup-inactive-lead 定期跟进
      → 自动回复："感谢您的关注，我们会持续为您推送品牌资讯，欢迎随时咨询"

5. 数据入库
   └─ 所有线索信息写入线索管理表：
      姓名 / 手机 / 城市 / 预算 / 评分 / 分级 / 来源渠道 / 创建时间 / 分配专员
```

---

### 7. followup-inactive-lead

**仓库描述**：沉默线索自动跟进：检测超过N天未有互动的意向加盟商，自动通过企微发送跟进消息（可配置话术模板），并记录跟进状态，提醒招商专员重点关注

**痛点背景**：招商专员跟进100+线索时，对没有主动回复的线索容易遗忘，导致有意向但时机未到的客户自然流失。

#### SOP 流程

```
1. 沉默检测（每日定时执行）
   └─ 读取线索管理表，检测以下状态：
      - B级线索：超过3天无互动
      - C级线索：超过7天无互动
      - 曾互动但未完成资质收集：超过2天无回复
   └─ 生成当日待跟进线索列表

2. 自动跟进消息发送
   └─ 按以下节奏发送（同一线索最多3轮自动跟进）：
   
   第1轮（首次沉默）：
   "您好 [姓名]，上次咱们聊到您对芒一Q [城市] 的加盟意向，
   不知道您最近有没有机会进一步了解？
   最近我们在 [城市周边] 有几家新店开业，效果不错，
   欢迎来门店实地参观体验 😊"
   
   第2轮（间隔5天）：
   "您好！分享一下我们加盟商的真实案例——
   [引用1条成功加盟商案例数据，来自 write-franchise-story]
   如果您还在考虑中，欢迎随时联系我们聊聊 🙌"
   
   第3轮（再间隔7天）：
   "您好，最近品牌有一个 [限时政策/活动]，
   [简要说明优惠内容]，截止 [日期]。
   如有意向欢迎尽快联系，我们为您详细介绍 📋"

3. 响应处理
   └─ 线索回复 → 立即推送通知给对应招商专员接管
   └─ 3轮跟进均无响应 → 标记为"长期沉默"，移入年度唤醒池
   └─ 线索明确表示不考虑 → 标记为"已放弃"，停止跟进

4. 专员提醒
   └─ 每周一推送"重点跟进线索周报"给各招商专员：
      - 本周新增A级线索
      - 本周进入第3轮跟进的线索（需专员人工介入）
      - 本周回复但未转化的线索
```

---

## 四、门店数据运营

---

### 8. collect-store-daily-report

**仓库描述**：门店日报自动催收：每日定时在企微群发送日报填报提醒，加盟商按模板回复后自动解析数据入库，未回复门店自动二次提醒并标记，生成当日上报率统计

**痛点背景**：1000家门店靠人工催报数据，每天消耗大量人力，且数据格式五花八门，后续汇总极难。

#### SOP 流程

```
1. 定时催报（每日固定时间，建议21:00）
   └─ 向所有加盟商企微群/单聊发送：
   
   "📊 【今日营业数据上报】
   请按以下格式回复本条消息：
   
   日期：[自动填入当日日期]
   营业额：____元
   杯数：____杯
   客单价：____元
   外卖单数：____单（无则填0）
   今日异常：____（无则填"无"）
   
   ⏰ 请于23:00前完成上报，谢谢配合！"

2. 数据接收与解析
   └─ 监听群内/单聊回复消息
   └─ 识别符合格式的上报数据
   └─ 自动解析字段并写入数据库：
      门店ID / 日期 / 营业额 / 杯数 / 客单价 / 外卖单数 / 异常备注 / 上报时间
   └─ 格式不符的回复 → 自动回复"格式有误，请参照模板重新填写"并附模板

3. 未报提醒（22:00执行）
   └─ 检测未上报门店
   └─ 发送二次提醒："⏰ 温馨提醒：今日营业数据还未上报，请在23:00前完成，谢谢！"

4. 统计汇总（23:30执行）
   └─ 生成当日上报统计：
      - 应报门店数 / 已报数 / 未报数 / 上报率
      - 未报门店列表（含对应督导）
   └─ 推送给运营负责人和各督导
   └─ 督导负责跟进本区域未报门店

5. 数据质量检测
   └─ 自动识别异常数据（如营业额为0但杯数不为0）
   └─ 标记异常数据，次日推送给对应督导核实
```

---

### 9. summarize-store-weekly

**仓库描述**：门店周报自动汇总：汇总全网门店上报数据，自动计算环比/同比变化，标注异常门店（销售骤降/未上报/数据异常），生成结构化周报推送给督导和管理层

**痛点背景**：每周汇总1000家门店数据，人工至少需要1-2天，且容易出错，管理层无法及时获得全网运营状态。

#### SOP 流程

```
1. 数据聚合（每周一凌晨自动执行）
   └─ 读取上周7天的门店日报数据
   └─ 按门店、区域、城市三个维度聚合
   └─ 计算核心指标：
      - 周营业额（合计 / 日均）
      - 周销量（合计 / 日均杯数）
      - 客单价（周均）
      - 外卖占比
      - 上报率（上报天数/7天）

2. 趋势计算
   └─ 环比（与上周对比）：营业额±% / 销量±%
   └─ 同比（与去年同期对比，如有历史数据）
   └─ 连续增长/下滑趋势识别（连续3周下滑标记预警）

3. 异常识别与分级
   └─ 🔴 红色预警（需立即跟进）：
      - 本周营业额环比下滑超30%
      - 连续3天以上未上报
      - 营业额连续4周持续下滑
   └─ 🟡 黄色提示（需关注）：
      - 本周营业额环比下滑10-30%
      - 上报率低于70%
      - 客单价异常（偏离均值超20%）
   └─ 🟢 绿色亮点（正向表扬）：
      - 本周营业额环比增长超20%
      - 连续4周持续增长
      - 上报率100%

4. 报告生成
   └─ 管理层版（简报，1页）：
      - 全网总览：总营业额 / 总销量 / 活跃门店数
      - 本周亮点门店TOP5
      - 本周预警门店数量及摘要
      - 与上周/上月对比趋势图
   
   └─ 督导版（详情，按区域）：
      - 本区域各门店数据明细
      - 红色预警门店清单（附建议跟进动作）
      - 黄色提示门店清单
      - 本区域上报率统计

5. 推送
   └─ 每周一09:00推送至对应企微：
      - 管理层版 → 推送给总部管理群
      - 督导版 → 分别推送给各督导
   └─ 红色预警门店同时推送给对应督导和运营负责人
```

---

## 五、内部管理提效

---

### 10. extract-contract-key-terms

**仓库描述**：合同关键条款提取：上传加盟合同/供应商合同PDF，自动提取合同期限、费用条款、违约责任、区域保护、续约条件等核心信息，输出一页结构化摘要

**痛点背景**：加盟合同通常20-50页，管理层审阅每份合同耗时30分钟以上，且重要条款容易遗漏。

#### SOP 流程

```
1. 文件接收
   └─ 支持输入格式：PDF / Word
   └─ 文件大小限制：单文件≤20MB
   └─ 支持批量上传（一次最多5份）

2. 文档解析
   └─ OCR识别（扫描版合同）或直接提取文字（电子版合同）
   └─ 识别合同类型：加盟合同 / 供应商合同 / 租赁合同 / 劳动合同
   └─ 按合同类型调用对应提取模板

3. 关键条款提取（加盟合同版）
   └─ 必提取字段：
      ✅ 合同编号
      ✅ 签约日期
      ✅ 合同期限（起止日期）
      ✅ 甲乙双方名称
      ✅ 加盟区域（城市/商圈）
      ✅ 加盟费金额及支付方式
      ✅ 保证金金额及退还条件
      ✅ 区域保护范围（半径/商圈）
      ✅ 续约条件（费用/时间/条件）
      ✅ 违约责任（甲方/乙方）
      ✅ 合同终止条件
      ✅ 争议解决方式（仲裁/诉讼/管辖地）

4. 输出格式
   └─ 生成一页结构化摘要（Markdown表格格式）：
   
   | 条款项目 | 合同内容摘要 | 原文位置 |
   |---------|------------|---------|
   | 合同期限 | 3年，自XXXX年XX月XX日至XXXX年XX月XX日 | 第2条 |
   | 加盟费 | 人民币XX万元，签约时一次性付清 | 第5条第1款 |
   | ... | ... | ... |
   
   └─ 摘要末尾附风险提示：
      ⚠️ 自动提取结果仅供参考，请以原合同条款为准，
         重要合同建议由法务/专业顾问审核。

5. 归档
   └─ 摘要文件自动命名：[合同类型]_[乙方名称]_[签约日期]_摘要.md
   └─ 存入对应目录备查
```

---

### 11. extract-invoice-info

**仓库描述**：发票信息自动提取：上传发票图片或PDF，自动识别并提取发票号、开票日期、含税金额、税率、购销方名称，输出结构化数据供财务直接录入系统

**痛点背景**：财务人员每月处理大量发票，手工录入既耗时又容易出错，单张发票录入平均需要3-5分钟。

#### SOP 流程

```
1. 文件接收
   └─ 支持格式：JPG / PNG / PDF
   └─ 支持批量上传（一次最多50张）
   └─ 支持拍照上传（自动纠偏、增强对比度）

2. OCR识别
   └─ 识别发票类型：
      - 增值税专用发票
      - 增值税普通发票
      - 电子发票
      - 收据
   └─ 图像预处理：自动旋转、去噪、增强

3. 字段提取
   └─ 提取字段：
      - 发票代码
      - 发票号码
      - 开票日期
      - 购方名称
      - 购方税号
      - 销方名称
      - 销方税号
      - 商品/服务名称
      - 规格型号
      - 数量
      - 单价
      - 不含税金额
      - 税率
      - 税额
      - 含税总金额（价税合计）
      - 备注

4. 数据校验
   └─ 金额校验：不含税金额 + 税额 = 含税总金额（误差<0.01元）
   └─ 税率合理性校验（常见税率：0% / 1% / 3% / 6% / 9% / 13%）
   └─ 日期格式标准化（统一为YYYY-MM-DD）
   └─ 校验不通过 → 标记为"需人工核查"，不入库

5. 输出
   └─ 单张：结构化JSON或Excel行数据
   └─ 批量：汇总Excel，每张发票一行，含所有字段
   └─ 异常发票单独列表，附异常原因
   └─ 统计摘要：共处理X张，成功X张，异常X张，总金额XX元
```

---

### 12. generate-meeting-minutes

**仓库描述**：会议纪要自动生成：上传会议录音或转写文本，自动提取会议主题、讨论要点、决议事项、责任人与截止日期，生成标准格式纪要并推送至指定企微群或成员

**痛点背景**：行政人员整理会议纪要平均需要1-2小时，且容易遗漏决议事项和责任人，导致后续执行混乱。

#### SOP 流程

```
1. 文件接收
   └─ 支持格式：
      - 音频文件（MP3/WAV/M4A）→ 先转文字再处理
      - 文字转写稿（TXT/Word）→ 直接处理
      - 企微会议录音链接 → 自动下载后处理
   └─ 可附加会议基本信息（标题/时间/参会人）提升准确率

2. 语音转文字（音频输入时）
   └─ 调用语音识别服务
   └─ 支持普通话（主要）/ 混合方言
   └─ 多人发言自动分段（无法精确识别发言人时，按段落分段）

3. 内容分析与提取
   └─ 识别会议结构：
      - 开场/议题介绍
      - 讨论过程（各议题）
      - 总结与决议
   
   └─ 提取关键信息：
      ✅ 会议主题（自动识别或提取标题）
      ✅ 会议时间、地点、主持人（如有明确提及）
      ✅ 参会人员（如有点名）
      ✅ 各议题讨论要点（每个议题3-5条）
      ✅ 决议事项（明确的结论/决定）
      ✅ 待办事项（含责任人+截止日期）
      ✅ 遗留问题（未达成共识的事项）

4. 纪要生成
   └─ 输出标准格式：
   
   # 会议纪要
   
   **会议主题**：[主题]
   **会议时间**：[时间]
   **参会人员**：[人员列表]
   **记录人**：[AI自动生成，标注"由AI辅助整理"]
   
   ## 一、讨论要点
   1. [议题1]：[要点摘要]
   2. [议题2]：[要点摘要]
   
   ## 二、决议事项
   | 序号 | 决议内容 | 责任人 | 截止日期 |
   |------|---------|--------|---------|
   | 1 | [决议] | [姓名] | [日期] |
   
   ## 三、待办事项
   - [ ] [事项] — 责任人：[姓名] — 截止：[日期]
   
   ## 四、遗留问题
   - [问题描述]（下次会议跟进）

5. 推送与归档
   └─ 生成完成后推送给指定企微群或成员
   └─ 待办事项自动创建提醒（按截止日期提前1天通知责任人）
   └─ 纪要文件归档至会议记录目录，按年月分类存储
```

---

## 六、内容营销

---

### 13. generate-xhs-note

**仓库描述**：小红书种草笔记生成：输入产品/门店/活动信息，自动生成符合小红书语气的图文笔记（标题含emoji、正文分段、结尾互动引导），含备选标题3条

#### SOP 流程

```
1. 信息输入
   └─ 必填：产品名称或活动主题
   └─ 选填：目标城市、门店地址、价格、活动时间、配图描述
   └─ 风格选择：清新/治愈 / 搞笑接地气 / 精致生活 / 探店测评

2. 笔记生成
   └─ 自动生成3个备选标题（含emoji，字数20字以内）
   └─ 正文结构：
      - 开头钩子（吸引点击，1-2句）
      - 产品/活动介绍（2-3段，每段3-4行）
      - 实测体验描述（口感/颜值/性价比）
      - 结尾互动引导（"你们有没有喝过？" / "来评论区聊聊~"）
   └─ 字数控制在300-500字
   └─ 自然植入地点标签格式

3. 输出
   └─ 3个备选标题 + 1份正文
   └─ 标注建议配图方向（如"产品特写" / "门店打卡" / "制作过程"）
   └─ 发布最佳时间建议（工作日18-21点 / 周末10-12点）
```

---

### 14. optimize-xhs-tags

**仓库描述**：小红书话题标签优化：分析笔记内容与当前平台热门话题，推荐最匹配的20个标签组合，区分流量标签/精准标签/品牌标签三类，提升笔记曝光

#### SOP 流程

```
1. 输入笔记内容或关键词

2. 标签分析与推荐
   └─ 流量标签（5个）：当前平台热门，曝光大但竞争激烈
      示例：#奶茶 #下午茶 #打卡 #好喝不贵
   └─ 精准标签（10个）：与内容高度匹配，精准触达目标用户
      示例：#芒果奶茶 #合肥奶茶 #玉米汁 #加盟创业
   └─ 品牌标签（5个）：品牌专属标签，积累品牌内容池
      示例：#芒一Q #万邦餐饮 #芒一Q加盟

3. 输出
   └─ 20个标签按分类列出，直接可复制粘贴
   └─ 标注每个标签的大致热度级别（高/中/低）
   └─ 建议：优先放精准标签，流量标签穿插其中
```

---

### 15. write-franchise-story

**仓库描述**：加盟商创业故事笔记：根据加盟商真实信息（城市/开店时长/月流水），生成第一人称创业故事笔记，用于招募新加盟商，风格真实接地气

#### SOP 流程

```
1. 信息输入
   └─ 加盟商城市、门店类型（街边/商场/校区）
   └─ 开店时长（如"开店8个月"）
   └─ 月营业额区间（如"月流水3-5万"）
   └─ 创业背景（如"宝妈转行""上班族辞职"）
   └─ 1-2个真实细节（如"第一个月差点放弃"）

2. 故事生成
   └─ 第一人称叙述
   └─ 结构：入坑原因 → 开店经历 → 真实数据 → 现状感受 → 给想加盟者的建议
   └─ 语气：真实、不过度包装，保留"踩过的坑"让读者信任
   └─ 字数：400-600字

3. 发布建议
   └─ 适合平台：小红书（种草）/ 抖音评论区置顶 / 公众号推文
   └─ 配图建议：门店实拍 / 收银截图（打码处理） / 本人出镜
```

---

### 16. reply-douyin-comment

**仓库描述**：抖音评论批量回复：读取视频评论，对咨询类评论生成有温度的回复建议，对加盟意向评论自动引导私信或留联系方式，供运营人员一键发布

#### SOP 流程

```
1. 评论读取
   └─ 接入抖音评论数据（手动导出或API接入）
   └─ 按评论类型分类：
      - 咨询类（产品/价格/门店地址）
      - 加盟意向类（怎么加盟/在哪开/多少钱）
      - 好评互动类（好喝/推荐/打卡）
      - 负面类（投诉/质疑）
      - 闲聊类

2. 回复生成
   └─ 咨询类：根据问题内容生成有信息量的回复
   └─ 加盟意向类：生成引流话术，引导私信或加企微
      示例："加盟合作可以私信我们哦～也可以搜索【芒一Q官方】了解详情 🙌"
   └─ 好评互动类：生成有温度的感谢/互动回复（避免千篇一律）
   └─ 负面类：生成安抚性回复，引导私信处理，不在评论区争论

3. 输出
   └─ 每条评论对应1-2个备选回复
   └─ 运营人员审核后一键发布或手动微调
   └─ 加盟意向评论单独汇总，推送给招商团队跟进
```

---

## 七、采购与开店

---

### 17. compare-supplier-quote

**仓库描述**：供应商报价对比分析：上传多份供应商报价单，自动提取品名/规格/单价/交期/付款条件，生成横向对比表并标注最优选项，辅助采购决策

#### SOP 流程

```
1. 文件接收
   └─ 支持格式：Excel / PDF / Word / 图片
   └─ 每次上传2-5份供应商报价单

2. 数据提取
   └─ 从每份报价单提取：
      - 供应商名称
      - 品名/规格/型号
      - 单价（含单位）
      - 起订量/最小订量
      - 交货期
      - 付款条件（预付比例/账期）
      - 质保条款（如有）
      - 有效期

3. 横向对比
   └─ 以品名为维度生成对比表
   └─ 同一品名不同供应商并排对比
   └─ 自动标注：
      💰 最低价供应商
      ⚡ 最短交期供应商
      📋 付款条件最优供应商
      🏆 综合评分最优（价格40%+交期30%+付款30%）

4. 输出
   └─ Excel格式对比表（含颜色标注）
   └─ 决策建议摘要（1段文字）
   └─ 附注：价格以外的非量化因素（如合作历史、质量口碑）需人工综合判断
```

---

### 18. write-store-opening-checklist

**仓库描述**：新店开业核查清单生成：根据门店城市/面积/类型，自动生成开业前物料清单、证照办理清单、设备安装清单，减少遗漏并统一新店开业标准

#### SOP 流程

```
1. 信息输入
   └─ 门店城市（影响证照要求）
   └─ 门店类型：街边店 / 商场店 / 校区店 / 社区店
   └─ 面积（影响设备数量和物料用量）
   └─ 预计开业日期

2. 清单生成（三份）
   
   清单一：证照办理清单
   └─ 食品经营许可证（含办理流程、所需材料、预计时间）
   └─ 营业执照（个体/公司）
   └─ 消防验收（面积≥200㎡时）
   └─ 健康证（所有员工）
   └─ 按城市差异自动补充地方性要求
   └─ 每项注明：负责人 / 预计办理天数 / 注意事项
   
   清单二：设备安装清单
   └─ 按门店类型和面积输出设备清单
   └─ 每台设备注明：型号/数量/安装位置/验收标准
   └─ 附设备到货-安装-调试时间轴
   
   清单三：开业物料清单
   └─ 原料备货清单（按首周预估销量）
   └─ 包材清单（杯/盖/袋/吸管等，含数量）
   └─ 宣传物料清单（海报/贴纸/价格牌等）
   └─ 办公耗材清单（收银纸/手套/清洁用品等）

3. 输出
   └─ Word格式，每份清单单独一页
   └─ 每项含复选框，支持打印后手工勾选
   └─ 自动填入门店基本信息和预计开业日期
   └─ 倒排时间轴：从当前日期到开业日期，各事项截止节点
```

---

## 八、公共知识底座

---

### 19. wanbang-commons

**仓库描述**：公共知识资产库：存放产品配方手册、门店SOP、加盟政策文件、话术模板等，作为所有问答类技能的统一知识源，文件更新后各技能自动同步

**定位**：这不是一个独立运行的技能，而是所有RAG类技能（`answer-recipe-question` / `answer-operation-sop` / `answer-policy-question`）的**知识底座**，必须优先建设。

#### 目录结构

```
wanbang-commons/
│
├── recipes/                    # 产品配方
│   ├── 奶茶系列/
│   │   ├── 芒果奶茶.md
│   │   ├── 草莓奶茶.md
│   │   └── ...
│   ├── 玉米汁系列/
│   └── 甜点小吃系列/
│
├── sop/                        # 门店操作规范
│   ├── 开关店SOP.md
│   ├── 设备操作手册.md
│   ├── 卫生清洁标准.md
│   ├── 收银系统操作指南.md
│   └── 食品安全规范.md
│
├── policy/                     # 加盟政策文件
│   ├── 加盟费用政策.md
│   ├── 区域保护政策.md
│   ├── 续约与退出政策.md
│   └── 加盟商权益说明.md
│
├── training/                   # 培训材料归档
│   └── [由 generate-product-training-doc 自动写入]
│
└── templates/                  # 话术与模板
    ├── 招商话术库.md
    ├── 投诉处理话术.md
    └── 日报填报模板.md
```

#### 维护规范

| 文件类型 | 更新触发条件 | 负责人 | 更新时限 |
|---------|------------|--------|---------|
| 产品配方 | 新品上线 / 配方调整 | 研发部 | 上线前48小时 |
| 门店SOP | 流程变更 / 新规发布 | 运营部 | 生效前72小时 |
| 加盟政策 | 政策调整 / 合同变更 | 招商部 | 生效前24小时 |
| 培训材料 | 新品上线（自动） | 系统自动 | 实时 |
| 话术模板 | 季度更新 / 活动期 | 市场部 | 活动前7天 |

#### 文档格式规范

所有文档需遵守以下规范，确保RAG检索准确：

```markdown
# 文档标题（精确、唯一）

## 适用范围
[说明适用产品/场景/人员]

## 关键词
[列出该文档的检索关键词，每行一个]

## 正文内容
[内容本体]

## 最后更新
更新日期：YYYY-MM-DD
更新人：[姓名]
版本号：vX.X
```

---

## 附录：技能依赖关系

```
wanbang-commons（知识底座）
    ├── answer-recipe-question（依赖 recipes/）
    ├── answer-operation-sop（依赖 sop/）
    ├── answer-policy-question（依赖 policy/）
    └── qualify-franchisee-lead（依赖 templates/招商话术库）

generate-product-training-doc
    └── 写入 → wanbang-commons/training/
    └── 触发 → broadcast-new-product（提供文档链接）

collect-store-daily-report
    └── 数据写入 → 门店数据库
    └── 供给 → summarize-store-weekly

qualify-franchisee-lead
    └── 不合格线索 → followup-inactive-lead

write-franchise-story
    └── 案例内容 → followup-inactive-lead（第2轮跟进素材）
```

---

## 附录：落地优先级

| 优先级 | 技能 | 落地周期 | 核心依赖 |
|--------|------|---------|---------|
| 🔴 P0 | `wanbang-commons` 知识库建设 | 第1-2周 | 无，必须最先完成 |
| 🔴 P0 | `answer-recipe-question` | 第2-3周 | wanbang-commons |
| 🔴 P0 | `answer-operation-sop` | 第2-3周 | wanbang-commons |
| 🟡 P1 | `answer-policy-question` | 第3-4周 | wanbang-commons |
| 🟡 P1 | `broadcast-new-product` | 第3-4周 | 企微群机器人权限 |
| 🟡 P1 | `collect-store-daily-report` | 第4-5周 | 企微群机器人权限 |
| 🟡 P1 | `summarize-store-weekly` | 第5周 | collect-store-daily-report |
| 🟢 P2 | `qualify-franchisee-lead` | 第5-6周 | 企微接入 |
| 🟢 P2 | `followup-inactive-lead` | 第6周 | qualify-franchisee-lead |
| 🟢 P2 | `generate-product-training-doc` | 第6周 | 无 |
| ⚪ P3 | `extract-invoice-info` | 第7周 | 无 |
| ⚪ P3 | `extract-contract-key-terms` | 第7周 | 无 |
| ⚪ P3 | `generate-meeting-minutes` | 第7周 | 无 |
| ⚪ P3 | 内容营销类（4个） | 第8周 | 无 |
| ⚪ P3 | 采购开店类（2个） | 第8周 | 无 |

---

*文档版本：v1.0 · 生成日期：2026-06-11 · 维护方：匠厂*