技能介绍

要解决什么问题

在 Agent 里帮用户叫同城配送，难点不在「调一个下单接口」，而在整条链路：先授权、再解析双端地址、询价选渠道、支付、发单，以及后续的订单状态、骑手轨迹和撤单。海博田（HBT）业务走官方网关（pre-hbtai.hiboos.com / hbtai.hiboos.com），请求需带 X-Auth-Token，订单阶段与字段还要和询价、支付共用同一套台账。

本技能是路由总纲：只做意图识别、分发到子 SKILL，并执行统一的公共防御；具体规则在 references/auth.md、inquiry.md 等各子文档和对应 scripts/hbt_*.js 里实现。

技能如何工作

收到用户话术后，按关键词进入子流程（未授权则强制先走授权）：

授权：手机号登录 / token，详见 references/auth.md，CLI authorize / check_auth
询价：运费、配送费 → hbt_inquiry.js / price_inquiry
支付：收款、支付链接 → hbt_payment.js / prepare_payment
发单：支付完成后的下单 → hbt_create_order.js / create_order
查单 / 骑手 / 取消：订单详情、轨迹、撤单 → 对应子 SKILL 与 get_order_detail、rider_track、cancel_order

统一入口为 Node.js 18+ 的 scripts/hbt_delivery.js；接口调用会从台账读取 authToken 写入请求头。订单持久化在 references/orderInfo.md（脚本维护，勿手改），字段包括 orderNo、hbtOrderId、stage（inquiry / created）、收发件人六槽位、状态与运费等。

公共约束（优先级最高）：六个地址/联系人槽位缺一必须追问，禁止匿名或空串兜底；掩码手机号返回 MASKED_PHONE 须索要完整 11 位；查询/轨迹/取消用的 hbtOrderId 必须是发单接口返回的海博田订单号；终态（orderStatus 99 取消、100 完成）拦截详情/轨迹/取消，回复 ORDER_TERMINATED。

适用边界与注意点

意图模糊时须对话澄清，严禁自动猜分支。
Token 有效期 24 小时，过期需重新授权（AUTH_EXPIRED / AUTH_FAILED）。
不向用户暴露鉴权参数、脚本路径或原始 JSON；业务错误与 HTTP 异常有统一话术表（如 API_ERROR、ORDER_NOT_EXIST）。
子 SKILL、API 参考见 references/hbt-api-reference.md；授权状态存于 references/auth_token.json。

截图预览

使用场景

顾客在对话里给出取件、送件地址，你要先走询价子流程，列出各配送渠道运费供其选定后再进入支付。
用户已完成支付并说「帮我寄/发单」，需用台账中的 orderNo、运费与渠道调用 create_order，并把返回的 hbtOrderId 写入 orderInfo。
用户追问「订单到哪一步了」或「骑手在哪」，须用发单成功后的海博田订单号查详情或骑手轨迹，终态订单则按 ORDER_TERMINATED 说明无需再操作。
发单后用户临时改主意要撤单，在订单未完成、未取消前走 cancel 子流程；若只给了渠道业务单号需提示改用 hbtOrderId。

适合人员

同城门店或前台人员，在 IM/Agent 里代客补齐收发件六要素、完成授权后询价、发支付链接并跟进发单。
对话机器人实施工程师，需按 SKILL 意图表挂载 auth、inquiry、payment、create-order 等子 SKILL 与 hbt_delivery.js CLI。
自研助手的产品/运营，要把「授权前置、禁止默认槽位、掩码手机号拦截」写成可验收的对话规范。
处理配送咨询的客服，需在不说鉴权参数与原始 JSON 的前提下查单、看骑手轨迹并引导重新授权（24 小时 token）。