@besile/scm-cli 2026.3.29 → 2026.3.30

package/README.zh.md

@@ -2,6 +2,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D14-blue.svg)](https://nodejs.org/)
+[![npm version](https://img.shields.io/npm/v/@besile/scm-cli.svg)](https://www.npmjs.com/package/@besile/scm-cli)
 
 供应链管理（SCM）系统 CLI 工具 — 在终端中查询大货生产订单、物料订单和 QC 质检订单，对接飞书身份认证系统。
 
@@ -36,25 +37,22 @@
 
 以下两种方式**任选其一**：
 
-**方式一 — 从源码安装（推荐）：**
+**方式一 — 从 npm 安装（推荐）：**
 
 ```bash
-git clone <your-repo-url>
-cd scm-cli
-./install.sh
+# 安装 CLI
+npm install -g @besile/scm-cli
+
+# 安装 CLI SKILL（必需，AI Agent 调用时需要）
+npx skills add @besile/scm-cli -y -g
 ```
 
-**方式二 — 手动安装：**
+**方式二 — 从源码安装：**
 
 ```bash
-# 克隆项目
-git clone <your-repo-url>
+git clone git@home.cogo.club:xubinghua/scm-cli.git
 cd scm-cli
-
-# 安装依赖
 npm install
-
-# 链接到全局
 npm link
 ```
 
@@ -442,6 +440,19 @@ npm run test:watch
 npm run test:coverage
 ```
 
+## 发布
+
+```bash
+# 1. 升级版本号（patch / minor / major）
+npm version patch   # e.g. 2026.3.29 → 2026.3.30
+
+# 2. 发布到 npm
+npm publish
+
+# 发布后验证
+npm view @besile/scm-cli
+```
+
 ## 贡献
 
 欢迎提交 Issue 或 Pull Request！对于较大的改动，建议先通过 Issue 讨论。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@besile/scm-cli",
-  "version": "2026.3.29",
+  "version": "2026.3.30",
   "description": "SCM CLI — Supply Chain Management CLI Tool",
   "type": "module",
   "license": "MIT",
@@ -10,7 +10,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/wfs/scm-cli"
+    "url": "git@home.cogo.club:xubinghua/scm-cli.git"
   },
   "keywords": [
     "scm",
@@ -22,11 +22,16 @@
   "files": [
     "bin/",
     "src/",
+    "skills/",
     "index.d.ts"
   ],
   "bin": {
     "scm-cli": "./bin/scm-cli.js"
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
   "exports": {
     ".": {
       "import": "./src/internal/index.js",

package/skills/login/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: scm-login
+description: |
+  SCM 供应链管理系统的用户登录认证。先检查 Token 缓存，如果有则直接返回；如果没有则执行 CLI 命令登录。Token 会自动缓存和刷新。
+
+  **当以下情况时使用此 Skill**：
+  (1) 用户需要登录 SCM 系统
+  (2) 用户查询订单时提示 Token 过期
+  (3) 用户首次使用 SCM 功能
+  (4) 用户提到"登录"、"认证"、"Token"、"会话"等相关词汇
+compatibility:
+  - cli
+---
+
+# SCM 登录认证 Skill
+
+## 功能说明
+
+此 skill 用于登录 SCM 供应链管理系统。**优先检查 Token 缓存**，如果有缓存且有效的 Token 则直接返回，无需重新登录；如果没有或已过期，才调用 CLI 命令进行登录。
+
+## 执行流程
+
+```
+1. 检查 Token 缓存 → scm-cli auth token show <openId>
+   ↓
+2. 判断结果
+   ├── 有有效 Token → 直接返回 Token 信息
+   └── 无 Token 或已过期 → 执行 CLI 登录
+```
+
+## CLI 命令
+
+### 检查 Token 缓存
+
+```bash
+scm-cli auth token show <openId>
+```
+
+**输出示例**：
+```
+Token 信息：
+- 用户: 张三
+- User ID: 12345
+- 有效期至: 2026-04-30 14:30:00
+- 状态: ✅ 有效
+```
+
+### 执行登录
+
+```bash
+scm-cli auth login --openId <openId> --mobile <mobile> --password <password>
+```
+
+## 使用场景
+
+### 场景 1: Token 已存在（直接返回）
+
+**用户输入**：
+```
+登录 SCM 系统
+```
+
+**处理步骤**：
+1. 执行 `scm-cli auth token show <openId>` 检查缓存
+2. 如果 Token 存在且有效，直接返回
+
+**返回结果**：
+```
+✅ 您已登录 SCM 系统
+用户: 张三
+User ID: 12345
+Token 有效期至: 2026-04-30 14:30:00
+```
+
+### 场景 2: Token 不存在或已过期（执行登录）
+
+**用户输入**：
+```
+登录 SCM 系统，手机号 13800138000，密码 xxxxxx
+```
+
+**处理步骤**：
+1. 执行 `scm-cli auth token show <openId>` 检查缓存 → 无效或不存在
+2. 执行 `scm-cli auth login --openId <openId> --mobile 13800138000 --password xxxxxx`
+3. 返回登录结果
+
+**返回结果**：
+```
+✅ 登录成功！
+用户: 张三
+User ID: 12345
+Open ID: ou_xxxxx
+Token 已缓存
+```
+
+### 场景 3: Token 过期
+
+**用户输入**：
+```
+查询我的生产订单
+```
+
+**返回错误**：
+```
+Token 已过期，请重新登录
+```
+
+**处理步骤**：
+1. 提示用户需要重新登录
+2. 询问用户的手机号和密码
+3. 执行 CLI 命令重新登录
+4. 登录成功后，继续执行用户的查询请求
+
+## 行为规则
+
+- **优先检查**：使用前先检查 Token 缓存，避免重复登录
+- **Token 管理**：登录成功后，Token 自动缓存到 `~/.scm_cache/user_tokens.json`
+- **多用户支持**：通过 openId 区分不同用户，每个用户的 Token 独立管理
+- **自动刷新**：Token 会在过期前自动刷新
+- **密码安全**：密码使用 AES-128-CBC 加密存储，不会明文保存
+
+## 返回值示例
+
+**Token 有效（直接返回）**：
+```
+✅ 您已登录 SCM 系统
+用户: 张三
+User ID: 12345
+Token 有效期至: 2026-04-30 14:30:00
+```
+
+**新登录成功**：
+```
+✅ 登录成功！
+用户: 张三
+User ID: 12345
+Open ID: ou_xxxxx
+Token 已缓存
+```
+
+**登录失败**：
+```
+❌ 登录失败: 手机号或密码错误
+```
+
+## 注意事项
+
+1. **openId 获取**：openId 通常通过飞书消息上下文自动获取，无需用户手动提供
+2. **密码安全**：用户密码不会明文存储，系统使用 AES 加密保护
+3. **Token 时效**：Token 有时效限制（默认 12 小时），过期后需要重新登录
+4. **多设备登录**：同一用户可以在多个设备登录，Token 独立管理
+5. **CLI 路径**：确保 `scm-cli` 命令在 PATH 中可用

package/skills/material-orders/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: material-orders
+description: |
+  查询 SCM物料订单信息。物料订单是大货生产过程中的原材料、辅料等物料的采购订单。支持多维度筛选：订单号、款号、批次、状态、供应商、仓库等。需先登录 SCM。当用户需要查询物料订单相关信息时，无论使用什么表述方式，都应该触发此 skill。
+compatibility:
+  - cli
+---
+
+# SCM 物料订单查询 Skill
+
+## 功能说明
+
+此 skill 用于查询 SCM 系统中的物料订单。物料订单是指大货生产过程中需要的原材料、辅料、包材等物料的采购订单。用户需要先登录 SCM 系统，获取有效的 Token 后才能使用此功能。
+
+## CLI 命令调用
+
+此 skill 通过执行 `scm-cli material-orders` CLI 命令来执行查询操作。
+
+### 命令格式
+
+```bash
+scm-cli material-orders --openId <openId> [选项...]
+```
+
+### CLI 参数说明
+
+**必填参数：**
+- `--openId <openId>`: 飞书用户 openId（用于获取对应用户的 Token）
+
+**可选参数（筛选条件）：**
+
+#### 分页参数
+- `--pageNo <pageNo>`: 页码，从 1 开始（默认: 1）
+- `--pageSize <pageSize>`: 每页条数，最大 100（默认: 20）
+
+#### 订单状态参数
+- `--status <status>`: 物料订单状态：0-待采购 | 1-采购中 | 2-部分到货 | 3-已到货 | 4-已取消
+- `--cooperationMode <mode>`: 合作模式：0-CMT | 1-FOB
+
+#### 商品信息参数
+- `--goodsFullCode <code>`: 大货款号
+- `--goodsBatch <batch>`: 大货批次
+- `--goodsType <type>`: 大货类型：0-首单 | 1-加单 | 2-翻单
+- `--orderNo <no>`: 物料订单号
+
+#### 供应商参数
+- `--supplierName <name>`: 供应商名称
+
+#### 人员参数
+- `--purchaserIdList <ids>`: 采购员 ID 列表（逗号分隔）
+- `--pdUserIdList <ids>`: PD 用户 ID 列表（逗号分隔）
+- `--designerName <name>`: 设计师名称
+
+#### 时间参数
+- `--type <type>`: 时间查询类型：0-大货上市时间 | 1-商品下单时间 | 2-合同交期时间 | 3-调整到货时间 | 4-订单关单时间 | 5-生产下单时间 | 6-工厂接单时间 | 7-计划到货时间 | 8-实际到货时间 | 9-需求到货时间
+- `--startTime <time>`: 开始时间（ISO 8601 格式）
+- `--endTime <time>`: 结束时间（ISO 8601 格式）
+
+#### 输出格式
+- `--format <format>`: 输出格式，table|json（默认: table）
+
+**可选全局参数：**
+- `-v, --verbose`: 显示详细日志
+
+## 使用步骤
+
+1. **检查登录状态**：确认用户已登录（执行过 `scm-cli auth login`）
+2. **构造查询参数**：根据用户的查询需求，构造相应的筛选条件
+3. **执行 CLI 命令**：执行 `scm-cli material-orders --openId <openId> [选项...]` 命令
+4. **处理结果**：将查询结果以友好的方式呈现给用户
+
+## 行为规则
+
+- **简洁响应**：查询结果必须简洁明了
+- **无数据处理**：当查询结果为空时，直接返回"没有查询到该数据"
+- **避免冗余**：不重复询问已提供的信息，不添加不必要的解释
+- **登录检查**：使用前需确认用户已登录
+
+## 示例
+
+### 示例 1：查询特定物料订单
+
+**用户输入**：
+```
+查询物料订单，订单号：MO2026030001
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli material-orders --openId ou_xxxxx --orderNo MO2026030001
+```
+
+**助手响应**（如果有数据）：
+```
+找到物料订单信息：
+- 订单号：MO2026030001
+- 大货款号：FESTHLFJWTS223W4
+- 物料名称：棉布
+- 供应商：XXX纺织厂
+- 订单状态：生产中
+```
+
+### 示例 2：按供应商查询
+
+**用户输入**：
+```
+查询供应商"XXX纺织厂"的所有物料订单
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli material-orders --openId ou_xxxxx --supplierName "XXX纺织厂"
+```
+
+**助手响应**：
+```
+找到 3 条物料订单：
+1. [订单摘要...]
+2. [订单摘要...]
+3. [订单摘要...]
+```
+
+### 示例 3：无数据
+
+**用户输入**：
+```
+查询订单号为 "NONEXISTENT" 的物料订单
+```
+
+**助手响应**：
+```
+没有查询到该数据
+```
+
+## 与生产订单的区别
+
+| 订单类型 | 说明 | CLI 命令 |
+|----------|------|----------|
+| **生产订单** | 大货生产订单，包含款号、批次、供应商生产进度等 | `scm-cli production-orders` |
+| **物料订单** | 原材料、辅料、包材等物料采购订单 | `scm-cli material-orders` |
+| **QC 订单** | 质检订单，用于质量检验流程 | `scm-cli qc-orders` |
+
+## 注意事项
+
+1. **登录要求**：使用此功能前必须先执行 `scm-cli auth login` 登录
+2. **参数灵活使用**：筛选条件为可选，根据用户需求灵活组合
+3. **响应格式**：CLI 默认以表格形式输出，支持 `--format json` 输出 JSON 格式
+4. **空结果处理**：如果查询结果为空，直接返回"没有查询到该数据"
+5. **CLI 路径**：确保 `scm-cli` 命令在 PATH 中可用

package/skills/production_orders/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: production_orders
+description: 查询SCM大货生产订单。支持多维度筛选：款号、批次、状态、时间范围等。需先登录 SCM。当用户需要查询生产订单信息时，无论使用什么表述方式，都应该触发此 skill。
+compatibility:
+  - cli
+---
+
+# SCM 大货生产订单查询 Skill
+
+## 功能说明
+
+此 skill 用于查询 SCM 系统中的大货生产订单，支持多维度筛选条件。用户需要先登录 SCM 系统，获取有效的 Token 后才能使用此功能。
+
+## CLI 命令调用
+
+此 skill 通过执行 `scm-cli production-orders` CLI 命令来执行查询操作。
+
+### 命令格式
+
+```bash
+scm-cli production-orders --openId <openId> [选项...]
+```
+
+### CLI 参数说明
+
+**必填参数：**
+- `--openId <openId>`: 飞书用户 openId（用于获取对应用户的 Token）
+
+**可选参数（筛选条件）：**
+
+#### 分页参数
+- `--pageNo <pageNo>`: 页码，从 1 开始（默认: 1）
+- `--pageSize <pageSize>`: 每页条数，最大 100（默认: 20）
+
+#### 订单状态参数
+- `--prodStatus <status>`: 大货生产订单状态：-1-全部 | 0-待确定 | 1-待同步 | 2-在途中 | 3-已完成 | 100-已取消
+- `--confirmSupplier <status>`: 确认供应商：0-未确认 | 1-已确认
+- `--supplierOrderStatus <status>`: 供应商生产订单状态：0-待接单 | 1-生产中 | 2-已退单 | 3-已完成 | 4-已取消
+- `--quotationStatus <status>`: 报价单状态：0-确认中 | 1-已驳回 | 2-已确认 | 3-未提报
+- `--washStatus <status>`: 洗唛订单状态：-1-无 | 0-未同步 | 1-已同步 | 2-未确认 | 3-生产中 | 4-已发货 | 5-已取消
+
+#### 商品信息参数
+- `--goodsFullCode <code>`: 大货款号
+- `--goodsBatch <batch>`: 大货批次
+- `--goodsType <type>`: 大货类型：0-首单 | 1-加单 | 2-翻单
+
+#### 供应商参数
+- `--supplierName <name>`: 供应商名称
+- `--cooperationMode <mode>`: 合作模式：0-CMT | 1-FOB
+
+#### 人员参数
+- `--pdUserIdList <ids>`: PD 用户 ID 列表（逗号分隔）
+- `--purchaserIdList <ids>`: 采购员 ID 列表（逗号分隔）
+- `--designerName <name>`: 设计师名称
+
+#### 分类参数
+- `--saleArea <ids>`: 销售地区 ID 列表（逗号分隔）
+
+#### 状态标识参数
+- `--qcInspection <status>`: QC 质检结果
+
+#### 时间参数
+- `--type <type>`: 时间查询类型：0-大货上市时间 | 1-商品下单时间 | 2-合同交期时间 | 3-调整到货时间 | 4-订单关单时间 | 5-生产下单时间 | 6-工厂接单时间 | 7-计划到货时间 | 8-实际到货时间 | 9-需求到货时间
+- `--startTime <time>`: 开始时间（ISO 8601 格式）
+- `--endTime <time>`: 结束时间（ISO 8601 格式）
+
+#### 输出格式
+- `--format <format>`: 输出格式，table|json（默认: table）
+
+**可选全局参数：**
+- `-v, --verbose`: 显示详细日志
+
+## 使用步骤
+
+1. **用户登录**：用户需要先执行 `scm-cli auth login` 命令进行登录，获取有效的 Token。
+2. **构造查询参数**：根据用户的查询需求，构造相应的筛选条件。
+3. **执行 CLI 命令**：执行 `scm-cli production-orders --openId <openId> [选项...]` 命令。
+4. **处理结果**：将查询结果以友好的方式呈现给用户。
+
+## 示例
+
+### 示例 1：查询所有生产订单
+
+**用户输入**：
+```
+查询所有大货生产订单
+```
+
+**助手响应**：
+```
+正在查询大货生产订单...
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli production-orders --openId ou_xxxxx --pageSize 10
+```
+
+### 示例 2：按款号和状态查询
+
+**用户输入**：
+```
+查询款号为 "A12345" 且状态为 "已完成" 的大货生产订单
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli production-orders --openId ou_xxxxx --goodsFullCode A12345 --prodStatus 3
+```
+
+### 示例 3：按时间范围查询
+
+**用户输入**：
+```
+查询 2026 年 1 月 1 日到 2026 年 1 月 31 日的大货生产订单
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli production-orders --openId ou_xxxxx --type 1 --startTime 2026-01-01 --endTime 2026-01-31
+```
+
+### 示例 4：多条件组合查询
+
+**用户输入**：
+```
+查询供应商"XXX纺织厂"的、生产中的、洗唛已同步的大货订单
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli production-orders --openId ou_xxxxx --supplierName "XXX纺织厂" --supplierOrderStatus 1 --washStatus 1
+```
+
+## 注意事项
+
+1. **登录要求**：使用此功能前必须先执行 `scm-cli auth login` 登录，否则会返回认证错误。
+2. **参数说明**：
+   - `openId` 是必填参数，用于获取用户的 Token
+   - 其他筛选条件为可选，根据用户需求灵活使用
+3. **响应格式**：CLI 默认以表格形式输出，支持 `--format json` 输出 JSON 格式
+4. **错误处理**：如果查询失败，将返回相应的错误信息，如认证失败、参数错误等
+5. **CLI 路径**：确保 `scm-cli` 命令在 PATH 中可用

package/skills/production_orders/evals/evals.json

@@ -0,0 +1,23 @@
+{
+  "skill_name": "production_orders",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "查询所有大货生产订单",
+      "expected_output": "助手应询问用户的飞书 openId，并说明可以指定的筛选条件",
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "查询款号为 A12345 且状态为已完成的大货生产订单",
+      "expected_output": "助手应询问用户的飞书 openId，并确认查询条件",
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "查询 2026 年 1 月 1 日到 2026 年 1 月 31 日的大货生产订单",
+      "expected_output": "助手应询问用户的飞书 openId，并确认时间范围",
+      "files": []
+    }
+  ]
+}

package/skills/qc-orders/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: qc-orders
+description: 查询SCM QC质检订单。支持多维度筛选：订单状态、款号、大货类型、供应商、商品分级、中查管理、尾查管理、时间范围等。需先登录 SCM。当用户需要查询质检订单信息时，无论使用什么表述方式，都应该触发此 skill。
+compatibility:
+  - cli
+---
+
+# SCM QC 质检订单查询 Skill
+
+## 功能说明
+
+此 skill 用于查询 SCM 系统中的 QC 质检订单，支持多维度筛选条件。用户需要先登录 SCM 系统，获取有效的 Token 后才能使用此功能。
+
+## CLI 命令调用
+
+此 skill 通过执行 `scm-cli qc-orders` CLI 命令来执行查询操作。
+
+### 命令格式
+
+```bash
+scm-cli qc-orders --openId <openId> [选项...]
+```
+
+### CLI 参数说明
+
+**必填参数：**
+- `--openId <openId>`: 飞书用户 openId（用于获取对应用户的 Token）
+
+**可选参数（筛选条件）：**
+
+#### 分页参数
+- `--pageNo <pageNo>`: 页码，从 1 开始（默认: 1）
+- `--pageSize <pageSize>`: 每页条数，最大 100（默认: 20）
+
+#### 订单状态参数
+- `--qcOrderStatus <status>`: 质检订单状态：-1-全部 | 0-待分配 | 1-已分配 | 2-已完成 | 3-已取消
+
+#### 商品信息参数
+- `--goodsFullCode <code>`: 大货款号
+- `--goodsType <type>`: 大货类型：1-大货 | 2-翻单 | 3-补料
+
+#### 供应商参数
+- `--supplierName <name>`: 供应商名称
+
+#### 商品信息参数
+- `--goodsGradeList <grades>`: 商品分级列表（逗号分隔）
+
+#### 人员参数
+- `--midManager <name>`: 中查管理人员
+- `--checkGoods <name>`: 查货人员
+- `--tailManager <name>`: 尾查管理人员
+- `--qcUserIdList <ids>`: QC 质检员 ID 列表（逗号分隔）
+- `--prodManagerIdList <ids>`: 生产经理 ID 列表（逗号分隔）
+- `--purchaserIdList <ids>`: 采购员 ID 列表（逗号分隔）
+
+#### 时间参数
+- `--timeType <type>`: 时间类型：0-预约验货 | 1-下单 | 2-接单 | 3-分配 | 4-完成 | 5-交期
+- `--startTime <time>`: 开始时间（ISO 8601 格式）
+- `--endTime <time>`: 结束时间（ISO 8601 格式）
+
+#### 输出格式
+- `--format <format>`: 输出格式，table|json（默认: table）
+
+**可选全局参数：**
+- `-v, --verbose`: 显示详细日志
+
+## 使用步骤
+
+1. **用户登录**：用户需要先执行 `scm-cli auth login` 命令进行登录，获取有效的 Token。
+2. **构造查询参数**：根据用户的查询需求，构造相应的筛选条件。
+3. **执行 CLI 命令**：执行 `scm-cli qc-orders --openId <openId> [选项...]` 命令。
+4. **处理结果**：将查询结果以友好的方式呈现给用户。
+
+## 示例
+
+### 示例 1：查询所有质检订单
+
+**用户输入**：
+```
+查询所有 QC 质检订单
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli qc-orders --openId ou_xxxxx --pageSize 10
+```
+
+**助手响应**：
+```
+正在查询 QC 质检订单...
+```
+
+### 示例 2：按款号和状态查询
+
+**用户输入**：
+```
+查询款号为 "A12345" 且状态为 "已完成" 的 QC 质检订单
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli qc-orders --openId ou_xxxxx --goodsFullCode A12345 --qcOrderStatus 2
+```
+
+### 示例 3：按时间范围查询
+
+**用户输入**：
+```
+查询 2026 年 3 月 1 日到 2026 年 3 月 31 日的 QC 质检订单
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli qc-orders --openId ou_xxxxx --timeType 1 --startTime 2026-03-01 --endTime 2026-03-31
+```
+
+### 示例 4：按供应商和质检人员查询
+
+**用户输入**：
+```
+查询供应商"XXX纺织厂"的、中查为"李四"的质检订单
+```
+
+**执行的 CLI 命令**：
+```bash
+scm-cli qc-orders --openId ou_xxxxx --supplierName "XXX纺织厂" --midManager "李四"
+```
+
+## 注意事项
+
+1. **登录要求**：使用此功能前必须先执行 `scm-cli auth login` 登录，否则会返回认证错误。
+2. **参数说明**：
+   - `openId` 是必填参数，用于获取用户的 Token
+   - 其他筛选条件为可选，根据用户需求灵活使用
+3. **响应格式**：CLI 默认以表格形式输出，支持 `--format json` 输出 JSON 格式
+4. **错误处理**：如果查询失败，将返回相应的错误信息，如认证失败、参数错误等
+5. **CLI 路径**：确保 `scm-cli` 命令在 PATH 中可用

package/skills/scm-cli/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: scm-cli
+description: |
+  SCM 供应链管理系统 CLI 工具入口。当用户需要使用 SCM 系统相关功能时触发，如查询生产订单、物料订单、QC 订单，或登录认证等。
+compatibility:
+  - cli
+metadata:
+  requires:
+    bins: ["scm-cli"]
+  cliHelp: "scm-cli --help"
+---
+
+# SCM CLI — 供应链管理 CLI 工具
+
+## 功能说明
+
+`scm-cli` 是 SCM 供应链管理系统的命令行工具，提供以下能力：
+
+- **认证管理**：登录、登出、Token 状态检查、Token 管理
+- **大货生产订单**：查询生产订单列表，支持多维度筛选
+- **物料订单**：查询物料采购订单
+- **QC 质检订单**：查询质检订单
+
+## 子 Skills
+
+| Skill | 说明 |
+|-------|------|
+| `scm-login` | 登录认证（自动检查 Token 缓存） |
+| `production_orders` | 大货生产订单查询 |
+| `material-orders` | 物料订单查询 |
+| `qc-orders` | QC 质检订单查询 |
+
+## 安装
+
+```bash
+npm install -g @besile/scm-cli
+```
+
+## 验证安装
+
+```bash
+scm-cli --help
+```