mtpaotui

SKILL.md

---
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. 调用接口检查 Token 是否有效
2. 检查结果：
   - **Token 有效** → 直接进入 Step 1
   - **需要授权** → 执行下方授权流程
3. 获取授权链接后，按以下格式展示（**不展示二维码**）：

> 需要先授权美团账号，请完成以下操作后告诉我：
>
> 📱 **手机端**：直接点击下方链接，跳转美团 App 完成授权
> [点击授权]({授权链接})
>
> 💻 **电脑端**：将以下链接复制到手机浏览器打开，再用美团 App 完成授权（链接 5 分钟内有效）：
> `{授权链接}`

4. 等待用户确认完成授权（用户回复"已授权"、"好了"、"完成了"等）
5. 轮询授权状态
   - 成功 → 提示"✅ 授权成功"，继续进入 Step 1
   - 超时或失败 → 提示用户重新触发，流程结束

> ⚠️ 授权轮询等待时间约 3~10 秒（取决于用户操作速度），无需人工干预。授权码有效期 600 秒。

**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。

**帮买场景**：先确认收件地址，再询问购买地址：
- 若用户已提供购买地址 → 将该地址填入取件地址
- 若用户未提供 → 询问："请问有指定地址购买还是就近购买？"
  - 用户提供地址 → 将该地址填入取件地址
  - 用户说"就近购买" → 取件地址填收件地址

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

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

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

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

**帮忙场景**：
- **不询问、不收集、不展示任何物品信息**，直接进入 Step 5

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

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

**Step 5：预览 → 确认 → 提交**

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

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

返回后按以下模板逐行展示，**不展示任何命令或字段名**，每行之间用空行分隔：

---

### 帮取送 预览模板

🛵 **服务类型** 帮取送

📦 **取件地址** 完整地址 · 取件电话

🏠 **收件地址** 完整地址 · 收件人 收件电话

🎁 **物品** 查询匹配的标准品类

📍 **距离** 如 `4.6公里`

💰 **配送费** 如 `14.0 元`

🕐 **预计时效** 如 `预计 1 分钟内有骑手接单，21:16 送达`

💬 **使用反馈** [点击填写问卷有机会获得无门槛红包哦～](https://v.wjx.cn/vm/mBfHfGS.aspx#)

---

### 帮买 预览模板

🛵 **服务类型** 帮买

🏪 **购买地址** xxx地址 / 就近购买

🏠 **收件地址** 完整地址 · 收件人 收件电话

🛍️ **物品** 用户描述的购买物品

📍 **距离** 如 `4.6公里`

💰 **配送费** 如 `14.0 元`

🕐 **预计时效** 如 `预计 1 分钟内有骑手接单，21:16 送达`

💬 **使用反馈** [点击填写问卷有机会获得无门槛红包哦～](https://v.wjx.cn/vm/mBfHfGS.aspx#)

---

### 帮忙 预览模板

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

🛵 **服务类型** 餐厅取号 / 医院帮忙 / 其他取号 / 帮搬装 / 帮扔杂物 / 其他帮忙（根据实际场景选择对应类型填写）

📍 **帮忙地址** 完整地址 · 联系电话

💰 **配送费** 如 `14.0 元`

🕐 **预计时效** 如 `预计 1 分钟内有骑手接单，21:16 送达`

💬 **使用反馈** [点击填写问卷有机会获得无门槛红包哦～](https://v.wjx.cn/vm/mBfHfGS.aspx#)

---

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

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

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

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

---

## 详细参考文档

- [references/commands.md](references/commands.md) — 所有命令及参数（执行方式：`node scripts/paotui.js <command>`）
- [references/params.md](references/params.md) — 地址JSON、物品JSON、businessType、城市表
- [references/errors.md](references/errors.md) — 错误码与异常处理