# Logistics Tracking

> 当用户询问物流运输、快递追踪、清关进度或预计到达时间时使用此技能。支持实时物流追踪和物流异常预警。

- Skill: `gabrielmoreira/logistics-tracking` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/logistics-tracking`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/logistics-tracking/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/logistics-tracking

---


# 物流追踪技能

## 概述

提供跨境物流的实时追踪服务，包括多承运商追踪、海关清关状态和到达时间预估。

## 适用范围

本技能指导主 Agent 处理**单订单物流查询**：
- ✅ 查询单个订单的实时物流状态和轨迹
- ✅ 回答"我的包裹到哪了"、"什么时候到"
- ✅ 识别单个订单的物流异常并给出建议
- ✅ 展示单个订单的多段物流进度

以下场景请委派给 `logistics-specialist` 子智能体：
- ❌ 多个订单的物流时效对比（如"我最近5个订单哪个最快"）
- ❌ 跨订单物流异常根因分析（如"为什么我的货总是卡在清关"）
- ❌ 生成完整的物流时效报告或承运商评估

## 边界判断

- "ORD001 到哪了" → 单次查询，**主Agent自行处理**
- "帮我查一下 ORD001 和 ORD002 的物流" → 分别查即可，**主Agent自行处理**
- "对比顺丰和DHL这几个订单的时效表现" → 需要聚合分析，**委派 logistics-specialist**

## 使用工具

本技能使用 `query_shipping_info` 工具，传入订单编号获取运单号、承运商、物流状态、清关进度和轨迹记录。

## 使用指引

### 1. 判断追踪场景

- **实时追踪**：用户想知道当前位置/状态 → 使用 `query_shipping_info` 工具
- **到达预估**：用户问"什么时候到" → 根据物流数据计算
- **异常预警**：货物延迟或滞留 → 主动提醒
- **清关状态**：海关通关进度 → 从物流轨迹中提取

### 2. 多段物流处理

跨境运输通常有多个段落：
1. **国内揽收**（产地仓库 → 出发港口）
2. **国际运输**（海运/空运）
3. **目的国清关**（海关查验放行）
4. **末端派送**（本地快递 → 买家地址）

始终识别货物当前处于哪个段落。

### 3. 异常检测与主动预警

自动标记以下情况：
- 物流信息超过 5 天未更新
- 清关超过 3 个工作日未放行
- 派送失败（无人签收）
- 超过预计到达日期仍未送达

检测到异常时：
- 解释可能原因（如海关扣留、天气延误）
- 建议后续操作（联系承运商、补充文件）
- 主动提出发送邮件通知相关方

### 4. 响应格式

```
📦 物流追踪 — 订单 {order_no}
━━━━━━━━━━━━━━━━━━━━━━
🚢 承运商: {carrier} | 运单号: {tracking_no}
📍 当前状态: {status}
📅 预计到达: {eta}

物流轨迹:
  ✅ 2024-01-15 出库发货（深圳仓库）
  ✅ 2024-01-16 到达港口（深圳蛇口港）
  🔄 2024-01-18 海运中（预计7天）
  ⏳ 待清关（洛杉矶港）
  ⏳ 待派送
```

### 5. 卖家专属功能

- 展示待发货订单列表
- 批量物流状态概览
- 承运商时效对比分析