Mcd Order Butler — Development skill for Claude Code

麦麦专属点单管家

一个由**个性化规则驱动**的麦当劳点单管家 —— 记住每个用户的饮食禁忌与口味偏好，分餐次智能推荐，按健康目标给出热量分析与优惠计算，确认后一键下单。

基于[麦当劳中国官方 MCP](https://github.com/M-China/mcd-mcp-server) 构建，是[麦当劳程序员创意开发大赛](https://github.com/M-China/mcd-developer-innovation-challenge)参赛作品。

**核心不是写死某个人的习惯，而是一套可配置、可扩展、面向大众的个性化规则系统。** 不同用户各自设定规则，管家按规则自动决策，并把"因为哪条规则做了什么决策"讲清楚。

---

为什么不是"又一个推荐脚本"

常见做法	本项目的做法
把某个人的忌口写进代码	规则是数据，谁都能改，改完立即生效
规则一多就打架，结果随机	七层优先级仲裁，高层的否决压掉低层的偏好，且冲突被显式记录
AI 拍脑袋推荐，说不清为什么	每条推荐/排除都点名规则与层级，冲突写明"谁的优先级更高"
加一种新规则要改引擎	规则类型是数据描述符，加一条即可，引擎一行不改
让用户先填一堆表单才能用	零配置可用，规则从对话里自动抽取，表单只是可选的进阶工具
只给一个"最优解"	给 3 个符合条件的选项（主食互不重复），用户自己挑

七层优先级

层级	rank	覆盖什么	裁决方式
安全 · 禁忌	100	过敏、宗教戒律（清真/素食）、辣度、硬忌口	一票否决
健康目标	80	热量预算、控盐、控糖、控脂、增肌高蛋白	强约束，超了换搭配
人群差异	60	儿童 / 老人 / 成人 / 孕期	人群禁忌 + 营养加权 + 必备项
餐次菜单	45	早 / 午 / 晚 / 夜宵的品类与份量	不在该餐次菜单即排除
口味偏好	30	喜欢 / 不喜欢 / 收藏 / 换换口味	只影响排序
定制指令	15	去酱、去冰、不要小食、取餐方式	改配置项
优惠 · 性价比	5	预算上限、优先用券、性价比	最后加权

**高层覆盖低层。** 冲突在输出里点名：

巨无霸 —— 含禁用项「牛肉」　⚔ 这条否决压掉了你的偏好：**口味偏好 · 喜欢**（分层优先级 100 > 30）

规则类型目录（26 种）

**安全**：禁用食材/品类 · 过敏原 · 辣度上限 · 宗教戒律 · 单品钠上限 **健康**：热量预算 · 增肌高蛋白 · 控盐 · 控糖 · 控脂 **人群**：人群禁忌 · 营养加权 · 必备项 **餐次**：可售品类 · 份量区间 · 跳过品类 **偏好**：喜欢 · 不喜欢 · 收藏套餐 · 换换口味 **定制**：单品定制 · 订单级偏好 · 不要某品类 **优惠**：单次预算 · 优先用券 · 性价比

新增一种 = 往 `RULE_TYPES` 加一条数据描述符，引擎不动：

{ typeId: 'ext.no-fried', label: '自定义 · 拒绝油炸', tier: 'health',
  kind: 'item', effect: 'veto',
  when: { field: 'searchText', op: 'containsAny', valueKey: 'keywords' },
  reason: '自定义规则拒绝「{hit}」',
  paramsSchema: [{ key: 'keywords', label: '关键词', type: 'tags' }] }

快速开始

**Skill 本体是纯对话的** —— 不需要打开任何页面，也不需要预填规则。下面第 1 种是用它的正常方式；2、3 是可选工具，不是使用前提。

0. 30 秒体验（**不需要 MCP Token**）

node demo.js

零参数、零依赖、不联网、不调任何麦当劳接口。用内置示例菜单跑 4 个场景：新用户点单、减肥控卡、带娃、规则冲突。看完就知道它在做什么。

1. 直接用：说人话就行（推荐，零配置）

把仓库根目录的 `SKILL.md` 放到 WorkBuddy 的 skills 目录，并按 `mcp-config.example.json` 接好 `mcd