美妆电商购物助手

任务目标

• 本 Skill 用于：完整的电商购物流程
• 能力包含：用户登录、商品搜索、商品详情、加购/立即购买、下单、订单管理、物流查询、收货地址管理
• 触发条件：用户表达购买意图、查询商品、查看订单、管理地址等场景

前置准备

• 用户需先完成短信验证码登录
• 部分接口需要 accessToken 认证

核心流程

一、用户登录

触发时机：用户首次使用或需要下单时

执行步骤：

1. 调用 scripts/auth/send_sms.py <手机号> 发送验证码
2. 智能体提示用户输入验证码
3. 调用 scripts/auth/sms_login.py <手机号> <验证码> 完成登录
4. 登录成功后获取 accessToken 和 refreshToken

测试环境：验证码固定为 111111

二、商品搜索

执行方式：调用脚本

python scripts/goods/search.py --keyword "洗面奶" --page 1 --size 10 --sort PRICE_ASC

参数说明：

• --keyword：搜索关键词
• --page：页码，默认1
• --size：每页数量，默认10
• --sort：排序方式（PRICE_ASC/PRICE_DESC/SALE_DESC）

返回信息：商品列表包含 goodsId、skuId、goodsName、price、thumbnail、storeName 等

三、商品详情

执行方式：调用脚本

python scripts/goods/detail.py <goodsId> <skuId>

返回信息：包含商品详细规格、SKU列表、价格、库存等

四、购物车管理

加购：python scripts/cart/add.py <skuId> <数量> BUY_NOW|CART 查看：python scripts/cart/list.py 数量：python scripts/cart/count.py

五、下单流程

立即购买（单个商品）：

1. add_to_cart：加购（way=BUY_NOW）
2. set_address：设置收货地址
3. preview_order：预览订单确认价格
4. create_order：创建订单获取 trade_sn
5. 返回支付链接

购物车结算（多个商品）：

1. cart_list：查看购物车
2. set_address：设置收货地址
3. preview_order：预览订单
4. create_order：创建订单

六、订单管理

订单列表：python scripts/order/list.py --status UNPAID --page 1 订单详情：python scripts/order/detail.py <orderSn> 取消订单：python scripts/order/cancel.py <orderSn> <原因> 物流查询：python scripts/order/logistics.py <orderSn>

七、收货地址管理

地址列表：python scripts/address/list.py 默认地址：python scripts/address/default.py 解析地址：python scripts/address/resolve.py <省> <市> <区> [街道] 新增地址：python scripts/address/add.py <姓名> <手机> <地址ID路径> <地址名路径> <详细地址> [是否默认] 设为默认：python scripts/address/set_default.py <addressId>

资源索引

认证脚本

商品脚本

购物车脚本

订单脚本