Skip to content
Back to search

mcd-party-officer

SkillWorks with Claude CodeGitHub

麦当劳门店派对/包场/拼团的选址、成团调度与筹备助手。当用户想办生日派对、亲子派对、主题派对、品鉴会、读书会、麦麦体验营,或说「麦当劳派对」「派对拼团」「包场」「生日会怎么办」「哪家店能办派对」「还差几个人成团」「包场还是拼团划算」「帮我写拼团招募文案」「做一张派对邀请函」「孩子派对吃什么不超标」时使用。基于麦当劳官方 MCP(mcp.mcd.cn)的 party 系列工具:扫描全城场次、估算成团概率、对比包场与拼团成本、按官方营销活动日历挑最佳日期、审查儿童餐营养、生成招募卡与邀请函。

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/yzg1226--mcd-party-officer/badge.svg)](/listings/yzg1226--mcd-party-officer)

HTML

<a href="/listings/yzg1226--mcd-party-officer"><img src="/api/listings/yzg1226--mcd-party-officer/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 · 181 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-party-officer
  3. agent_created: true
  4. description: 麦当劳门店派对/包场/拼团的选址、成团调度与筹备助手。当用户想办生日派对、亲子派对、主题派对、品鉴会、读书会、麦麦体验营,或说「麦当劳派对」「派对拼团」「包场」「生日会怎么办」「哪家店能办派对」「还差几个人成团」「包场还是拼团划算」「帮我写拼团招募文案」「做一张派对邀请函」「孩子派对吃什么不超标」时使用。基于麦当劳官方 MCP(mcp.mcd.cn)的 party 系列工具:扫描全城场次、估算成团概率、对比包场与拼团成本、按官方营销活动日历挑最佳日期、审查儿童餐营养、生成招募卡与邀请函。
  5. ---
  6. # 派对拼团官(McDonald's Party Officer)
  7. 麦当劳门店派对在 MCP 里是一条**完整但几乎无人使用**的业务线:城市 → 门店 → 可约日期 → 场次(含成团人数与余位)→ 下单,五个工具环环相扣。
  8. 本 Skill 不是"帮你订个派对",而是**一整套派对决策系统**。官方规则写着两条关键约束:
  9. - **拼团若未在截止前凑够人数会自动取消并退款**
  10. - **需提前 3 天预订**
  11. 于是就产生了四个真实问题,也正是本 Skill 的四大能力:
  12. | 问题 | 能力 | 用户会怎么问 |
  13. |---|---|---|
  14. | 哪家店、哪天、哪场我最可能凑满人? | **成团概率雷达** | "6 个人能办成吗" |
  15. | 包场还是拼团?哪个划算? | **双模式成本对比** | "包场和拼团差多少钱" |
  16. | 未来哪天办最值? | **派对黄历** | "最近哪天办合适" |
  17. | 孩子吃这些会不会钠/热量超标? | **儿童营养安心指数** | "这个搭配健康吗" |
  18. 再加上三个**能直接拿去用**的产出物:**拼团招募卡**(发群)、**派对邀请函**(可分享 HTML)、**筹备时间线**(T-7→T 待办 + 预订截止倒计时)。
  19. ## When to use
  20. - 选址与成团:「想给孩子办麦当劳生日会」「附近哪家店能办派对」「还差几个人成团」
  21. - 决策:「包场还是拼团」「多少钱」「有没有余位」「最近哪天有活动」
  22. - 健康:「开心乐园餐这套搭配适合小孩吗」「怎么换更健康」
  23. - 传播:「帮我写个拼团招募文案」「做张派对邀请函发群里」
  24. - 其它派对型商品:主题派对、麦麦体验营、品鉴会、读书会、积分兑换活动
  25. ## 八大能力总览
  26. | # | 能力 | 函数 | 输入 → 输出 |
  27. |---|---|---|---|
  28. | 1 | 成团调度扫描 | `party_officer.plan` | 城市+商品+人数 → Top N / 最易成团 / 余位告急 |
  29. | 2 | **成团概率雷达** | `party_plus.formation_radar` | 场次+人数 → 成团概率 % + 差几人 + 拉人话术 |
  30. | 3 | **包场 vs 拼团** | `party_plus.compare_modes` | 场次+人数 → 两模式总价、确定性、推荐结论 |
  31. | 4 | **派对黄历** | `party_plus.party_almanac` | 候选日期 → 逐日评分(活动/周末/余位/提前量) |
  32. | 5 | **营养安心指数** | `party_plus.kids_nutrition_audit` | 餐单 → 逐项营养 + 评分 A/B/C + 替换建议 |
  33. | 6 | **筹备时间线** | `party_plus.party_timeline` | 活动日 → T-7→T 待办 + 预订截止倒计时 |
  34. | 7 | 招募卡 / 邀请函 | `render_recruit_card` / `render_invite_html` | 场次 → 可发群文本 / 可分享 HTML |
  35. | 8 | 四宫格比选 | `party_plus.scout_grid` | 候选 → 最优综合/最省/最近/空位最多 |
  36. ## 派对业务关键规则(来自官方商品说明,务必向用户复述)
  37. | 规则 | 内容 |
  38. |---|---|
  39. | 成团下限 | 包场 5 人起订;**拼团需超过 5 人**才可举办 |
  40. | 成团上限 | 每场最高 12 人(含) |
  41. | 加价 | 包场每增加 1 人 +¥50(以实际场次 price 字段为准) |
  42. | 时长 | 约 90 分钟 |
  43. | 预订提前量 | **需提前 3 天预订** |
  44. | 拼团风险 | **未成团则预约自动取消并自动退款** |
  45. | 退订 | 需在活动日前 3 天申请,当天缺席不退款 |
  46. | 适用人群 | 多数生日派对商品面向 4–12 岁儿童(不同商品不同) |
  47. > 价格、人数门槛、适用人群**因商品而异**,一律以 `mall-product-detail` 返回的 `note` 与 `skuList[].price` 为准。
  48. ## 执行流程
  49. ### 第 0 步:确定派对商品(spuId)
  50. ```
  51. mall-points-products({"catRuleIds": "1>6>20"}) # 生日类派对
  52. mall-points-products({"catRuleIds": "1>6>21"}) # 主题类派对
  53. mall-points-products({"catRuleIds": "1>6>22"}) # 麦麦体验营
  54. mall-points-products({"catRuleIds": "1>6>25"}) # 品鉴会
  55. mall-points-products({"catRuleIds": "1>6>34"}) # 读书会
  56. mall-points-products({"catRuleIds": "1>6>40"}) # 积分兑换活动
  57. ```
  58. 拿到 `spuId` 后,用 `mall-product-detail({"spuId": ...})` 读取 `skuList[].skuId`(下单必需)与 `note`。
  59. ### 第 1–4 步:扫描场次(核心)
  60. ```
  61. query-party-city({"spuId": 1779}) → 城市列表(code / 经纬度)
  62. query-party-store({"code": "330100", → 可承办门店(含 distance / 营业状态)
  63. "spuId": 1779,
  64. "latitude": ..., "longitude": ...})
  65. query-party-store-date({"spuId": 1779, → 可预约日期
  66. "storeCode": "3330206"})
  67. query-party-store-session({"spuId": 1779, → 场次(时间/成团人数/价格/余位)
  68. "storeCode": "3330206",
  69. "dateStr": "2026-10-14"})
  70. ```
  71. ### 第 5 步:成团调度排序
  72. 对每个候选场次打分(`scripts/party_officer.py::score`),五维:成团可行性(硬约束)、余位紧张度、时段匹配、价格、距离。
  73. 输出三个视图:**推荐 Top N**、**最易成团**、**余位告急**。
  74. ### 第 6 步:下单(必须二次确认)
  75. ```
  76. party-order-create({"partyType": 1, # 1=包场,2=拼团
  77. "spuId": 1779, "skuId": 2027,
  78. "storeCode": "3330206", "code": "330100",
  79. "dateStr": "2026-10-14",
  80. "id": 36825489, # 场次 id
  81. "leftNum": 12, "count": 6})
  82. ```
  83. **未经用户明确确认,禁止调用下单类工具。**
  84. ## 创意增强模块(差异化所在)
  85. > 以下模块全部为**纯算法 + 官方数据**,不依赖模型猜测,结果可复现、可解释。
  86. ### ① 成团概率雷达 `formation_radar(date, sess, headcount)`
  87. 输出 `prob`(5~95%) / `level` / `gap`(还差几人) / `reasons`(逐条依据) / `pitch`(可直接发群的拉人话术)。
  88. 评分依据(透明可查):是否达成团线(基础 68,每差 1 人 −11)/余位是否够用(+8 / +2 / −22)/筹备窗口(3–7 天 +10,≤2 天 −16)/周末 +7 /晚市 +4。
  89. ### ② 包场 vs 拼团 `compare_modes(sess, headcount)`
  90. 给出两种模式的**总价、确定性、推荐结论**。要点:包场按 `max(人数, 起订数)` 计费换取"确定举办";拼团按实际人数计费但承担未成团退款风险。同价时优先包场。
  91. ### ③ 派对黄历 `party_almanac(cli, dates, sessions_by_date, headcount)`
  92. 把 `campaign-calendar`(**markdown 文本,需 `raw_text=True` 解析**)的官方活动日与场次余位结合,逐日评分:
  93. 有官方活动 +18 /周末 +12 /余位充足 +10 /满足提前 3 天 +8 /不满足 −30。
  94. 输出 `宜 / 可 / 忌` 与"当月有活动的日期"清单。
  95. ### ④ 儿童营养安心指数 `kids_nutrition_audit(cli, combo)`
  96. 数据源 `list-nutrition-foods`(**158 个餐品的表格文本,藏在 JSON 的 `data` 字段里**,需二次解析)。
  97. 对一份餐单算合计热量/脂肪/钠/碳水,按**超出参考上限的比例**扣分,给 A/B/C 评级,并自动给出替换建议(如「中薯条→小薯条 = 钠 −45mg、热量 −79kcal」)。
  98. > 参考区间为儿童单餐:热量 400–700 kcal、钠 ≤800 mg、脂肪 ≤26 g。**这是本模块唯一的硬编码标准,需向用户说明是参考值而非官方结论。**
  99. ### ⑤ 筹备时间线 `party_timeline(date)`
  100. 输出 T-7 → T 日待办与**预订截止倒计时**(截止日 = 活动日 − 3 天),并在 ≤3 天时给出强提醒。
  101. ### ⑥ 招募卡 / 邀请函
  102. - `render_recruit_card(...)` → 带余位进度条的群消息文本
  103. - `render_invite_html(...)` → 麦当劳红黄配色的单文件邀请函(浅色、可直接分享)
  104. ### ⑦ 四宫格比选 `scout_grid(ranked)`
  105. 一屏给出:**最优综合 / 最省人均 / 最近门店 / 空位最多**。
  106. ## 输出规范
  107. 给用户的最终答复建议为四段:
  108. 1. **商品与规则**:派对名称、人均价、成团区间、提前预订天数、适用人群
  109. 2. **推荐场次表**:`门店 | 日期 | 时段 | 人均 | 余位 | 成团概率 | 推荐理由`
  110. 3. **决策建议**:包场还是拼团 + 最佳日期 + 筹备截止提醒
  111. 4. **可复制产出**:招募卡文本(或邀请函文件路径)+ 是否代下单的确认问句
  112. 金额一律显示为「元」(接口单位为**分**,需 `/100`)。
  113. ## 代码入口
  114. ```bash
  115. export MCD_MCP_TOKEN=<your_token> # https://open.mcd.cn/mcp 免费领取
  116. python scripts/demo.py # 基础演示(成团调度)
  117. python scripts/demo_plus.py # 创意增强演示(八大能力全量)
  118. ```
  119. ```python
  120. from scripts.party_officer import plan
  121. from scripts.party_plus import formation_radar, compare_modes, party_almanac, \
  122. kids_nutrition_audit, party_timeline, render_recruit_card, render_invite_html, scout_grid
  123. res = plan("杭州市", 1779, headcount=6, budget=60, prefer_time="dinner")
  124. top = res["best"][0]
  125. radar = formation_radar(top["date"], top["sess"], 6) # 成团概率
  126. modes = compare_modes(top["sess"], 6) # 包场 vs 拼团
  127. audit = kids_nutrition_audit(cli, ["吉士汉堡包", "中薯条", "可乐中杯"]) # 营养
  128. ```
  129. - `scripts/mcd_client.py` —— MCP 通用客户端(35 工具,仅标准库)
  130. - `scripts/party_officer.py` —— 扫描 + 五维成团调度评分
  131. - `scripts/party_plus.py` —— 七个创意增强模块
  132. - `references/party_flow.md` —— 链路详解与字段字典
  133. - `references/tools.md` —— 全量工具速查
  134. ## 边界与注意事项
  135. - **只读优先**:除 `party-order-create` 外全部为只读调用,可放心批量扫描。
  136. - **两种响应格式**:多数工具返回 JSON(用 `extract_json` 解析);`campaign-calendar` 与 `list-nutrition-foods` 返回**文本/表格**,需 `raw_text=True` 或取 `data` 字段后二次解析。
  137. - **团餐接口不稳**:`query-meals` / `query-promotions` 依赖门店营业状态,非营业时段会返回「门店可能已关闭或不在营业时间」,不要作为核心链路依赖。
  138. - **城市匹配**:`query-party-city` 返回全国城市,按名称宽松匹配("杭州" 可命中 "杭州市")。
  139. - **门店筛选**:只保留 `businessStatus == 1` 且 `onlineBusinessStatus == true` 的门店。
  140. - **限流**:单 Token 600 请求/分钟;扫描请求数 = 门店数 × 日期数,建议 `max_stores ≤ 8`、`max_dates ≤ 3`。
  141. - **Token 安全**:只从环境变量读取,不要写入代码或提交到仓库。
README.md · README · 310 lines

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

  1. <div align="center">
  2. # 🍟 派对拼团官 · McParty Officer
  3. **麦当劳门店派对最怕的不是贵,是凑不齐人。**
  4. **一句话问出去,回来一张「这场到底办得成吗」的确定性答案。**
  5. </div>
  6. [![Live Demo](https://img.shields.io/badge/live--demo-online-blueviolet.svg)](https://yzg1226.github.io/mcd-party-officer/)
  7. [![MCP](https://img.shields.io/badge/MCD_MCP-live-DA291C.svg)](MCP_INTEGRATION.md)
  8. [![Skill](https://img.shields.io/badge/WorkBuddy-Skill-FFC72C.svg)](SKILL.md)
  9. [![Live Tested](https://img.shields.io/badge/live_tested-2026--10--09-brightgreen.svg)](#四使用示例)
  10. [![Python](https://img.shields.io/badge/python-3.7%2B%20zero_dep-blue.svg)](#三快速开始)
  11. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  12. > 官方规则写明:拼团未在截止前凑够人数会**自动取消并退款**。
  13. > 本项目把派对从「怎么策划」推进到「**到底办不办得成**」:算成团概率、比包场与拼团、挑最值的日子、一键生成招募卡把人群拉满,并给出预订截止倒计时。
  14. **别人帮你策划一场派对;我们帮你把人凑齐、把场锁定、把日子挑对、把人喊来。**
  15. | 纯 Python 标准库 | 麦当劳官方 MCP | 全链路真实跑通 | 零第三方依赖 |
  16. |:--:|:--:|:--:|:--:|
  17. | 3.7+ 即可运行 | `mcp.mcd.cn` | 真实场次 / 余位 / 满减 | 无 pip install |
  18. ![真实运行输出](docs/preview-1-output.png)
  19. > 上图为 2026-10-09 用真实 Token 跑通的原始输出,未做美化、未替换数据。
  20. ---
  21. ## 🎬 先看效果:在线演示(免安装、免 Token)
  22. > **[🍟 打开在线演示页](https://yzg1226.github.io/mcd-party-officer/)** —— 浏览器直接点:
  23. > 切换人数(4 / 6 / 9 人),看成团概率雷达、包场 vs 拼团对比、招募卡与邀请函的完整输出。
  24. > 页面为 2026-10-09 真实 Token 跑通的快照(由本仓库 `scripts/party_plus.py` 真实函数计算固化),**不是实时查询**,已明确标注。
  25. ---
  26. ## 🚀 三步开吃
  27. ### 第 1 步 · 把这段话整段发给 WorkBuddy(不用碰命令行)
  28. ```text
  29. 帮我安装这个技能:https://github.com/yzg1226/mcd-party-officer
  30. 把仓库内容放到用户级技能目录 ~/.workbuddy/skills/mcd-party-officer/
  31. (SKILL.md 与 scripts/ 需同级保留),确认 SKILL.md 存在,装完提醒我重开一轮会话
  32. ```
  33. > **熟手可用命令行**(效果一样,重复执行即更新):
  34. >
  35. > ```bash
  36. > git clone https://github.com/yzg1226/mcd-party-officer.git ~/.workbuddy/skills/mcd-party-officer
  37. > ```
  38. >
  39. > 卸载:`rm -rf ~/.workbuddy/skills/mcd-party-officer`
  40. ### 第 2 步 · 对它说一句话
  41. > **「帮我给 6 岁的女儿办一场麦当劳生日会,杭州,6 个人,晚上办」**
  42. 它会自己确认城市、扫场次、算成团概率,最后把决策摆在你面前。
  43. ### 第 3 步 · 贴一次 Token,以后一直免配置
  44. 第一次使用时按提示到 <https://open.mcd.cn/mcp> 登录 → 控制台 → 激活 → 复制 Token,粘进对话即可。
  45. Token 只写进你本机的环境变量或 WorkBuddy 配置,**不进仓库、不进日志、不在回复里回显**。
  46. > ⚠️ Token 等同账号凭证:只贴在自己的对话里,不要发群聊、朋友圈或 GitHub。
  47. ---
  48. ## 📖 目录
  49. | 章节 | 你会看到 |
  50. |---|---|
  51. | [三步开吃](#-三步开吃) | 一句话装进 WorkBuddy |
  52. | [30 秒看懂](#30-秒看懂它和别的派对-skill-差在哪) | 它和策划类 / 地图类 Skill 的本质差别 |
  53. | [痛点](#一痛点派对最容易死在凑不齐人) | 为什么派对真正死在「凑不齐人」 |
  54. | [解决什么](#二本项目解决什么) | 四个决策、三个产出物、一个扫描视图 |
  55. | [快速开始](#三快速开始) | Token / 配置 / 运行 |
  56. | [使用示例](#四使用示例) | 对话式、代码式、真实运行输出 |
  57. | [能力清单](#五能力清单) | 八大能力入口 |
  58. | [隐私与安全](#八隐私与安全) | Token 与下单的边界 |
  59. | [参赛信息](#九参赛信息) | 参赛材料对照 |
  60. ---
  61. ## 30 秒看懂:它和别的派对 Skill 差在哪
  62. 派对赛道已有两类做法,都很不错,但都**停在下单之前**:
  63. | 做法 | 代表 | 它回答的问题 | 停在 |
  64. |---|---|---|---|
  65. | **策划案生成** | 多角色协作输出主题、流程、预算 | "怎么办好这场派对" | 方案交付即结束 |
  66. | **活动地图 / 雷达** | 把门店与可约场次可视化 | "哪里有能办的场次" | 展示即结束 |
  67. | **本项目** | 成团调度与撮合 | **"这场办得成吗、人怎么凑齐"** | 一直管到**锁场 + 拉人** |
  68. 差异不在功能多少,而在**是否回答了那个真正会导致派对泡汤的问题**:
  69. | 维度 | 策划 / 地图类 | 本项目 |
  70. |---|---|---|
  71. | 核心问题 | 怎么办好、哪里有 | **办得成吗、人怎么凑齐** |
  72. | 输出性质 | 文档 / 列表 | **可复现的概率与成本数字** |
  73. | 风险量化 | 无 | **成团概率、包场 vs 拼团的确定性差异** |
  74. | 传播环节 | 无 | **招募卡 + 邀请函,复制即可发群** |
  75. | 时间管理 | 无 | **T-7 → T 筹备时间线 + 预订截止倒计时** |
  76. 「未成团自动退款」这条规则,只有先发现它,才会意识到真问题是**凑人**而不是**策划**——这就是本项目的立足点。
  77. ## 两个能直接发出去的产出物
  78. 工具产出数字容易,产出**能传播的内容**难。派对是麦当劳场景里唯一自带"发出去"动作的品类:
  79. ![拼团招募卡](docs/preview-2-recruit-card.png)
  80. ![派对邀请函](docs/preview-3-invite.png)
  81. > 邀请函为单文件 HTML,麦当劳红黄配色,可直接分享;上图为真实渲染结果。
  82. > 招募卡为纯文本,复制即可粘贴到任意群聊。
  83. ---
  84. ## 一、痛点:派对最容易死在"凑不齐人"
  85. 麦当劳门店派对的官方规则里有两条硬约束,它们决定了这个场景真正的难点:
  86. | 规则 | 后果 |
  87. |---|---|
  88. | 拼团若未在截止前凑够人数,**预约自动取消并退款** | 选错场次 = 白折腾,生日当天没场地 |
  89. | **需提前 3 天预订** | 留给"拉人"的窗口是有限的倒计时 |
  90. 于是用户在真实场景里会连续撞上四个问题:
  91. 1. **哪家店、哪天、哪一场,我最可能凑满人?** —— 余位和成团区间全在门店端,没法自助比价
  92. 2. **包场还是拼团?** —— 两种模式价格与风险不同,没人会算
  93. 3. **未来哪天办最值?** —— 官方营销活动日历是公开的,但没人拿它做决策
  94. 4. **怎么快速把人凑齐?** —— 发群、催人、统计,全靠人肉
  95. ## 二、本项目解决什么
  96. ### 四个决策
  97. | 能力 | 说明 | 用户怎么问 |
  98. |---|---|---|
  99. | **成团概率雷达** | 把"未成团自动退款"的风险变成一个**可读的百分比**,并给出还差几人、拉人话术 | "6 个人能办成吗" |
  100. | **包场 vs 拼团对比** | 两种模式的总价、举办确定性、推荐结论,找出人数临界点 | "包场还是拼团划算" |
  101. | **派对黄历** | 官方营销活动日历 × 场次余位 × 提前量 → 未来哪天办最值(宜/可/忌) | "最近哪天办合适" |
  102. | **儿童营养安心指数** | 对派对餐单做热量/钠/脂肪多约束评分,并自动给出替换建议 | "这套搭配孩子吃健康吗" |
  103. ### 三个产出物
  104. | 产出 | 用途 |
  105. |---|---|
  106. | **拼团招募卡** | 带余位进度条与成团概率的群消息文本,复制即可发 |
  107. | **派对邀请函** | 麦当劳红黄配色的单文件 HTML,可直接分享 |
  108. | **筹备时间线** | T-7 → T 日待办清单 + 预订截止倒计时 |
  109. ### 一个扫描视图
  110. **五维成团调度评分**:成团可行性(硬约束)→ 余位紧张度 → 时段匹配 → 价格 → 距离,输出三个视图:**推荐 Top N / 最易成团 / 余位告急**,以及一屏四宫格(最优综合 / 最省人均 / 最近门店 / 空位最多)。
  111. ## 三、快速开始
  112. ### 1. 获取 MCP Token
  113. 访问 <https://open.mcd.cn/mcp>,手机号登录 → 控制台 → 激活 → 复制 Token(免费)。
  114. > 每个 Token 每分钟最多 600 次请求,Token 请勿写入代码或提交到仓库。
  115. ### 2. 配置 MCP(可选)
  116. 若在支持 MCP 的客户端里使用,参考 `mcp-config.example.json`(脱敏示例,仅含环境变量占位符)。
  117. ### 3. 运行
  118. ```bash
  119. export MCD_MCP_TOKEN=<你的 MCP Token> # Windows: set MCD_MCP_TOKEN=...
  120. python scripts/demo.py # 基础演示:成团调度扫描
  121. python scripts/demo_plus.py # 完整演示:八大能力全量
  122. ```
  123. 零第三方依赖,仅使用 Python 标准库(3.7+)。
  124. ## 四、使用示例
  125. ### 对话式(在 WorkBuddy / Claude Code 等客户端中)
  126. ```
  127. 用户:帮我给 6 岁的女儿办一场麦当劳生日会,杭州,6 个人,预算每人 60,想晚上办
  128. 派对拼团官:
  129. 【商品与规则】麦当劳奇妙生日派对 · 人均 ¥50 · 5~12 人成团 · 需提前 3 天预订 · 面向 4-12 岁
  130. 【推荐场次】
  131. 门店 日期 时段 人均 余位 成团概率 理由
  132. 杭州大厦501城市广场 2026-10-14 18:30 ¥50 12 90% 已达 5 人成团线 / 晚市热度高 / 筹备期 5 天
  133. ...
  134. 【决策建议】推荐包场(与拼团同价,但 100% 确定举办);最佳日期 10-14(当天有官方活动)
  135. 【提醒】预订截止 10-11,仅剩 2 天
  136. 【可复制产出】<拼团招募卡文本>
  137. ```
  138. ### 代码式
  139. ```python
  140. from scripts.party_officer import plan
  141. from scripts.party_plus import formation_radar, compare_modes, kids_nutrition_audit
  142. res = plan("杭州市", 1779, headcount=6, budget=60, prefer_time="dinner")
  143. top = res["best"][0]
  144. radar = formation_radar(top["date"], top["sess"], 6) # 成团概率 90%
  145. modes = compare_modes(top["sess"], 6) # 包场 vs 拼团
  146. audit = kids_nutrition_audit(cli, ["吉士汉堡包", "中薯条", "可乐中杯"])
  147. ```
  148. ### 真实运行输出(2026-10-09 实测)
  149. ```
  150. ① 成团概率雷达
  151. 场次:杭州大厦501城市广场餐厅 2026-10-14 18:30
  152. 成团概率:90%(高,可放心订)| 还差 0 人 | 距活动 5 天
  153. ② 包场 vs 拼团
  154. 包场 6 人 ¥300 100%(确定举办)
  155. 拼团 6 人 ¥300 取决于成团(未成团自动退款)
  156. 结论:推荐【包场】
  157. ④ 儿童营养安心指数
  158. 吉士汉堡包 + 中薯条 + 可乐中杯 = 730 kcal / 脂肪 24g / 钠 838mg
  159. 安心指数:79 分 → B(尚可,建议微调)
  160. 把「中薯条」换成「小薯条」→ 钠 -45mg、热量 -79kcal
  161. ```
  162. ## 五、能力清单
  163. | # | 能力 | 入口 |
  164. |---|---|---|
  165. | 1 | 成团调度扫描 | `party_officer.plan` |
  166. | 2 | 成团概率雷达 | `party_plus.formation_radar` |
  167. | 3 | 包场 vs 拼团对比 | `party_plus.compare_modes` |
  168. | 4 | 派对黄历 | `party_plus.party_almanac` |
  169. | 5 | 儿童营养安心指数 | `party_plus.kids_nutrition_audit` |
  170. | 6 | 筹备时间线 | `party_plus.party_timeline` |
  171. | 7 | 招募卡 / 邀请函 | `party_plus.render_recruit_card` / `render_invite_html` |
  172. | 8 | 四宫格比选 | `party_plus.scout_grid` |
  173. 算法细节与阈值见 [`references/creative_modules.md`](references/creative_modules.md)。
  174. ## 六、目录结构
  175. ```
  176. mcd-party-officer/
  177. ├── SKILL.md # 技能主文件(Agent 运行时加载)
  178. ├── README.md # 本文件
  179. ├── CONTEST_DECLARATION.md # 参赛声明(官方原文,未改动)
  180. ├── MCP_INTEGRATION.md # MCP 接入说明
  181. ├── mcp-config.example.json # 脱敏配置示例
  182. ├── workbuddy.md # WorkBuddy 开发对话上下文
  183. ├── docs/ # README 预览图
  184. ├── examples/sample_invite.html # 邀请函产物示例
  185. ├── scripts/
  186. │ ├── mcd_client.py # MCP 通用客户端(仅标准库)
  187. │ ├── party_officer.py # 扫描 + 五维成团调度评分
  188. │ ├── party_plus.py # 七个创意增强模块
  189. │ ├── demo.py # 基础演示
  190. │ └── demo_plus.py # 完整演示
  191. └── references/
  192. ├── party_flow.md # 业务链路与字段字典
  193. ├── tools.md # 全量工具速查 + 响应格式陷阱
  194. └── creative_modules.md # 创意模块算法说明
  195. ```
  196. ## 七、目标用户
  197. - **有孩子的家庭**:想办生日会,但不清楚哪家店能办、哪场最容易凑满人
  198. - **公司行政 / 团建组织者**:需要在小预算下组织团体派对
  199. - **朋友聚会组局人**:需要快速招募、统计人数、把场锁定
  200. - **门店端运营**:可用于观察余位分布与成团难度
  201. ## 八、隐私与安全
  202. - **Token 只从环境变量读取**,不写入代码、不提交仓库(`mcp-config.example.json` 仅含占位符)
  203. - 全流程**只读优先**:除下单接口 `party-order-create` 外均为只读调用;下单必须经用户二次确认
  204. - 不在日志或输出中展示任何个人凭证信息
  205. - 项目输出仅供参考,不构成医疗、营养或其他专业建议;餐品信息、价格与供应状态以麦当劳官方渠道实时结果为准
  206. ## 九、参赛信息
  207. - 参赛活动:麦当劳程序员创意开发大赛(1024 程序员节)
  208. - 开发工具:腾讯 WorkBuddy
  209. - 参赛声明:[`CONTEST_DECLARATION.md`](CONTEST_DECLARATION.md)
  210. - 本项目为参赛作品,由参赛者独立开发,非麦当劳官方产品
  211. ### 参赛材料对照
  212. | 官方要求 | 本仓库对应文件 |
  213. |---|---|
  214. | 项目介绍 / 安装 / 使用示例 / 目标用户 | 本 `README.md` |
  215. | 参赛声明(官方原文,未改动) | [`CONTEST_DECLARATION.md`](CONTEST_DECLARATION.md) |
  216. | MCP 接入说明(Server / Tool / 调用流程 / 业务价值) | [`MCP_INTEGRATION.md`](MCP_INTEGRATION.md) |
  217. | 脱敏 MCP 配置示例 | [`mcp-config.example.json`](mcp-config.example.json) |
  218. | WorkBuddy 开发对话上下文 | [`workbuddy.md`](workbuddy.md) |
  219. | 技能主文件(Agent 运行时加载) | [`SKILL.md`](SKILL.md) |
  220. | 邀请函产物示例(可直接分享的单文件 HTML) | [`examples/sample_invite.html`](examples/sample_invite.html) |
  221. | 在线演示页(GitHub Pages,免安装免 Token) | [`docs/index.html`](docs/index.html) → [yzg1226.github.io/mcd-party-officer](https://yzg1226.github.io/mcd-party-officer/) |
  222. ---
  223. © 2026 · 本项目为麦当劳程序员创意开发大赛参赛作品

Ratings and comments

Sign in to rate this skill.

Sign in

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