Skip to content
Back to search

mcd-advisor

SkillWorks with Claude CodeGitHub

麦麦参谋。用户说出想吃的麦当劳(具体到餐品、规格、数量),用麦当劳官方核价找出「同一顿饭」更合适的买法(单点 / 套餐 / 随心配 1+1 / 门店券),并解释菜单上的会员条件价。触发:「这些怎么点更划算」「麦辣鸡腿堡+中薯+中可乐怎么买最省」「菜单写28为什么要57」「同样的东西套餐和单点哪个便宜」。不触发:下单、外送、热量营养、推荐吃什么、积分抽奖。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wenboxia--mcd-advisor/badge.svg)](/listings/wenboxia--mcd-advisor)

HTML

<a href="/listings/wenboxia--mcd-advisor"><img src="/api/listings/wenboxia--mcd-advisor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 47 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: mcd-advisor
  3. description: 麦麦参谋。用户说出想吃的麦当劳(具体到餐品、规格、数量),用麦当劳官方核价找出「同一顿饭」更合适的买法(单点 / 套餐 / 随心配 1+1 / 门店券),并解释菜单上的会员条件价。触发:「这些怎么点更划算」「麦辣鸡腿堡+中薯+中可乐怎么买最省」「菜单写28为什么要57」「同样的东西套餐和单点哪个便宜」。不触发:下单、外送、热量营养、推荐吃什么、积分抽奖。
  4. ---
  5. # 麦麦参谋 · 同一顿,换个买法
  6. 你帮用户回答一个问题:**想吃的东西一样不变,这一顿怎么买更合适。**
  7. 所有比较、核价、排序都由脚本 `bin/mcd-advisor.mjs` 完成;你只负责问清楚要吃什么、运行脚本、把结果讲清楚。
  8. ## 硬规则(必须遵守)
  9. 1. **价格只能来自脚本输出**(JSON 里的 `quote.price`,单位是分,除以 100 是元)。不许自己算价、估价、凑整。
  10. 2. **只通过脚本访问麦当劳。** 即使宿主里也接了麦当劳 MCP,也不要直接调用它的工具;尤其不能调用 `create-order`、`auto-bind-coupons`、`draw-lottery`、`mall-create-order`。
  11. 3. **不下单、不领券、不推荐买会员卡。** 用户要领券时,只告诉他在终端运行带 `--claim` 的命令(脚本会说明「会领取全部可领券」并要求亲手输入 y)。
  12. 4. **不改用户想吃的东西。** 不推荐换主堡、不建议加购。没有更合适的买法就说「保持原来的点法」。
  13. 5. 规格没说清(比如「可乐」没说大小)时,脚本默认按中份并会注明;需要别的规格就让用户说清再跑。
  14. ## 流程
  15. **S1 问清楚三件事**(缺什么问什么,一次问完)
  16. - 吃什么:餐品、规格、数量(例:麦辣鸡腿堡、中薯、中可乐 ×2);也可以直接说套餐名(例:麦辣鸡腿汉堡三件套),脚本会按默认搭配拆开比较
  17. - 在哪:城市 + 地标(例:上海市 人民广场),或门店编号;都没有就用 App 收藏门店
  18. - 到店自取(本工具只支持到店)
  19. 用户说得模糊(「想吃鸡腿堡配可乐」)时,先复述成具体清单让用户确认一次,再运行。
  20. **S2 运行脚本**(在本 Skill 目录下)
  21. ```bash
  22. node bin/mcd-advisor.mjs "麦辣鸡腿堡 中薯 中可乐" --city 上海市 --near 人民广场 --json
  23. ```
  24. - 退出码 `0`:有结论(看 `recommended`;若 `noPlan` 存在,说明这家店买不到「一模一样」的这一顿,原样转告原因)。
  25. - 退出码 `2`:需要用户澄清(看 `needsClarification`:有 `options` 就原样给用户选,`notFound` 就请用户换个具体说法),再重跑。
  26. - 退出码 `3`:这次没拿到任何官方核价(看 `unknown[].reason`),告诉用户这次不能给建议,换个时间或门店;**不要套用 S3 模板**。
  27. - 退出码 `1`:出错,按 `references/troubleshooting.md` 处理。
  28. **S3 讲结果**(按下面的模板,3–6 行,不要展开所有方案)
  29. ```
  30. ✅ 建议:{recommended.lines 的 name,含数量} ¥{recommended.quote.price/100}(官方核价)
  31. {saving>0 时:比分开点(¥{baseline.quote.price/100})少付 ¥{saving/100};keepOriginal 时:保持原来的点法就好}
  32. ⚠️ {notices:菜单显示 ¥{menuPrice/100} 的「{name}」要随单加购会员卡;只有 plain.status 为 verified 时写「不加卡 ¥{plain.price/100}」,只有 withCard.status 为 verified 时写「加卡 ¥{withCard.price/100}(含卡费)」;有 extras 时写「多出 {extras}」}
  33. 🟡 {pending:可领券「{title}」还没领,领了才能核价;领取会一次领取全部 {claimableCount} 张}
  34. ```
  35. 最后附一句:价格只代表这家店此刻的官方报价,下单时以 App 为准。用户想看依据时,再给出账单(门店、时间、每行商品、核价编号 `quote.traceId`)。
  36. ## 需要时再读
  37. - 价格状态、「同一顿」的判定、券和会员价的规则:`references/rules.md`
  38. - 报错和异常怎么处理:`references/troubleshooting.md`
  39. - 用到哪些麦当劳 MCP 工具、为什么:`MCP_INTEGRATION.md`
README.md · README · 189 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/images/banner.png?v=2" alt="麦麦参谋 · 同一顿,换个买法" width="880">
  3. </p>
  4. <p align="center">
  5. <a href="https://wenboxia.github.io/mcd-advisor/"><strong>🍔 在线体验</strong></a> &middot;
  6. <a href="#先看效果"><strong>先看效果</strong></a> &middot;
  7. <a href="#三种用法"><strong>三种用法</strong></a> &middot;
  8. <a href="#它怎么工作"><strong>怎么工作</strong></a> &middot;
  9. <a href="README.en.md"><strong>English</strong></a>
  10. </p>
  11. <p align="center">
  12. <a href="https://wenboxia.github.io/mcd-advisor/"><img src="https://img.shields.io/badge/%E5%9C%A8%E7%BA%BF%E4%BD%93%E9%AA%8C-%E4%B8%8D%E7%94%A8%E8%A3%85%E3%80%81%E4%B8%8D%E7%94%A8%20Token-FFC72C?style=for-the-badge" alt="在线体验:不用装、不用 Token"></a>
  13. <a href="#三种用法"><img src="https://img.shields.io/badge/Skill%20%E5%8F%AF%E8%A3%85%E8%BF%9B-WorkBuddy%20%C2%B7%20Claude%20Code%20%C2%B7%20Codex-27251F?style=for-the-badge" alt="Skill 可装进 WorkBuddy · Claude Code · Codex"></a>
  14. </p>
  15. <p align="center">
  16. <img src="https://img.shields.io/badge/%E4%BB%B7%E6%A0%BC%E6%9D%A5%E6%BA%90-%E9%BA%A6%E5%BD%93%E5%8A%B3%E5%AE%98%E6%96%B9%E6%A0%B8%E4%BB%B7-DA291C" alt="价格来源:麦当劳官方核价">
  17. <a href="tests/advisor.test.mjs"><img src="https://img.shields.io/badge/%E7%A6%BB%E7%BA%BF%E6%B5%8B%E8%AF%95-27%20%E6%9D%A1%E9%80%9A%E8%BF%87-2E7D32" alt="离线测试 27 条通过"></a>
  18. <img src="https://img.shields.io/badge/%E4%BE%9D%E8%B5%96-0-FFC72C" alt="零依赖">
  19. <img src="https://img.shields.io/badge/node-%E2%89%A518-3C873A" alt="Node ≥18">
  20. <a href="MCP_INTEGRATION.md"><img src="https://img.shields.io/badge/%E9%BA%A6%E5%BD%93%E5%8A%B3%20MCP-8%20%2F%2035%20%E4%B8%AA%E5%B7%A5%E5%85%B7-27251F" alt="麦当劳 MCP:8/35 个工具"></a>
  21. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
  22. </p>
  23. # 麦麦参谋 · 同一顿,换个买法
  24. **菜单显示 ¥28,为什么这次核价是 ¥57?**
  25. 你想吃的东西(餐品、规格、数量)**一样都不变**,麦麦参谋用**麦当劳官方核价**帮你核对这一顿怎么买更合适:分开点、套餐、随心配 1+1、门店券,挑出一个,并附上一张能核对的账单。省得下就告诉你怎么省,省不下就直说。
  26. 👉 **[打开在线体验](https://wenboxia.github.io/mcd-advisor/)**:点选想吃的,马上看到建议和账单。页面上 249 个组合的价格,都是在真实门店由麦当劳官方核价接口逐个返回的,不是估算。
  27. <table>
  28. <tr><td width="64"><b>场&#8288;景</b></td><td>点麦当劳之前,想知道「同样这些东西」怎么买更合适</td></tr>
  29. <tr><td width="64"><b>输&#8288;入</b></td><td>想吃什么(例:麦辣鸡腿堡 中薯 中可乐)+ 在哪(城市 + 地标,或 App 收藏门店)</td></tr>
  30. <tr><td width="64"><b>输&#8288;出</b></td><td>一个建议 + 少付多少 + 会员条件价的解释 + 可领券提醒 + 一张账单(门店、时间、逐行小计、核价编号)</td></tr>
  31. <tr><td width="64"><b>不&#8288;做</b></td><td>不下单、不替你换主食、不劝你多买、不推荐买会员卡、不承诺「全场最省」</td></tr>
  32. </table>
  33. ## 先看效果
  34. <p align="center">
  35. <img src="docs/images/cases.png?v=2" alt="三个真实案例:随心配省 ¥13.1;菜单 ¥28 的四件套不加卡要 ¥57;只要一个汉堡时保持原单" width="880">
  36. </p>
  37. <p align="center">
  38. <a href="https://wenboxia.github.io/mcd-advisor/?m=%E9%BA%A6%E8%BE%A3%E9%B8%A1%E8%85%BF%E5%A0%A1&s=%E4%B8%AD%E8%96%AF&d=%E4%B8%AD%E5%8F%AF%E4%B9%90&n=1"><img src="docs/images/demo-page.png?v=1" alt="在线体验页:选麦辣鸡腿堡 + 中薯 + 中可乐,建议三件套 ¥33.5,比分开点少付 ¥12.5,并解释 ¥28 的四件套和可领券" width="880"></a>
  39. <br><sub>在线体验页截图:每个价格都是麦当劳官方核价(上海黄浦华旭国际大厦餐厅,2026-10-22 午餐时段)。<a href="https://wenboxia.github.io/mcd-advisor/">点图打开,自己选一顿试试</a>。</sub>
  40. </p>
  41. 这三个案例覆盖了三种结果:
  42. | 你想吃 | 麦麦参谋的回答 | 依据 |
  43. |---|---|---|
  44. | 麦香鸡 + 中可乐 | 点**随心配 1+1**,¥13.9(分开点 ¥27.0) | 两样一样不少,官方核价 |
  45. | 麦辣鸡腿堡 + 中薯 + 中可乐 | 点**三件套**,¥33.5(分开点 ¥46.0);菜单上 ¥28 的四件套要随单加购麦金卡,不加卡 ¥57.0,加卡 ¥37.9(含 ¥9.9 卡费),而且会多一份麦乐鸡 | 每种买法都单独核价 |
  46. | 只要一个麦辣鸡腿堡 | **保持原单**,¥22.5 | 套餐会多出薯条可乐,不算同一顿 |
  47. **几个人一起点**:手机传一圈、大家把要的写进同一句话就行,它会算出合在一起怎么买更划算。比如三个人各要一个汉堡 + 中薯 + 中可乐:
  48. ```bash
  49. node bin/mcd-advisor.mjs "巨无霸 板烧鸡腿堡 麦辣鸡腿堡 3个中薯 3杯中可乐" --city 上海市 --near 人民广场
  50. ```
  51. 建议点**巨无霸、板烧鸡腿堡、麦辣鸡腿汉堡三份三件套**,共 ¥104.5,分开点要 ¥142.0,少付 ¥37.5,同样有离线回放记录。它只回答「合在一起怎么买」,不做 AA 分账,谁付多少你们自己转就好。
  52. ## 三种用法
  53. ### ① 在线体验:不用装、不用 Token
  54. 打开 **[https://wenboxia.github.io/mcd-advisor/](https://wenboxia.github.io/mcd-advisor/)**,选主食、小食、饮品和份数,右边就是麦麦参谋的回答:建议买法、少付多少、会员条件价的解释、可领券提醒,还有一张能展开核对的账单。
  55. 页面数据是在一家上海门店的午餐时段用官方核价逐个录下的快照;想用你自己的门店实时核价,用下面两种方式。
  56. ### ② 装进 WorkBuddy 等 AI 助手,一句话问(推荐)
  57. 本仓库就是一个标准的 Agent Skill([`SKILL.md`](SKILL.md)),可以装进 **WorkBuddy**、Claude Code、Codex 等支持 Skill 的 AI 助手。装好后直接说「麦辣鸡腿堡加中薯中可乐,人民广场附近怎么买更划算」就行。
  58. | AI 助手 | 怎么装 |
  59. |---|---|
  60. | **WorkBuddy** | 下载本仓库,在【专家 · 技能 · 连接器】里导入整个文件夹;或者用下面的命令放进 WorkBuddy 的技能目录,再重启 WorkBuddy |
  61. | Claude Code | `git clone https://github.com/wenboxia/mcd-advisor.git ~/.claude/skills/mcd-advisor` |
  62. | Codex 等 | 把仓库放进该工具的 Skill 目录 |
  63. ```bash
  64. git clone https://github.com/wenboxia/mcd-advisor.git ~/.workbuddy/skills/mcd-advisor
  65. ```
  66. Windows 上 WorkBuddy 的技能目录是 `%USERPROFILE%\.workbuddy\skills\`。
  67. 第一次用之前,需要你自己的麦当劳 MCP Token(在 [open.mcd.cn/mcp](https://open.mcd.cn/mcp) 用手机号登录 → 控制台 → 激活):
  68. - **WorkBuddy**:已经在【连接器】里配好麦当劳 MCP 的,不用再填,脚本会直接读本机的这份配置(只读不改);
  69. - **其他工具**:写进**仓库之外**的 `~/.config/mcd-advisor/.env`(格式见 [`.env.example`](.env.example))。
  70. Token 只留在你自己的电脑上,不要发给任何人。
  71. 不管装在哪个 AI 助手里,它都只负责问清楚要吃什么、运行脚本、把结果讲清楚;核价由脚本直连麦当劳官方 MCP 完成,**价格一律来自官方核价**。
  72. Skill 按**三层渐进式披露**组织:
  73. - frontmatter 里的说明负责触发;
  74. - `SKILL.md` 正文约 40 行,只放硬规则和流程;
  75. - `references/` 里的规则和排错文档在需要时才读。
  76. 没有支持 Skill 的工具?在配置里加上 `DEEPSEEK_API_KEY`,用一句大白话问也行(换 Kimi、GLM 时再设 `LLM_BASE_URL` 和 `DEEPSEEK_MODEL`):
  77. ```bash
  78. node bin/mcd-advisor.mjs --ask "中午想在上海人民广场吃个麦辣鸡腿堡,配中薯和可乐"
  79. ```
  80. ### ③ 命令行(开发者)
  81. 零第三方依赖,Node.js 18+。先离线跑一下,不需要 Token:
  82. ```bash
  83. git clone https://github.com/wenboxia/mcd-advisor.git && cd mcd-advisor && npm run demo
  84. ```
  85. 命令行输出示例:
  86. <p align="center">
  87. <img src="docs/images/terminal.png?v=2" alt="命令行输出示例:建议三件套 ¥33.5,比分开点少付 ¥12.5,并解释 ¥28 的四件套和可领券" width="720">
  88. </p>
  89. 配好 Token 后实时核价:
  90. ```bash
  91. node bin/mcd-advisor.mjs "麦辣鸡腿堡 中薯 中可乐" --city 上海市 --near 人民广场
  92. node bin/mcd-advisor.mjs "两个麦香鸡 两杯中可乐" --store 1450713 --json
  93. node bin/mcd-advisor.mjs "麦辣鸡腿汉堡三件套" --city 上海市 --near 人民广场 # 报套餐名也行,按默认搭配拆开比较
  94. ```
  95. | 选项 | 作用 |
  96. |---|---|
  97. | `--city` `--near` | 按城市 + 地标找最近的门店;都不填就用你在 App 里收藏的门店 |
  98. | `--store` | 直接指定门店编号 |
  99. | `--json` | 输出 JSON,给 Agent 或其他程序用 |
  100. | `--ask` | 用一句大白话提问(需要 DeepSeek 等模型 Key) |
  101. | `--claim` | 领取麦麦省可领券后重新核价。官方接口会**一次领取全部**可领券,所以脚本会先说明,并要你在终端里亲手输入 `y` |
  102. | `--replay <dir>` | 用录好的数据离线运行 |
  103. ## 它怎么工作
  104. <p align="center">
  105. <img src="docs/images/flow.png?v=3" alt="业务流程(泳道图):用户、AI 助手、麦麦参谋引擎、麦当劳官方 MCP 四条泳道;名字不明确先反问,买不到一模一样的直说,只有官方核价成功的方案参与排名" width="880">
  106. </p>
  107. - **同一顿,由代码判定**:每个方案拆开后,食物清单必须和你要的完全一致,多出一份薯条也不行。小杯和中杯算两种东西;「任选 3 份」这样的格子按份数算。买不到一模一样的一顿时会直说(例如某样东西只在会多出别的东西的套餐里卖)。
  108. - **说不清就先问**:名字只有完全对上才直接用,「巨无霸大套餐」「鸡块」这种会先给你选项,不会悄悄换成别的东西。「学生专享」这类有资格限制的商品不会出现在方案里。
  109. - **份数再多也是最优**:按剩余食物做动态规划,4 份、6 份照样能找到估算最省的组合,再交给官方核价。
  110. - **价格只认官方**:菜单价只用来决定哪些方案值得送去核价,最终排序只看 `calculate-price` 的返回。价格分三种状态:✅ 已官方核价、🟡 待核验(券还没领,拿不到券号)、⚪ 无法确认。后两种不参与排名。
  111. - **会员条件价讲清楚**:菜单 `discountType` 是「随单购…」的商品,分别核价「不加卡」和「加卡(含卡费)」,只解释,不推荐买卡。
  112. - **快**:第一次查一家店要拉取全部菜单详情,实测约 7 秒;当天再查会用缓存,实测 1–2 秒。
  113. 用到哪些 MCP 工具、为什么不用另外 27 个、踩过哪些坑,见 [MCP_INTEGRATION.md](MCP_INTEGRATION.md)。
  114. ## 为什么敢让你相信这个结果
  115. - **可复现**:`fixtures/` 里是 2026-10-21 晚真实查询录下的官方原始返回(已核对不含个人信息)。`npm test` 用它离线回放,27 条测试覆盖:
  116. - 换买法、随心配、份数、几个人一起点、保持原单、买不到一模一样;
  117. - 会员条件价、可领券、一单一券、核价失败;
  118. - 多份格子、4 份以上最优、有资格限制的商品、模糊名字先问、套餐名展开;
  119. - 指定门店、工具白名单、名字归一、密钥扫描、复用 WorkBuddy 连接器 Token。
  120. - **可核对**:每次建议都附核价编号(官方 `traceId`)和逐行小计。
  121. - **不夸大**:没有更合适的买法就说「保持原来的点法」。没领的券只标「待核验」,不拿来排名。
  122. ## 安全与隐私
  123. - **默认只读**:工具调用走白名单。下单、取消、抽奖、积分兑换这些工具,即使被要求也发不出去(有测试覆盖)。
  124. - **唯一的写操作是领券**:必须加 `--claim`,并在终端里亲手输入 `y`。非交互环境会直接拒绝。
  125. - **密钥不出本机**:Token 和模型 Key 只放在 `~/.config/mcd-advisor/.env`(或你在 WorkBuddy 里配好的麦当劳连接器,脚本只读不改),仓库里只有占位符。`npm run check-secrets` 会扫描所有要提交的文件,并逐字比对本机的真实密钥值;`npm test` 也会跑它。想在每次提交前自动检查,运行一次 `git config core.hooksPath .githooks`,之后 pre-commit 会扫描暂存区里实际要提交的内容。
  126. ## 已知限制
  127. - 只支持到店自取(含堂食、外带取餐柜),暂不支持外送和得来速。
  128. - 可领券在领取前拿不到券号,无法提前核价。官方领券接口一次领取全部,不能只领一张。
  129. - 套餐里的口味特调(去酸黄瓜、少冰等)还没参与比较,默认按标准做法核价。
  130. - 价格只代表那家店、那个时刻的官方报价,下单时以 App 为准。
  131. ## 项目信息
  132. - 麦当劳程序员创意开发大赛参赛作品,**非麦当劳官方产品**。项目里没有使用麦当劳的商标图形。
  133. - 报名 Issue:[M-China/mcd-developer-innovation-challenge#983](https://github.com/M-China/mcd-developer-innovation-challenge/issues/983)(官方已确认成功参赛)
  134. - 参赛声明:[CONTEST_DECLARATION.md](CONTEST_DECLARATION.md) · MCP 接入说明:[MCP_INTEGRATION.md](MCP_INTEGRATION.md) · 配置示例:[mcp-config.example.json](mcp-config.example.json)
  135. - 许可证:[MIT](LICENSE)
  136. 如果它帮你看清了某一顿的价格,欢迎点个 ⭐。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.