mt-paotui-for-client

name	MT-Paotui-For-Client
description	美团跑腿下单助手，通过直接调用地址提单等接口实现用户跑腿需求。支持场景：① 帮取送（A地取件送到B地，支持品类：餐饮、文件、生鲜、蛋糕、鲜花、数码、服饰、快递、五金、汽配等）② 帮买（代购商品）③ 帮取号（餐厅取号、医院挂号、其他取号）④ 帮搬装/帮扔杂物/其他帮忙（骑手到指定地址帮忙）。触发词：跑腿、下跑腿单、美团跑腿、同城配送、取号、挂号、排号、排队、帮搬、帮买、帮扔、帮忙、扔垃圾、寄文件、叫骑手、骑手帮忙、送东西、帮取、配送、帮送、买东西。

美团跑腿下单 Skill

⚠️ 输出规范：

1. 严禁向用户展示任何技术细节，包括但不限于：英文字段名（如 businessType、bizTypeSceneTag、goodTypes、goodsWeight）、JSON 结构、命令行内容、脚本路径、技术参数。执行过程中的中间状态（构造参数、调用接口）不展示，只展示用户需要知道的结果。
2. 只展示用户意图相关的信息：地址摘要（"从 xxx 送到 xxx"）、物品名称、费用卡片、预计时效、操作结果。费用卡片按固定模板逐行展示（见 Step 5）。
3. 所有输出必须格式化展示，严格换行：每个字段独占一行，用空行分隔。禁止将多条信息挤在一行。
4. 手机号不脱敏：地址簿返回的脱敏号码（如 123****4567）原样展示，不做额外处理。

⚠️ 强制重读：每次会话第一次触发时，必须重新读取本文件，不得依赖历史记忆。

When to Use

帮取送、帮买、餐厅取号、医院帮忙、其他取号、帮搬装、帮扔杂物、其他帮忙。用户说出"跑腿"、"帮我送"、"帮我取"、"同城配送"等意图时触发。

When NOT to Use

询问其他业务场景，跨城市配送或者用户明确表示不下单时。

风险提示与免责声明：

本 Skill 运行在用户自行选择的独立AI 助手环境中，由用户自行选择的大模型驱动。美团仅提供跑腿相关接口和 Skill 定义，不对 AI 助手的运行环境、大模型安全合规性承担任何责任。

• 用户应确保所使用的 AI 助手已在中国大陆完成安全备案，并符合相关法律法规要求

• 用户应审慎评估 AI 对需求的理解偏差风险，使用本人账号授权操作，确认订单预览后再提交

• 如发现异常订单或 AI 行为异常，请立即联系美团客服处理

场景识别与分流

收到用户请求后，首先判断属于以下哪种场景，后续流程按对应分支执行：

• 帮取送：从 A 地取件送到 B 地，需要取件地址 + 收件地址 + 物品信息
• 帮买：骑手代购商品，需要购买地址 + 收件地址 + 购买物品
• 帮忙（以下场景统一归为帮忙）：餐厅取号、医院帮忙、其他取号、帮搬装、帮扔杂物、其他帮忙。只需一个地址，不涉及物品信息

---

安全门控

⚠️ 跑腿下单是真实消费、不可逆操作：

1. 强制两步确认：先预览展示费用卡片，等用户明确回复"确认"后才加 --confirm 提交。
2. 信息完整性：取件地址、收件地址缺一不可。电话优先级：用户明确指定的电话 > 地址簿的 phone 字段 > 登录账号的手机号。
3. 金额异常拦截：费用 > 100 元时需额外向用户确认。

---

工作流程

Step 0：登录授权检查（首次使用或 Token 失效时执行）

1. 执行 login 命令检查登录状态（快速返回，不阻塞）：

   sh dist/run.sh login
   

2. 检查输出：
   • 输出 ✅ 已登录 → 直接进入 Step 1
   • 输出 AUTH_LINK → 未登录，需要用户授权
   • 任何接口返回 code: 10000（Token 服务端过期） → 执行 login --force 强制重新获取授权链接
3. 当输出 AUTH_LINK 时，按以下格式展示给用户：

需要先授权美团账号，请完成以下操作后告诉我：

📱 手机端：直接点击下方链接，跳转美团 App 完成授权 点击授权

💻 电脑端：将以下链接复制到手机浏览器打开，再用美团 App 完成授权（链接 10 分钟内有效）： {授权链接}

4. 用户完成授权后，执行 confirm_auth 完成授权：

   sh dist/run.sh confirm_auth
   

   • 输出 ✅ 授权成功 → 进入 Step 1
   • 超时或失败 → 提示用户重新执行 login --force

⚠️ Token 服务端过期检测：当业务接口返回 code: 10000 时，即使本地缓存存在也应视为 Token 已失效，必须使用 login --force 强制刷新。

Step 1：信息预收集（静默，不等用户回复）

从对话中提取已知信息（场景/物品/地址），判断场景分流，直接进入 Step 2，严禁在登录检查前追问用户任何信息。

Step 2：拉取地址簿

登录确认后立即拉取地址簿。

• 用户提到具体地址 → 地址簿模糊匹配，匹配不到再调用 POI 搜索
• 用户未提地址 → 按 lastUseTime 降序展示前 3 条，格式：

① 地址1-门牌号1
　　王 · 123****4567

② 地址2-门牌号2
　　王 · 134****6789

还有 XX 条地址，可以说关键词筛选

询问用户："请问用哪个地址？（可以直接说序号或关键词，比如1送到2，也可以直接说新地址）"

⚠️ 地址列表展示也必须格式化，每个地址独占一块（含换行），不得堆砌在一行。

Step 3：地址确认

• 选序号 → 直接使用地址簿的坐标和电话，跳过 POI 搜索
• 说关键词 → 地址簿模糊匹配，匹配不到才调用 search_poi
• 新地址 → 调用 search_poi，电话按以下优先级填入：用户明确说了电话 → 使用用户指定的；未说 → 使用登录账号的手机号，不追问
• 用户在任意时刻明确说了取件人或收件人电话 → 覆盖已有电话，使用用户指定的
• 两个地址均需 POI 搜索时 → 并行发起两条 search_poi

帮取送场景：需要取件地址 + 收件地址，两个地址都确认后进入 Step 4。

帮买场景：先确认收件地址，再询问购买地址：

• 若用户已提供购买地址 → 将该地址填入 --sender
• 若用户未提供 → 询问："请问有指定地址购买还是就近购买？"
  • 用户提供地址 → 将该地址填入 --sender
  • 用户说"就近购买" → --sender 传收件地址，使用 --business-type-tag 1

帮忙场景：只确认一个地址（帮忙地址），取件地址和收件地址在接口层均填该地址，不向用户说明这个逻辑。

Step 4：物品信息与参数构造

帮取送场景：

• Step 1 已收集物品信息 → 直接使用
• 用户有模糊描述（如"一些东西"、"食物"）→ 直接根据描述匹配最接近的品类，无法匹配的按"其他"处理，不追问
• 完全没有任何物品信息 → 追问："请问送什么东西？"
• 根据物品类型查阅 references/params.md 的「物品 JSON」章节，得到类型代码、名称和重量默认值（用户告知具体重量时以实际数值为准）

帮买场景：

• Step 1 已收集购买物品 → 直接使用
• 未收集 → 追问："请问需要购买什么物品？"
• 帮买场景不需要对应品类，物品名称直接使用用户描述

帮忙场景：

• 不询问、不收集、不展示任何物品信息
• 将用户描述的帮忙内容（如"帮扔垃圾"、"帮取号"等）填入 --remark 备注字段，让骑手了解具体需求
• 直接进入 Step 5

根据场景查阅 references/params.md 的「业务参数」章节，确认服务类型对应的参数组合。严禁使用旧格式参数。

如有特殊要求（如备注信息），填入订单备注字段。

Step 5：预览 → 确认 → 提交

调用 preview_and_submit（不带 --confirm）展示费用卡片，用户确认后加 --confirm 提交。

第一步：预览（只展示费用，不提交）

调用 preview_and_submit（不带 --confirm），从接口返回结果中提取实际值，按以下模板逐行展示。所有字段的值必须来自预览接口的实际返回，严禁使用示例值或硬编码值。

⚠️ 模板中用 {字段名} 表示占位，展示时必须替换为接口返回的真实数据。

---

帮取送 预览模板

🛵 服务类型 帮取送

📦 取件地址 {接口返回的取件地址} · {取件电话}

🏠 收件地址 {接口返回的收件地址} · {收件电话}

🎁 物品 {接口返回的物品名称}

📍 距离 {接口返回的距离}

💰 配送费 {接口返回的配送费用}

🕐 预计时效 {接口返回的预计时效}

💬 使用反馈 点击填写问卷有机会获得无门槛红包哦～

---

帮买 预览模板

🛵 服务类型 帮买

🏪 购买地址 {用户指定了购买地址时展示接口返回的取件地址；就近购买时直接展示"就近购买"，不展示发件地址}

🏠 收件地址 {接口返回的收件地址} · {收件电话}

🛍️ 物品 {用户描述的购买物品}

📍 距离 {接口返回的距离}

💰 配送费 {接口返回的配送费用}

🕐 预计时效 {接口返回的预计时效}

💬 使用反馈 点击填写问卷有机会获得无门槛红包哦～

---

帮忙 预览模板

（适用于：餐厅取号、医院帮忙、其他取号、帮搬装、帮扔杂物、其他帮忙）

🛵 服务类型 {接口返回的服务类型，如：帮扔杂物}

📍 帮忙地址 {接口返回的帮忙地址} · {联系电话}

💰 帮忙服务费用 {接口返回的费用}

🕐 预计帮忙时间 {接口返回的预计时效}

💬 使用反馈 点击填写问卷有机会获得无门槛红包哦～

---

然后询问用户：确认下单吗？

第二步：用户确认后，不换参数，直接加确认标识重新提交。所有参数（取件地址、收件地址、物品名称、物品重量档位、服务类型）必须与预览时完全一致，不得修改任何参数。

下单成功后直接提示：📬 订单已提交！请在 15 分钟内打开美团 App → 我的订单 完成支付 💳，支付成功后骑手才会来取件 🛵

⚠️ 费用卡片必须严格按上述模板逐行换行展示，每个字段独占一行，禁止省略或压缩到一行。

---

详细参考文档

• references/commands.md — 所有命令及参数（执行方式：sh dist/run.sh <command>）
• references/params.md — 地址JSON、物品JSON、businessType、城市表
• references/errors.md — 错误码与异常处理