無料GitHub で公開

mcd-advisor

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

不触发：下单、外送、热量营养、推荐吃什么、积分抽奖。

日本語の概要は準備中です。原文の説明を表示しています。

wenboxia/mcd-advisorスター 96(GitHub 96 + cccskills 0)

連携ツールAWS

実行スコア未検証

インストール方法を見る

含まれるファイル（189）

SKILL.md4.1 KB
.env.example372 B
.githooks/pre-commit114 B
.gitignore73 B
bin/mcd-advisor.mjs4.4 KB
CONTEST_DECLARATION.md1.5 KB
docs/data/demo.js169.9 KB
docs/data/demo.json169.8 KB
docs/design/banner.html4.8 KB
docs/design/cases.html4.2 KB
docs/design/flow.html9.7 KB
docs/design/terminal.html2.8 KB
docs/images/banner.png434.9 KB
docs/images/cases.png423.7 KB
docs/images/demo-page.png541.0 KB
docs/images/flow.png296.7 KB
docs/images/terminal.png432.3 KB
docs/index.html25.6 KB
fixtures/shanghai-1450713/available-coupons__bf21a9e8fbc5.json738 B
fixtures/shanghai-1450713/calculate-price__14a0923dfcb7.json4.0 KB
fixtures/shanghai-1450713/calculate-price__1a140061a234.json5.2 KB
fixtures/shanghai-1450713/calculate-price__3aa9cc5253f3.json4.0 KB
fixtures/shanghai-1450713/calculate-price__3de8828633f4.json5.2 KB
fixtures/shanghai-1450713/calculate-price__41f7981937f9.json3.9 KB
fixtures/shanghai-1450713/calculate-price__4810de015efd.json4.0 KB
fixtures/shanghai-1450713/calculate-price__4dbe543010fd.json5.2 KB
fixtures/shanghai-1450713/calculate-price__531342d9a77d.json4.4 KB
fixtures/shanghai-1450713/calculate-price__5d5ffd4ad893.json3.9 KB
fixtures/shanghai-1450713/calculate-price__62bef529b050.json3.9 KB
fixtures/shanghai-1450713/calculate-price__761faeaa741b.json4.6 KB
fixtures/shanghai-1450713/calculate-price__7878b2284b19.json3.9 KB
fixtures/shanghai-1450713/calculate-price__7c97caadc9c2.json4.4 KB
fixtures/shanghai-1450713/calculate-price__867ee79d251c.json4.4 KB
fixtures/shanghai-1450713/calculate-price__9143299dd134.json3.9 KB
fixtures/shanghai-1450713/calculate-price__a8517e560f6a.json5.2 KB
fixtures/shanghai-1450713/calculate-price__aab58f779b5d.json3.9 KB
fixtures/shanghai-1450713/calculate-price__cb0f185a7675.json4.1 KB
fixtures/shanghai-1450713/calculate-price__ccfcbe0e731f.json4.3 KB
fixtures/shanghai-1450713/calculate-price__d43f785420b3.json3.6 KB
fixtures/shanghai-1450713/calculate-price__f1eb73fee8be.json4.4 KB
fixtures/shanghai-1450713/now-time-info__bf21a9e8fbc5.json1.4 KB
fixtures/shanghai-1450713/query-meal-detail__05f02d00e16e.json5.5 KB
fixtures/shanghai-1450713/query-meal-detail__066755480db0.json4.1 KB
fixtures/shanghai-1450713/query-meal-detail__069687fc4e4a.json22.0 KB
fixtures/shanghai-1450713/query-meal-detail__0879f4ca4f9a.json4.7 KB
fixtures/shanghai-1450713/query-meal-detail__08d6520d434e.json4.8 KB
fixtures/shanghai-1450713/query-meal-detail__0a01ff6ecd88.json13.2 KB
fixtures/shanghai-1450713/query-meal-detail__0f9a8320d75e.json4.3 KB
fixtures/shanghai-1450713/query-meal-detail__1225e619bffa.json4.6 KB
fixtures/shanghai-1450713/query-meal-detail__148f216a1511.json24.2 KB
fixtures/shanghai-1450713/query-meal-detail__153f8799cefc.json6.3 KB
fixtures/shanghai-1450713/query-meal-detail__17713e239007.json21.7 KB
fixtures/shanghai-1450713/query-meal-detail__18a8e1a14a16.json21.5 KB
fixtures/shanghai-1450713/query-meal-detail__199a4421d76a.json25.1 KB
fixtures/shanghai-1450713/query-meal-detail__1a8b815b7ede.json23.7 KB
fixtures/shanghai-1450713/query-meal-detail__1c6aa3a03889.json4.7 KB
fixtures/shanghai-1450713/query-meal-detail__1cce72c1c20a.json22.0 KB
fixtures/shanghai-1450713/query-meal-detail__1e3793d689fa.json24.2 KB
fixtures/shanghai-1450713/query-meal-detail__23333f08101f.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__235741d23ff6.json21.6 KB
fixtures/shanghai-1450713/query-meal-detail__24f2435caed8.json22.2 KB
fixtures/shanghai-1450713/query-meal-detail__2706078aa1b0.json22.1 KB
fixtures/shanghai-1450713/query-meal-detail__2916bf96cf24.json21.2 KB
fixtures/shanghai-1450713/query-meal-detail__29e285ebfca3.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__2a0ab92a1563.json5.1 KB
fixtures/shanghai-1450713/query-meal-detail__2f817efc2e07.json4.4 KB
fixtures/shanghai-1450713/query-meal-detail__300f9b422aa6.json9.6 KB
fixtures/shanghai-1450713/query-meal-detail__31408d21d9af.json3.8 KB
fixtures/shanghai-1450713/query-meal-detail__335fad2df1a4.json13.2 KB
fixtures/shanghai-1450713/query-meal-detail__35381f0a1f7e.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__360d00ab5a4d.json4.5 KB
fixtures/shanghai-1450713/query-meal-detail__36966f7a6bed.json4.5 KB
fixtures/shanghai-1450713/query-meal-detail__369df65dfe12.json21.2 KB
fixtures/shanghai-1450713/query-meal-detail__371ce36de9cb.json3.8 KB
fixtures/shanghai-1450713/query-meal-detail__380de192c1ff.json3.8 KB
fixtures/shanghai-1450713/query-meal-detail__38d167729325.json8.5 KB
fixtures/shanghai-1450713/query-meal-detail__39bb373ab4ad.json5.1 KB
fixtures/shanghai-1450713/query-meal-detail__3a6c0bd3c62c.json21.6 KB
fixtures/shanghai-1450713/query-meal-detail__41e583a9e1e4.json6.0 KB
fixtures/shanghai-1450713/query-meal-detail__422095ff1de5.json21.6 KB
fixtures/shanghai-1450713/query-meal-detail__4474f66a6de4.json7.9 KB
fixtures/shanghai-1450713/query-meal-detail__48ce52c5bafc.json5.3 KB
fixtures/shanghai-1450713/query-meal-detail__4a9925a3ca2d.json24.3 KB
fixtures/shanghai-1450713/query-meal-detail__4b14f60c249d.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__4bc44e272827.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__4cb1d48c87a2.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__4ed258f24007.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__4efc2fd96074.json4.3 KB
fixtures/shanghai-1450713/query-meal-detail__560993efc2da.json4.5 KB
fixtures/shanghai-1450713/query-meal-detail__58cc90a1a3e2.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__598ebfa35fbd.json24.3 KB
fixtures/shanghai-1450713/query-meal-detail__5dd46d1644aa.json4.3 KB
fixtures/shanghai-1450713/query-meal-detail__64b739c2524b.json4.5 KB
fixtures/shanghai-1450713/query-meal-detail__680fe9627594.json4.1 KB
fixtures/shanghai-1450713/query-meal-detail__69a9f94fcb29.json4.3 KB
fixtures/shanghai-1450713/query-meal-detail__6ad11e360437.json21.7 KB
fixtures/shanghai-1450713/query-meal-detail__6c0ccc6c8279.json4.5 KB
fixtures/shanghai-1450713/query-meal-detail__6e6f27c131ff.json22.6 KB
fixtures/shanghai-1450713/query-meal-detail__6e754ac5fca4.json4.4 KB
fixtures/shanghai-1450713/query-meal-detail__6f58ce7eb442.json4.3 KB
fixtures/shanghai-1450713/query-meal-detail__771e30f701ca.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__78729bca5296.json4.4 KB
fixtures/shanghai-1450713/query-meal-detail__7b35ca141567.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__7bb8fb3f882d.json4.2 KB
fixtures/shanghai-1450713/query-meal-detail__7dc49282f5c6.json24.8 KB
fixtures/shanghai-1450713/query-meal-detail__8065d72b75bd.json23.7 KB
fixtures/shanghai-1450713/query-meal-detail__81a35e9a6152.json3.8 KB
fixtures/shanghai-1450713/query-meal-detail__8890dc7ca82d.json15.0 KB
fixtures/shanghai-1450713/query-meal-detail__889d4eb9f1e2.json23.6 KB
fixtures/shanghai-1450713/query-meal-detail__8a2229c8603c.json5.1 KB
fixtures/shanghai-1450713/query-meal-detail__8eb583f5c658.json4.2 KB
fixtures/shanghai-1450713/query-meal-detail__8f4a6f6e0026.json5.7 KB
fixtures/shanghai-1450713/query-meal-detail__90280a21a0b0.json7.2 KB
fixtures/shanghai-1450713/query-meal-detail__919d56d77a61.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__92eb7340c056.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__9a91e0e88832.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__9aef8d164e4f.json22.1 KB
fixtures/shanghai-1450713/query-meal-detail__9b251098520b.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__9dd897dfd700.json22.1 KB
fixtures/shanghai-1450713/query-meal-detail__a098ba71f994.json4.4 KB
fixtures/shanghai-1450713/query-meal-detail__a14f3a6812d0.json4.8 KB
fixtures/shanghai-1450713/query-meal-detail__a3e34575f865.json4.8 KB
fixtures/shanghai-1450713/query-meal-detail__a42612899cbf.json8.6 KB
fixtures/shanghai-1450713/query-meal-detail__a54357cb64bb.json8.5 KB
fixtures/shanghai-1450713/query-meal-detail__a5e96856f3df.json22.2 KB
fixtures/shanghai-1450713/query-meal-detail__a5ebcea63bec.json4.7 KB
fixtures/shanghai-1450713/query-meal-detail__a809c355233d.json26.7 KB
fixtures/shanghai-1450713/query-meal-detail__a80e1380e8d0.json4.2 KB
fixtures/shanghai-1450713/query-meal-detail__a89fe75784f8.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__ab7d067260be.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__ac0359d80c22.json23.7 KB
fixtures/shanghai-1450713/query-meal-detail__ac8831d62a4a.json4.7 KB
fixtures/shanghai-1450713/query-meal-detail__adba09cfaea5.json4.8 KB
fixtures/shanghai-1450713/query-meal-detail__b89e4539b5c8.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__ba5b6c7a3292.json4.3 KB
fixtures/shanghai-1450713/query-meal-detail__ba8bd4a632af.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__bbd575357074.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__bc3ff799ac58.json4.5 KB
fixtures/shanghai-1450713/query-meal-detail__c7703882362f.json4.3 KB
fixtures/shanghai-1450713/query-meal-detail__c796bb0575f1.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__cbe8b35bc395.json28.5 KB
fixtures/shanghai-1450713/query-meal-detail__d0fa9c33f1d7.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__d28e9de026ec.json4.3 KB
fixtures/shanghai-1450713/query-meal-detail__d444aec9dd69.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__d449d98eb811.json24.1 KB
fixtures/shanghai-1450713/query-meal-detail__d471145e5f54.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__d539a38547a6.json21.7 KB
fixtures/shanghai-1450713/query-meal-detail__d6efa0052e7f.json4.8 KB
fixtures/shanghai-1450713/query-meal-detail__d7c7aeb9b448.json19.5 KB
fixtures/shanghai-1450713/query-meal-detail__da5c80cd610d.json24.2 KB
fixtures/shanghai-1450713/query-meal-detail__dc7311000405.json6.4 KB
fixtures/shanghai-1450713/query-meal-detail__dede97631035.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__df2cd15133fa.json9.3 KB
fixtures/shanghai-1450713/query-meal-detail__e6888464f5b8.json26.5 KB
fixtures/shanghai-1450713/query-meal-detail__eb300ef83c41.json23.7 KB
fixtures/shanghai-1450713/query-meal-detail__ef25bdc884c8.json3.8 KB
fixtures/shanghai-1450713/query-meal-detail__f0e7a199a47d.json4.7 KB
fixtures/shanghai-1450713/query-meal-detail__f267b29028d6.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__f3bcb574cf50.json4.5 KB
fixtures/shanghai-1450713/query-meal-detail__f910ccae7b06.json6.9 KB
fixtures/shanghai-1450713/query-meal-detail__f9df8dc9f225.json21.6 KB
fixtures/shanghai-1450713/query-meal-detail__fa837841de26.json3.9 KB
fixtures/shanghai-1450713/query-meal-detail__fbe70dbf512a.json4.2 KB
fixtures/shanghai-1450713/query-meals__fc1f5a4114f5.json38.7 KB
fixtures/shanghai-1450713/query-nearby-stores__7281880be6ad.json4.0 KB
fixtures/shanghai-1450713/query-store-coupons__fc1f5a4114f5.json1.2 KB
LICENSE1.0 KB
MCP_INTEGRATION.md7.7 KB
mcp-config.example.json194 B
package.json693 B
README.en.md6.7 KB
README.md13.3 KB
references/rules.md2.3 KB
references/troubleshooting.md2.1 KB
scripts/build-demo.mjs5.4 KB
scripts/check-secrets.mjs2.8 KB
scripts/record.mjs2.1 KB
scripts/render-images.mjs3.8 KB
src/advisor.mjs9.7 KB
src/catalog.mjs5.3 KB
src/env.mjs2.1 KB
src/format.mjs5.4 KB
src/match.mjs6.0 KB
src/mcp.mjs4.0 KB
src/nl.mjs2.0 KB
src/plan.mjs8.3 KB
src/source.mjs2.4 KB
tests/advisor.test.mjs7.5 KB
tests/engine.test.mjs7.2 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

麦麦参谋 · 同一顿，换个买法

你帮用户回答一个问题：想吃的东西一样不变，这一顿怎么买更合适。 所有比较、核价、排序都由脚本 bin/mcd-advisor.mjs 完成；你只负责问清楚要吃什么、运行脚本、把结果讲清楚。

硬规则（必须遵守）

价格只能来自脚本输出（JSON 里的 quote.price，单位是分，除以 100 是元）。不许自己算价、估价、凑整。
只通过脚本访问麦当劳。 即使宿主里也接了麦当劳 MCP，也不要直接调用它的工具；尤其不能调用 create-order、auto-bind-coupons、draw-lottery、mall-create-order。
不下单、不领券、不推荐买会员卡。 用户要领券时，只告诉他在终端运行带 --claim 的命令（脚本会说明「会领取全部可领券」并要求亲手输入 y）。
不改用户想吃的东西。 不推荐换主堡、不建议加购。没有更合适的买法就说「保持原来的点法」。
规格没说清（比如「可乐」没说大小）时，脚本默认按中份并会注明；需要别的规格就让用户说清再跑。

流程

S1 问清楚三件事（缺什么问什么，一次问完）

吃什么：餐品、规格、数量（例：麦辣鸡腿堡、中薯、中可乐 ×2）；也可以直接说套餐名（例：麦辣鸡腿汉堡三件套），脚本会按默认搭配拆开比较
在哪：城市 + 地标（例：上海市人民广场），或门店编号；都没有就用 App 收藏门店
到店自取（本工具只支持到店）

用户说得模糊（「想吃鸡腿堡配可乐」）时，先复述成具体清单让用户确认一次，再运行。

S2 运行脚本（在本 Skill 目录下）

node bin/mcd-advisor.mjs "麦辣鸡腿堡 中薯 中可乐" --city 上海市 --near 人民广场 --json

退出码 0：有结论（看 recommended；若 noPlan 存在，说明这家店买不到「一模一样」的这一顿，原样转告原因）。
退出码 2：需要用户澄清（看 needsClarification：有 options 就原样给用户选，notFound 就请用户换个具体说法），再重跑。
退出码 3：这次没拿到任何官方核价（看 unknown[].reason），告诉用户这次不能给建议，换个时间或门店；不要套用 S3 模板。
退出码 1：出错，按 references/troubleshooting.md 处理。

S3 讲结果（按下面的模板，3–6 行，不要展开所有方案）

✅ 建议：{recommended.lines 的 name，含数量}  ¥{recommended.quote.price/100}（官方核价）
   {saving>0 时：比分开点（¥{baseline.quote.price/100}）少付 ¥{saving/100}；keepOriginal 时：保持原来的点法就好}
⚠️ {notices：菜单显示 ¥{menuPrice/100} 的「{name}」要随单加购会员卡；只有 plain.status 为 verified 时写「不加卡 ¥{plain.price/100}」，只有 withCard.status 为 verified 时写「加卡 ¥{withCard.price/100}（含卡费）」；有 extras 时写「多出 {extras}」}
🟡 {pending：可领券「{title}」还没领，领了才能核价；领取会一次领取全部 {claimableCount} 张}

最后附一句：价格只代表这家店此刻的官方报价，下单时以 App 为准。用户想看依据时，再给出账单（门店、时间、每行商品、核价编号 quote.traceId）。

需要时再读

价格状态、「同一顿」的判定、券和会员价的规则：references/rules.md
报错和异常怎么处理：references/troubleshooting.md
用到哪些麦当劳 MCP 工具、为什么：MCP_INTEGRATION.md

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

このスキルの問題を報告する

インストール

コマンドで入れる

npx skills add https://github.com/wenboxia/mcd-advisor --skill mcd-advisor

ターミナルに貼り付けて実行します（Node.js が必要です）。Claude Code・Codex など、入れる先のエージェントを選べます。

エージェントに頼む

次の Agent Skill をインストールしてください。
https://github.com/wenboxia/mcd-advisor

まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/mcd-advisor/、Codex なら ~/.agents/skills/mcd-advisor/ に配置してください。

この文章をそのまま Claude Code や Codex に送ると、中身を確認してから入れてくれます。

GitHub でソースを見る

リポジトリ: wenboxia/mcd-advisor
スター: 96
フォーク: 0
カテゴリ: その他
ライセンス: MIT
本文の言語: 中国語
最終更新: 2026年10月22日

スキルはエージェントへの指示とスクリプトの集まりです。cccskills は内容の安全性を保証していません。入れる前に中身を確認してください。