- name
- order-tracker
- description
- Track and manage sales orders with status updates, notifications, and dashboard reporting. Supports order creation, status transitions (pending/confirmed/shipped/delivered), email/Discord notifications, and order history visualization. Use when you need to monitor order fulfillment, send shipping updates to customers, or generate order analytics.
Order Tracker Skill
Description
本地订单跟踪系统，提供手动订单状态管理、客户邮件通知和命令行看板功能。适用于 Farreach Electronic 外贸订单生命周期管理（从生产到交付），无需对接工厂 ERP 或物流 API。
When to Use
- 查询某个订单的当前状态
- 更新订单状态（生产中 → 待发货 → 已发货 → 已完成）
- 向客户发送订单状态变更邮件通知
- 查看所有在途订单的看板汇总
- 检测逾期或紧急（≤7 天）订单
Prerequisites
- Node.js v16+
- 已配置
imap-smtp-emailskill 的 SMTP.env文件（用于发送通知邮件） - 依赖安装：
npm install（在 skill 目录下执行）
Skills Directory
skills/order-tracker/
How to Invoke
All scripts are run from the scripts/ subdirectory.
1. View Order Dashboard
cd skills/order-tracker/scripts
# 查看所有订单（按状态分组）
node order-dashboard.js
# 按状态过滤
node order-dashboard.js --status in_production
node order-dashboard.js --status shipped
# 查看单个订单详情
node order-dashboard.js --order-id ORD-20260324-001
# 输出格式（table / compact / json）
node order-dashboard.js --format json2. Update Order Status
cd skills/order-tracker/scripts
# 预览（dry-run，不写入）
node update-order-status.js --order-id ORD-20260324-001 --status ready_to_ship --dry-run
# 更新状态
node update-order-status.js \
--order-id ORD-20260324-001 \
--status shipped \
--notes "DHL Express, 单号: 1234567890, ETA: 4月25日"
# 更新状态 + 标记需要发通知
node update-order-status.js \
--order-id ORD-20260324-001 \
--status in_production \
--notes "工厂已排期" \
--trigger-notification3. Send Customer Notification Email
cd skills/order-tracker/scripts
# 预览邮件（不发送）
node send-order-notification.js --order-id ORD-20260324-001 --dry-run
# 发送通知（使用订单当前状态的邮件模板）
node send-order-notification.js --order-id ORD-20260324-001
# 指定状态模板发送
node send-order-notification.js --order-id ORD-20260324-001 --status shippedOrder Status Model
6 状态机：
pending_production → in_production → ready_to_ship → shipped → completed
↘ cancelled（任意阶段可取消）| 状态 | 中文 | 说明 |
|---|---|---|
pending_production | 待生产 | 订单确认，等待生产 |
in_production | 生产中 | 工厂生产中 |
ready_to_ship | 待发货 | 生产完成，等待发货 |
shipped | 已发货 | 货物已发出 |
completed | 已完成 | 客户确认收货 |
cancelled | 已取消 | 订单取消 |
Email Templates
通知脚本支持 5 种双语（EN/ZH）邮件模板：
in_production— 生产进度通知ready_to_ship— 准备发货通知shipped— 发货确认（含物流单号）completed— 订单完成确认cancelled— 取消通知
Typical Workflow Example
BASE=skills/order-tracker/scripts
ORDER=ORD-20260324-001
# 开始生产 + 通知客户
node $BASE/update-order-status.js --order-id $ORDER --status in_production --notes "工厂已排期"
node $BASE/send-order-notification.js --order-id $ORDER
# 发货 + 通知客户
node $BASE/update-order-status.js --order-id $ORDER --status shipped --notes "DHL 单号: 1234567890"
node $BASE/send-order-notification.js --order-id $ORDER
# 查看看板
node $BASE/order-dashboard.jsData Files
| 文件 | 路径 | 说明 |
|---|---|---|
| 订单数据 | data/orders.json | 所有订单（手动维护） |
| 订单 Schema | config/order-schema.json | JSON Schema 验证定义 |
| 状态变更日志 | logs/status-changes.log | 每次状态更新记录 |
| 通知日志 | logs/notifications.log | 邮件发送记录 |
Constraints
- 不对接工厂 ERP/MES 系统
- 不抓取物流 API
- 状态手动更新
- 数据存储本地 JSON 文件
Source
- Task: task-005（Phase 3）
- Implemented by: IRON (bailian/qwen3.5-plus)
- Reviewed by: WILSON (aiberm/claude-sonnet-4-6)
- Completed: 2026-03-24