Order Tracker Skill

---

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

Prerequisites

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 json

2. 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-notification

3. 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 shipped

Order 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）邮件模板：

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.js

Data Files

| 文件 | 路径 | 说明 |

|------|------|------|

| 订单数据 | `data/orders.json` | 所有订单（手动维护） |

| 订单 Schema | `config/order-schema.json` | JSON Schema 验证定义 |

| 状态变更日志 | `logs/status-changes.log` | 每次状态更新记录 |

| 通知日志 | `logs/notifications.log` | 邮件发送记录 |

Constraints

Source