餐品配方与制作工艺管理

> Skill职责边界：本 Skill 聚焦餐品技术标准（配方结构 + 制作工艺 + 品质判定 + 营养定制）作为核心能力；13 个运营模块（供应链/HR/数字/品牌/财务/工程/加盟/法务/数据/创新/跨域/战略/专项）在本 Skill 内部以子目录形式提供完整内容（含 README 索引）。详细的食安法规原文/巡店方法论详见 references/legal/ 与 references/specialization/。

触发路由总览

场景A：配方开发（新品/调整）

触发词：新建配方、调整配方、BOM设计、原料配比、烹饪参数、成本测算

工作流：

Step 1 → 产品定位（客群/价格带/差异化）
Step 2 → BOM三层结构（主料+辅料+调料）→ 调 references/bom-model.md
Step 3 → 烹饪技法选择 → 调 references/cooking-techniques.md
Step 4 → 制作流程SOP编写 → 调 references/process-flow.md
Step 5 → BOM成本测算 → 执行 scripts/bom_calculator.py（支持 --demo）
Step 6 → 试菜评审 → 调 references/taste-review.md
Step 7 → 定稿+版本记录 → 调 references/version-control.md

输出：配方文档（BOM表+工艺SOP+成本报告+评审结论）

场景B：门店制作巡检（督导视角）

触发词：巡店、巡检、QSC检查、现场检查、投料检查、温控检查

工作流：

Step 1 → 获取门店配方版本（版本号+生效日期+本地修改）
Step 2 → 现场数据采集（投料±5% / 油温 / 中心温度 / 效期全链路）
Step 3 → 品质判定 → 调 references/quality-standards.md
Step 4 → 输出巡检报告（合格/不合格/关键风险+拍照留证）
Step 5 → 持续追踪（复查不合格项，同问题连续出现→升级）

输出：巡检报告（问题项+整改要求+复检时间）

场景C：配方变更管理

触发词：配方变更、换版本、调整配方、食材替换、成本调价

变更类型：

流程：发起申请 → 评估影响 → 评审/确认 → 版本发布 → 门店同步 → 效果追踪
→ 调 references/version-control.md

场景D：营养定制配方开发

> ⚠️ 强制规则：禁止全量加载营养 SOP（已拆分为 17 个专项文件，禁止同时加载多个）。按需只加载 1 个对应的 sops/nutrition/sop-{人群代码}.md。

触发词：

• 明确词：健身餐/素食/婴儿/孕期/糖尿病/痛风/麸质/减肥/老年人/过敏/清真/低GI/增肌/术后/佛教素/办公族
• 模糊词：健康餐/养生餐/工作餐/员工餐/团餐/套餐 → 必须先展示人群选项表确认，禁止自行推断

执行检查点：

【检查点0】模糊词？→ 展示人群选项表A-Q → 等用户确认
【检查点1】查 nutrition-custom.md 第七节SOP路由索引 → 获取触发词→SOP文件映射
【检查点2】精确加载 `references/sops/nutrition/sop-{人群代码}.md`（仅 1 个，对应人群，如 sop-fitness.md）
【检查点3】配方输出：继承标准配方版本号+后缀 → 原料替代 → 执行 scripts/nutrition_calculator.py（支持 --demo）

路由速查表（17 个专项 SOP）：

> 历史变更：原 sop-medical.md 单一文件已拆分为 references/sops/nutrition/sop-medical-diabetes/gout/celiac/hypertension.md 4 个专项文件，按"病种路由"精确加载。

人群选项表（模糊词场景展示）：

场景D-2/3/4：服务流程 / 供应链联动 / 多人共餐

> D-2/3/4 都是"营养定制"的横切场景（话术×供应链×多人），触发词和工作流类似，合并速查：

典型命令：

# D-3 巡店反推（核心场景）
python scripts/nutrition_supply_audit.py --demo
python scripts/nutrition_supply_audit.py --active-sops fitness,infant_child,halal \
    --inventory inv.csv --store-id SH001 --output audit_SH001.csv

# D-4 多人共餐
python scripts/multi_guest_solver.py --demo
python scripts/multi_guest_solver.py --guests "fitness,elderly,infant_child,normal" --verbose

禁止（横切红线）：

• ❌ D-2 只加载话术不加载人群 SOP（禁忌/替代错误）
• ❌ D-3 巡店发现 A 级零库存仍继续出餐（食安红线）
• ❌ D-4 跳过决策树直接合并出餐（过敏/清真/佛教素=生死红线）
• ❌ 服务员承诺"吃了能减肥/治病"等疗效（虚假宣传红线）

完整内容：见上表对应文件 + scripts/nutrition_supply_audit.py --help / multi_guest_solver.py --help

场景D-5：营养定制 · 季节菜单（时令节气）

> 触发词：季节菜单 / 时令 / 节气 / 立春 / 春分 / 立夏 / 夏至 / 三伏 / 立秋 / 秋分 / 立冬 / 冬至 / 三九 / 冬补 / 夏清热 / 二十四节气

何时用：
- 节气日前 7-14 天：总部研发规划当季菜单
- 节气日 + 后 7-15 天：门店出餐 + 营销话术
- 季节性原料采购：督导联动供应链
- 季节性禁忌排查：巡店扣分预警

架构（二维叠加）：

  季节（时间轴）：seasonal-custom.md + sop-master.md#{节气代码}  ← 决定主旋律（食材/调味/烹饪）
  人群（空间轴）：sops/nutrition/sop-{人群代码}.md                ← 决定禁忌/替代/营养目标
  ─────────────────────────────────────────
  季节版本号 SOP = 节气代码 + 人群代码
  示例：夏至-健身餐 / 三伏-糖尿病餐 / 冬至-孕期餐

加载规则：
- 必加载：references/seasonal-custom.md（主索引 + 24 节气主旋律 + 季节性禁忌）
- 配套加载：节气 SOP references/sops/seasonal/sop-master.md#{节气代码} + 人群 SOP sops/nutrition/sop-{人群代码}.md（按需）
- 季节菜单生成器：scripts/seasonal_menu_generator.py（自动判断当前节气 + 输出主推菜单 + 人群叠加冲突预警）

典型用法：

# Demo（自动判断今天节气）
python scripts/seasonal_menu_generator.py --demo

# 指定日期
python scripts/seasonal_menu_generator.py --date 2026-07-20

# 指定日期 + 人群叠加（输出每道菜对各人群的适配建议）
python scripts/seasonal_menu_generator.py --date 2026-07-20 --groups fitness,medical-diabetes

# 仅看当前节气
python scripts/seasonal_menu_generator.py --date 2026-12-22 --mode jieqi-only

8 大节气 + 2 特殊窗口速查：

冲突优先级（必须遵守）：当季节建议和人群 SOP 冲突时，人群禁忌 > 节气习俗（食品安全 > 养生）
- ❌ 冬至-糖尿病：汤圆（冬至习俗）vs 糖尿病忌高糖 → 弃汤圆，改无糖版
- ❌ 三伏-孕妇：伏羊汤（温阳）vs 孕妇慎羊肉 → 弃伏羊，改清淡版
- ❌ 三九-佛教素：当归羊肉汤（温阳）vs 佛教素全素 → 弃羊肉汤，改山药枸杞粥

禁止：
- ❌ 季节性食材用反季节替代（如冬天用西瓜）——违反养生主旋律
- ❌ 跳过节气 SOP 直接出餐——季节性禁忌可能漏判
- ❌ 跳过人群 SOP 直接推荐节气菜——可能触犯人群禁忌（孕妇/糖尿病/过敏等）
- ❌ 承诺"吃了包治百病"——虚假宣传红线
- ❌ 冬至当天不出饺子 / 三伏当天无伏羊——节气执行不力扣分

完整内容：见 references/seasonal-custom.md + references/sops/seasonal/sop-master.md#{节气} + scripts/seasonal_menu_generator.py --help

场景D-6：营养定制 · 运动场景细分

> 触发词：撸铁 / 举铁 / 力量训练 / 跑步耐力 / 马拉松 / 瑜伽 / 普拉提 / 球类 / 足球 / 篮球 / 羽毛球 / 户外 / 徒步 / 登山 / 越野 / 骑行

何时用：
- 客人说"健身"但未明确运动类型时（必查决策树）
- 客人具体运动场景（撸铁/跑步/瑜伽/球类/户外）需要差异化营养
- 比赛 / 训练日需要时序餐品（训练前/中/后）
- 多日户外活动的自备食材清单

架构（向后兼容）：

  旧版（保留）：sop-fitness.md（综合/不确定时使用，向后兼容）
  新版（细分）：5 大运动场景 SOP
    ├─ sop-strength.md      🏋️ 撸铁增肌（超高蛋白 + 时序餐）
    ├─ sop-endurance.md     🏃 跑步耐力（高碳水 + 训练中补给）
    ├─ sop-yoga.md          🧘 瑜伽柔韧（Omega-3 + 抗炎）
    ├─ sop-ball_sport.md    ⚽ 球类爆发（中-高蛋白 + 肌酸前体）
    └─ sop-outdoor.md       🥾 户外徒步（持续补给 + 多日自备）

加载规则：
- 必加载：references/sports-custom.md（主索引 + 5 场景速查表 + 决策树 6 步 + 时序餐品 + 营养公式）
- 配套加载：对应运动 SOP（5 选 1）+ 季节/人群 SOP（按需叠加）
- 禁止默认推 sop-strength.md（客人可能不是撸铁）

5 大场景核心差异速查：

禁止：
- ❌ 客人说"健身"就默认推撸铁餐（可能客人是瑜伽/跑步，营养需求差异 50%+）
- ❌ 跳过决策树直接推荐（推断错误 = 餐品偏差）
- ❌ 用旧 fitness SOP 应付 5 大场景（单一 450kcal 健身餐无法满足 700kcal 跑步耐力需求）
- ❌ 训练前 1h 推荐高脂餐（影响训练）
- ❌ 长距离训练（>60min）只供白水（电解质失衡）

完整内容：见 references/sports-custom.md + references/sops/sports/sop-{运动}.md

场景E：成本与经营计算

触发词：成本计算、盈亏平衡、翻台率、人效、食材成本率、投资回收期

工具：scripts/store_management_calculator.py

使用方式：python scripts/store_management_calculator.py → 命令行交互菜单

计算功能：盈亏平衡 | 翻台率 | 人效（基准≥200元/人）| 食材成本率（黄线35%/红线38%）| 利润率预测 | 投资回收期（基准≤18个月）

场景F：报表自动生成

触发词：日报、周报、月报、数据看板生成

工具：scripts/report_auto_generator.py

输入：CSV/Excel日流水数据（日期/门店编码/营业额/桌位数/客流量）

输出：Excel报表 + 图表PNG + 邮件发送

功能：数据读取 | 数据校验（负营业额/客单价异常/缺失检测）| 日报生成 | 周报生成 | 月报生成 | 图表生成 | 邮件发送 | 日志记录

场景G：设备补偿查询

触发词：空气炸锅、Sous Vide、煮面炉、蒸烤箱、烤鸡炉、烧烤架、微波炉、保温台、电烤盘、Combi Steamer、电磁炉（12 种）

规则：按需加载对应的单个补偿文件，禁止加载全部 12 个。完整列表见 references/equipment-compensation.md（含所有 12 个文件路径 + 通用补偿参数）。

高频 4 个：

场景H：菜系参数查询

触发词：川菜、粤菜、鲁菜、淮扬、湘菜、闽菜、浙菜、徽菜、日料、韩料、泰式、越南、印式、印尼马来、西餐、清真菜、港式、缅菜、希腊、土耳其、巴西烤肉、墨西哥、意大利地方、葡萄牙、西班牙、新加坡、老挝柬埔寨、马来西亚、中东（28 个菜系）

规则：按需加载单个菜系文件，禁止加载全部 28 个。完整列表见 references/cuisines/README.md。

高频 4 个：

场景I：运营管理扩展需求

> 本 Skill 内部有 13 个运营管理子模块（供应链/HR/数字/品牌/财务/工程/加盟/法务/数据/创新/跨域/战略/专项）。先看模块的 README.md 索引，再按需加载具体文件。 触发词见 SKILL.md 顶部 description。

assets 模板库

按需加载对应的模板文件（不要一次性全部加载）：

使用方式：新建配方时先判断业态 → 复制对应模板 → 填充内容。流程图模板可复制 PlantUML 源码到 plantuml.com/plantuml 或 IDE 渲染。

scripts 工具集

> 完整使用指南见 scripts/README.md

禁忌与注意事项

配方执行红线

1. 配方数据来源唯一：只有总部有权限新建/修改配方，门店无权自行调整
2. 效期数据强制填写：短效期产品不填效期则无法进入制作流程
3. 油炸油不重复滥用：新油:旧油比例≥1:2，超过使用次数上限自动锁定
4. 生食/刺身强制冷链：解冻后禁止再冷冻，违者按食安红线处理
5. 过敏原信息一致性：主料/辅料中含过敏原的，必须体现在成品过敏原标签中

Agent 元规则（自检/扩展/SOP压缩/术语）

> 以下内容是给 Hermes Agent 看的运行规则，不是给门店/督导/店长看的内容。

• Markdown 表格自检：表格数据行不能以两个竖线开头（会多出空列）。自检命令（在仓库根目录执行） grep -rn '三个连续竖线' SKILL.md references/ assets/ scripts/ → 必须为 0
• 扩展请求接收："继续扩展X"类请求时，先给 2-4 个方向选项 + 推荐排序，等用户确认后再动手（用户偏好，详见对话模板）
• SOP 简化："文件太大/简化"类请求时，给 3 档方案（保守/中等/激进），标推荐档
• 核心术语：BOM / 出成率 / 效期 / 中心温度 / CCP

完整规则 + 对话模板 + 压缩playbook：见 references/agent-meta-rules.md

扩展架构说明（二维叠加 + 嵌套子模块）

本 Skill 在 v2.4-v2.5 扩展中沉淀出 二维叠加 + 嵌套子模块 架构：

• 维度 A（时间/活动/场景轴）：季节、运动
• 维度 B（人群/禁忌/客群轴）：17 类营养定制人群
• 组合版本号 = 维度A代码 + 维度B代码（不写 N×M 组合文件，只加载 2 个独立 SOP）
• 冲突优先级：食安红线 > 人群禁忌 > 习俗/养生 > 营销话术
• 嵌套子目录：sops/{nutrition,operations,seasonal,sports}/ 共 4 个子模块

完整架构说明、反模式警告、未来扩展工作流：见 references/2d-overlay-architecture.md
未来扩展 TODO 池（占位记录，不主动实现）：区域（华东/华南/口味差异）/ 餐次（早/午/下午茶/晚/夜宵）/ 渠道（堂食/外卖/团餐/预制菜）/ 设备 × 季节叠加 / 会员体系。

Agent 协作偏好（v2.6 沉淀）

完整规则 + 对话模板 + 压缩playbook：见 references/agent-meta-rules.md