ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ไฟล์คำสั่งให้ AI อ่าน
- บัญชีหรือคีย์ ยังยืนยันไม่ได้ (ยังไม่ได้อ่าน README)
- หมวด เขียนโค้ด
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
🍟 麦当劳中国官方 MCP 智能助手技能:把 35 个原子工具编排成 4 条业务流 —— 活动推送 · 联名关注 · 最优惠点餐 · 多人群点聚合账单。算价用 calculate-price 真算,下单必二次确认。|McDonald's China MCP agent skill: campaigns, collab watch, best-value ordering, group bill splitting.สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/skills/junxchan54-maker-mcd-cn-assistant)ใช้คู่กับ
MCP ที่ต่อ AI เข้ากับบริการในงานเดียวกัน
Fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Desktop Commander
MCP server for terminal commands, file operations, and process management
Skill ที่ทำงานคล้ายกัน
หมวดงานเดียวกัน เรียงแบบเดียวกับหน้ารายการ Skill
| ตัวนี้ mcd-cn-assistant | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| ผู้ทำ | junxchan54-maker | morluto | multica-ai | Graphify-Labs | harry0703 |
| จำนวน Skill | 1 | 1 | 1 | 1 | 1 |
| ดาว GitHub | 379 | 465,460 | 233,910 | 149,364 | 144,149 |
| แก้โค้ดล่าสุด | 27 ต.ค. 2569 | 17 พ.ย. 2569 | 20 เม.ย. 2569 | 17 พ.ย. 2569 | 17 พ.ย. 2569 |
| สัญญาอนุญาต | – | MIT | – | Apache-2.0 | MIT |
ชุดคำสั่ง (Skill) 1 ชุดจาก junxchan54-maker ให้ AI อ่านแล้วทำงานตามวิธีนี้ · ไม่ใช่ MCP server
Skill ต่างจาก MCP ยังไง
MCP = มือ
ต่อ AI เข้ากับบริการหรือข้อมูลข้างนอก เช่น อ่าน Notion หรือสร้างใบแจ้งหนี้ ต้องมีโปรแกรมหรือ server ทำงานอยู่
Skill = คู่มือ
ไฟล์ข้อความที่สอน AI ว่างานนี้ทำยังไง ไม่ต่อบริการใด
บางตัวคล้ายกัน: Skill บางตัวมีสคริปต์เรียกเครื่องมือ และ MCP บางตัวส่งแค่ความรู้ ให้ดูที่งานที่อยากทำเป็นหลัก
ใช้กับแอปไหน
Claude CodeCursorGitHub CopilotKiro
ตามที่ README ของผู้ทำเขียนไว้ และโฟลเดอร์ที่มีใน repo
ติดตั้ง
ปลอดภัยไหม
- ใครทำ
บัญชี GitHub junxchan54-maker (บุคคล) เพิ่งเปิดมา 5 เดือน ระวังเป็นพิเศษ
- คนใช้และการดูแล
★ 379 ดาว ยังมีคนใช้น้อย · แก้โค้ดล่าสุด 27 ต.ค. 2569
- มีสคริปต์ไหม
ไม่มี เป็นไฟล์ข้อความล้วน AI อ่านแล้วทำตาม
- ใช้อินเทอร์เน็ตไหม
ไม่มีสคริปต์ จึงไม่เรียกอินเทอร์เน็ตเอง
- แก้ค่าตั้งทั้งเครื่องไหม
ไม่พบ hook หรือการเขียนค่าตั้งของเครื่อง
ตรวจอัตโนมัติจากไฟล์ใน repo ที่ commit 72f74b5 (อ่านไฟล์อย่างเดียว ไม่ได้รัน) ไม่ใช่การรับรองความปลอดภัย อ่านแล้วตัดสินใจเอง
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่ใช้ แล้วหน้านี้จะแสดงเฉพาะวิธีติดตั้งของแอปนั้น
ทางที่ 1อัปโหลดเข้า claude.ai (เว็บและแอป)
ดาวน์โหลดจาก GitHub
Skill นี้ไม่ระบุใบอนุญาต เราจึงไม่แจกไฟล์ ZIP จากเว็บเรา ดาวน์โหลดจาก GitHub แล้วจัดโฟลเดอร์เอง หรือใช้ทาง "ให้ AI ติดตั้งให้" ด้านบนซึ่งง่ายกว่า
ดาวน์โหลดจาก GitHub (ทั้ง repo) ↗
แตกไฟล์ แล้วบีบอัดเฉพาะโฟลเดอร์ mcd-cn-assistant ใหม่ ZIP ต้องมีโฟลเดอร์ mcd-cn-assistant ที่มี SKILL.md อยู่ชั้นบนสุด ห้ามวางไฟล์หลวมไว้ชั้นบนสุด
เปิดหน้า Skills ใน claude.ai แล้วอัปโหลด
+Create skillUpload a skillเลือกไฟล์ mcd-cn-assistant.zip
ไม่เห็นปุ่ม Upload: เปิดสิทธิ์สร้างไฟล์ก่อน
SettingsCapabilitiesCode execution and file creation
ต้องเปิด Code execution and file creation ก่อน (เมนูรุ่นใหม่เรียก Create and edit files) · แผนส่วนตัวที่ Settings → Capabilities · Team/Enterprise ผู้ดูแลเปิดที่ Organization settings → Plugins & skills · ใช้ได้ทุกแผนรวมแผนฟรี
อัปโหลดครั้งเดียว ใช้ได้ทั้ง claude.ai และ Claude Desktop รวมถึง Claude Code รุ่นใหม่ที่ล็อกอินด้วยบัญชี Claude (ล็อกอินด้วยคีย์ API ไม่ซิงก์)
Cowork และ session บนคลาวด์ใช้ Skill ที่เปิดในบัญชี claude.ai ไม่อ่าน ~/.claude/skills ในเครื่อง (งานตั้งเวลาของ Claude Desktop ที่รันในเครื่องยังอ่านได้)
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: support.claude.com, support.claude.com, code.claude.com
ทางที่ 1ให้ Claude Code ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Claude Code
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
เปิด Claude Code ใหม่ แล้วพิมพ์ /mcd-cn-assistant หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.claude/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิด Claude Code ใหม่ แล้วพิมพ์ /mcd-cn-assistant หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง
Skill ที่ติดตั้งเองใช้ได้ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยาย Codex ใน IDE · ChatGPT บนเว็บและมือถือใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี
แอป ChatGPT บนคอม
แอป ChatGPT บนคอมมี Codex อยู่ในตัว Codex อ่าน Skill จากโฟลเดอร์ ~/.agents/skills
ทางที่ 1ให้ ChatGPT ติดตั้งให้
เปิด Codex ในแอป ChatGPT บนคอม แล้ววางประโยคนี้ในแชต
AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ทางที่ 2วางโฟลเดอร์เอง
วางโฟลเดอร์ mcd-cn-assistant ไว้ที่ ~/.agents/skills/mcd-cn-assistant
~ คือโฟลเดอร์บ้านของคุณ ($HOME)
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
หลังติดตั้ง
- แอป ChatGPT บนคอม: เปิด Skills ในแถบข้างเพื่อดูว่า Skill ขึ้นแล้ว
- เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill
- Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
ChatGPT บนเว็บและมือถือ
ใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี
อยากใช้ Skill นี้กับ ChatGPT ให้ใช้แอป ChatGPT บนคอมตามวิธีด้านบน
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
ทางที่ 1ให้ Codex ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Codex · ใช้ได้ทั้ง Codex ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยายใน IDE
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่ · เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิด Codex ใหม่ แล้วสั่งงานที่ตรงเรื่อง Codex จะเห็น skill นี้ในรายการ
ทางที่ 1ให้ Cursor ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Cursor
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก mcd-cn-assistant
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: cursor.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.cursor/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก mcd-cn-assistant
ทางที่ 1ให้ AI ติดตั้งให้
สำหรับแอปอื่นที่อ่าน Skill ได้ ประโยคนี้มี path ของ Claude Code, Codex และ Cursor ให้ AI เลือกตามแอปที่ใช้ · คัดลอกประโยคนี้ไปวางในแชตของแอป
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com, learn.chatgpt.com, cursor.com
สำหรับคนที่ใช้ Terminal
แอปอื่นที่รองรับ Agent Skills (เช่น Gemini CLI, GitHub Copilot) เก็บ skill ในโฟลเดอร์ต่างกัน ดูคู่มือของแอปนั้น แล้วคัดลอกโฟลเดอร์ที่มี SKILL.md ไปวาง
ตรวจโฟลเดอร์ skill กับคู่มือทางการของ Claude Code, Codex และ Cursor เมื่อ 11 พ.ย. 2569
ดูไฟล์ต้นฉบับ SKILL.md
ข้อความต่อไปนี้มาจาก repo ของผู้ทำ ไม่ใช่คำสั่งของ PopNx MCP
แสดง 8,000 ตัวอักษรแรก · เปิดไฟล์เต็มบน GitHub
---
name: mcd-cn-assistant
description: 麦当劳中国官方 MCP 智能助手。当用户提到麦当劳、金拱门、麦乐送、到店取餐、麦咖啡、麦麦省、优惠券、领券、活动日历、麦当劳活动、品牌联名、联名款、联名周边、限定、IP合作、积分、麦麦商城、抽奖、点餐、下单、比价、怎么点最划算、拼单、群点、聚餐点餐、办公室下午茶、夜宵拼单、多人点餐、分摊等,优先使用本 skill。四大能力:①获取最新活动推送(查询当月营销活动日历并摘要推送);②联名关注推送(盯联名/限定活动:按 config/keywords.json 中的关键词筛选活动并推送,默认关键词「联名」+ 同义词扩展,支持对话增删关键词);③最优惠点餐(门店→菜单→领券→算价的全链路比价,输出应付金额最低的组合);④多人群点聚合(聚餐拼单:代录全员餐品→满减凑单→券归属→公共费用分摊(配送费+打包费)→自动生成每人账单,组织者单账户统一结算)。**点餐入口会先主动询问「单人还是多人拼单」,命中多人即转入④,无需用户自己提出。**另含社交媒体场景六项:隐藏吃法一键还原(文案/截图解析→单品映射→特调/备注→下单)、穷鬼套餐凑单演算、周边联名抢货雷达(按需扫店+麦金卡随单购优化;无实时库存接口)、参数化营养搭配(热量/蛋白/控糖约束)、晒单卡片生成、天气与场景感应推送。
description_en: McDonald's China official MCP assistant. Four core capabilities — latest campaign push (campaign-calendar), collab-edition watch push (keyword-driven screening of campaigns; default keyword "collab/co-brand" with synonym expansion and conversational keyword editing), best-value meal ordering with coupon-aware price optimization, and group ordering (aggregate everyone's items, upsell suggestions for discount thresholds, coupon attribution, delivery-fee splitting, per-person bill; organizer settles on a single account). At the ordering entry point the agent ALWAYS asks whether it is a solo order or a group order, so group ordering never depends on the user bringing it up. Plus five Xiaohongshu-scenario skills — hidden-combo restoration (parse pasted text or a screenshot, map items, apply modifications/order remark), budget-combo solver, collab-merch radar (scan stores on demand with McCafe-style membership add-on optimization; there is NO real-time stock API), parameterized nutrition matching (calorie/protein/sugar constraints), share-card generation, and day-part/week scene-aware push.
metadata:
author: mcd-cn-assistant
homepage: https://open.mcd.cn/mcp
category: lifestyle
source: https://github.com/M-China/mcd-mcp-server
---
# 麦当劳中国 MCP 助手(mcd-cn-assistant)
麦当劳中国官方远程 MCP 服务的封装技能,覆盖**活动推送**、**联名关注**、**最优惠点餐**、**多人群点聚合**四条业务主线,以及面向社交媒体场景的**隐藏吃法还原 / 穷鬼套餐演算 / 周边抢货雷达 / 参数化营养搭配 / 晒单卡片 / 场景感应推送**六项扩展能力。
> **核心交互约定**:所有点餐请求都从同一个入口进入——Agent 会**先主动问一句"单人还是多人拼单"**,再据此分流到能力三(最优惠点餐)或能力四(多人群点聚合)。多人拼单不是"用户得自己想到才有的隐藏功能"。见第 3 节。
> **能力总览与实测边界**:第 4~7 节为四大主线;第 8 节为社交媒体场景六项。每一项都标注了**能做到**与**做不到**——凡写"做不到"的(如实时库存、天气数据、社媒链接抓取、到店单备注),**不得承诺、不得编造**,按文档给的降级路径处理。
## 1. 前置依赖与工具寻址
- 依赖已配置的远程 MCP 服务 `mcd-mcp`(Streamable HTTP,`https://mcp.mcd.cn`,需 `Authorization: Bearer <你的 MCP Token>`)。
- 接入方式见 `docs/mcp-setup.md`。若 Token 仍是占位符 `${MCD_MCP_TOKEN}` 未替换,或返回 401 / 403,需引导用户:
1. 前往 <https://open.mcd.cn/mcp> 登录并申请**自己的** MCP Token;
2. 把 MCP 客户端配置里的 `${MCD_MCP_TOKEN}` 占位符替换为**使用者自己的**真实 Token(注意保留 `Bearer ` 前缀);
3. 在客户端中**信任 / 启用**该服务(多数客户端不会自动生效)。
> 本仓库已脱敏,不含任何真实 Token;所有占位符都需使用者自行替换。
- 工具调用名形如 `mcp__mcd-mcp__<tool-name>`(如 `mcp__mcd-mcp__campaign-calendar`)。若列表中找不到工具,先确认服务是否已被信任启用,而不是改用其它数据源。
- 完整工具清单见 `references/mcd-tools.md`。
- 能力四(多人群点聚合)的订单结构、分摊算法与账单模板见 `references/group-order.md`。
- 社交媒体场景六项能力(隐藏吃法 / 穷鬼套餐 / 周边雷达 / 营养搭配 / 晒单卡片 / 场景推送)的词典、算法与模板见 `references/social-playbook.md`。
## 2. 硬性规则(必须遵守)
1. **写操作必须二次确认**:`create-order`、`party-order-create`、`mall-create-order`、`auto-bind-coupons`、`cancel-order`、`draw-lottery`、`delivery-create-address` 等会产生费用、消耗积分或改变账户状态的调用,**必须先向用户列清明细并获得明确同意**,严禁静默执行或"顺手"下单。
2. **下单前必须先算价**:一律以 `calculate-price` 的返回为准,不要自行心算金额、优惠或配送费。
3. **先取时间**:涉及日期、当月活动、可预约日期时,先调用 `now-time-info` 获取当前日期,避免使用模型内置时间。
4. **限流**:每个 Token 每分钟最多 600 次请求,超出返回 429。串行调用、缓存本次会话已获得的结果,避免重复查询同一门店/菜单。
5. **金额展示**统一用 `¥`,保留两位小数。
6. **点餐入口主动询问是否多人拼单**:任何点餐请求在定位门店前,必须先问"单人还是多人拼单"(见第 3 节),不得等用户自己提出,也不得默认按单人处理。
7. **商品编码必须按「门店 × 渠道」现取**:外送菜单编码与到店不同(巨无霸 到店 `1100` / 外送 `901100`;麦香鸡 `1450` / `901450`),且不同门店在售商品可能不同。**严禁跨渠道、跨门店复用编码或价格**;每次先 `query-meals` 再算价。
8. **特调(`modification`)按 key 规则传参**:选中项用 `selectedKey`;未选中但该组有 `unselectedKey` 的项**也必须一并传入**(用 `unselectedKey`)。`calculate-price` **不回显特调结果**,只能确认不报错,不得据此向用户断言"已生效"。
9. **免费配件不是商品**:番茄酱 / 糖 / 胡椒粉 / 空杯 / 奶球等无法加购,只能进 `create-order` 的 `remark`;而 `remark` **仅 `orderType=2`(外送)可用、最多 50 字**。到店单改为给用户到店话术,不得虚构参数。
10. **不承诺没有的能力**:MCP 无门店库存接口、无天气接口、抓不到社媒链接内容(实测小红书链接只返回登录墙)。凡问到此三类,按第 8 节与第 9 节的降级路径处理,**不得编造库存数字、气温降雨或笔记内容**。
11. **社媒卡片 / 文案里的数字必须真实**:价格来自 `calculate-price`,热量来自 `list-nutrition-foods`;没查过就不写,不为好看而编造。
## 3. 点餐入口:下单前必须主动询问「单人 / 多人拼单」
**红线**:任何进入**点餐 / 下单**流程的请求("帮我点个麦当劳""中午吃什么""买份早餐""下午茶"),在澄清基本需求之后、**定位门店之前**,Agent **必须主动问一句**是单人还是多人拼单——**不得等用户自己提出来**。这是能力三与能力四的分流闸口,也是本 skill 的关键交互点。
**询问话术**(一句话自然问出即可,不要做成问卷):
> 这单是**你自己一个人**吃,还是**帮几个人一起点(拼单)**?拼单的话我可以代录大家想吃的、帮你凑满减、把配送费和打包费算清楚,最后出一张「每人应付多少」的账单。
**路由判定**:
| 用户回答 | 走向 |
|---|---|
| "就我自己""单人""一人份""给我点一份" | **能力三 · 最优惠点餐**(第 6 节) |
| "帮 XX 点""几个人一起""拼单""群点""办公室/同事/同学/室友一起" | **能力四 · 多人群点聚合**(第 7 节) |
| 含糊不清或未表态(如"随便点点") | **再确认一次**(单人还是多人),**不要默认按单人处理** |
**入口免问的例外**:若用户在同一句话里已明确表达群体诉求,视为**已答复**,直接进入能力四(可顺带确认人数),**不要重复问第二遍**。
**主动识别信号**(命中任一 → 在入口按群体意图确认,或直接进入能力四):拼单、群点、一起点、帮大家点、多人、几个人、N 人份、办公室、同事、同学、室友、宿舍、家庭、聚餐、下午茶、夜宵拼单、AA、算账、分账、账单、每人多少。
**忌**:
- 问一次就够——用户答复过就不再追问;
- 用户已明确单人(如"我就想喝杯咖啡")时不再提拼单,也不反复推销;
- **不得把"用户没提"当成"单人"**:入口的默认动作是**问一句**,而不是默认单人。这正是本节点要修正的问题。
## 4. 能力一:获取最新活动推送
**触发**:用户问"最近有什么活动""麦当劳有什么优惠/新品""活动日历""这个月有什么"。
**流程**:
1. `now-time-info` → 拿到当前年月。
2. `campaign-calendar` → 获取当月营销活动日历,返回**进行中 / 往期 / 未来**三类。
3. 可选增强:`available-coupons`(麦麦省可领券)、`query-my-coupons`(我已有的券)。
4. 按"**进行中** → **即将开始**"分组摘要输出,**略过往期**(除非用户点名要看)。
**输出格式**(每条一行):
| 状态 | 活动名称 | 起止时间 | 一句话参与方式 | 渠道/入口 |
|---|---|---|---|---|
末尾补一句「需要我盯着联名款 / 限定活动,有新的就推给你吗?」引导用户进入能力二。
## 5. 能力二:联名活动关注推送(关键词机制驱动)
**定位**:这是"只看我关心的那几条"的能力。默认瞄准**联名 / 限定 / IP 合作**这类最容易错过开售时点的活动,但底层是**通用关键词匹配**——用户换成"新品""早餐""周边"同样成立。
**关键词来源**:本 skill 的 `config/keywords.json` → `follow_keywords`(默认:`["联名"]`),并参考其中的 `synonyms` 做同义扩展匹配(`联动 / 限定 / 合作款 / 联名款 / IP合作 / 品牌合作 / co-brand / 联名活动`)。
> **「联动」必须留在同义词里**:麦当劳对 IP 合作的官方文案常写「联动」而非「联名」(如「麦当劳联动G-DRAGON」)。2026-10-13 实测:同义词缺「联动」时该活动被整条漏推,而它的联名食品(龙焰鸡腿堡)在菜单里明明可以买到——漏推代价是实的。已知残留边界:同系列活动但标题与描述均不含关键词的(如「韩式风味蘸酱」,仅描述含"getGD同款")仍不会命中,此时应**回退到当日全量日历**逐条讲给用户,不要为它把词放宽到「同款」这类过泛词(会误伤「心形薯饼同款比心」等无关活动)。
**执行流程(推送任务与被追问时均执行)**:
1. 读取 `config/keywords.json`。若文件不存在,用默认关键词重建。
2. `now-time-info` → `campaign-calendar`(必要时叠加 `available-coupons`)。
3. 用关键词对**活动名称 + 活动描述 + 标签**做不区分大小写的命中匹配,支持同义词扩展(如"联名"≈"合作款 / 联名款 / IP合作 / 品牌合作")。
4. **按活动名去重**:`campaign-calendar` 会把同一条活动按排期日 / 结束日**重复返回多次**(实测 2026-10-17:「麦当劳 X PEACEMINUSONE 棒球帽」在 10-13 与 10-17 各行一次、「麦当劳联动G-DRAGON」在 10-16 与 10-17 各行一次、「韩式风味蘸酱」在 10-17 与 10-18 各行一次)。**同一活动名只保留一条**,状态按"进行中 > 即将开始 > 往期"取最高优先级的那次出现;**往期一律不推**(除非用户点名要看)。
5. **只推送去重后命中的活动**;无命中时明确回复:`今日无命中关键词「X」的新活动`,不要用无关活动凑数。
6. 定时推送由外部自动化任务触发(建议每日 09:00,见 `config/keywords.json` 的 `push_time`),本 skill 只负责"查询 + 筛选 + 组织推送内容"。
**推送文案结构**(先经步骤 4 去重,同一活动只出现一行):
```
🎉 麦当劳活动关注推送 | <日期>
命中关键词:<关键词列表>
—— 进行中 ——
· <活动名> <起止时间>
<一句话说明>
—— 即将开始 ——
· ...
无命中关键词时直接说明,不凑数。
```
**关键词维护(对话式)**:
- 用户说"关注一下XX""加上关键词XX" → 追加到 `follow_keywords`,去重。
- 用户说"不再关注XX" → 从 `follow_keywords` 移除。
- 用户说"我关注了哪些关键词" → 读取并回显列表。
- 每次修改后写回 `config/keywords.json` 并更新 `updated_at`,然后回显**最新完整列表**确认。
**联名周边的购买渠道(2026-10-16 实测修正,取代 10-13 的错误结论)**:
> ⚠️ **史误记录**:10-13 曾据此写下"联名周边无法通过 MCP 购买、必须引导去 APP"。**该结论是错的**——当时只测了上海一家门店的**到店自取**菜单就下了全局判断。10-16 测**外送**菜单后发现周边就在菜单里、可以正常算价下单。教训:**菜单能力必须按「门店 × 渠道」分别实测,不能用一个门店的一个渠道推断全局。**
联名周边(棒球帽 / 徽章 / 丝巾 / 毛绒周边等)以**普通可售商品**形式出现在 `query-meals` 返回里,`discountType` 为 `随单购麦金卡优惠`,并带 `withOrder: {membershipCode: "106", specId: "880"}`。实测编码(深圳金丰城外送,2026-10-16):`521954` 麦当劳联名复古棒球帽(¥39.90,麦金卡价 ¥34.90)、`521955` 麦当劳联名徽章、`521743` 薯条脆卜卜毛绒周边(¥29.90 / ¥24.90)。
**实测算价(外送 · 深圳金丰城 1421053)**:
| 方案 | 明细 | 实付 |
|---|---|---|
| 裸买周边 | 棒球帽 ¥39.90 + 配送费 ¥6.00 | ¥45.90 |
| **周边 + 麦金卡随单购(推荐)** | 棒球帽 ¥34.90 + 麦金卡体验卡(15 天)¥9.90 + 配送费 ¥0 + 打包费 ¥0 | **¥44.80** |
| 周边 + 餐 + 麦金卡随单购 | 棒球帽 ¥34.90 + 巨无霸 ¥29.00 + 体验卡 ¥9.90 + 配送费 ¥0 + 打包费 ¥0 | ¥73.80 |
三条硬结论:
1. **周边能买**,走 `query-meals` → `calculate-price` → `create-order` 主链路即可,不需要积分商城。
2. **加购 15 天麦金卡体验卡(¥9.90)几乎总是更划算**:周边降 ¥5 + 免配送费 + 免打包费,实测净省 ¥1.10~¥12.10。`calculate-price` 会自动把 `521234 麦金卡体验卡(15天)` 和归零的配送/打包费写进 `productList`,**照抄返回值即可,不要自己拼价格**。
3. **周边พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ข้อมูลจาก GitHub
- ดาว GitHub
- 379
- ผู้ทำ
- junxchan54-maker
- license
- ไม่ระบุสัญญาอนุญาต รีโปนี้ไม่ได้ระบุสัญญาอนุญาต (license) ตามกฎหมายลิขสิทธิ์ถือว่าเจ้าของสงวนสิทธิ์ไว้ ใช้เองได้แต่ควรถามเจ้าของก่อนแจกต่อหรือใช้ในงานขาย
- แก้โค้ดล่าสุด
- 27 ต.ค. 2569
- ไฟล์ SKILL.md ใน repo (นับรวมสำเนาภาษาอื่นและแม่แบบ)
- 1
- topic
- agent-skills, ai, ai-agent, automation, claude, claude-code, coupon, curso, food-ordering, llm, mcd, mcdonalds