Store Order Query Skill

---

name: store-order-query

description: query store order information from database

---

# Store Order Query Skill

技能描述

这是一个通过连接MySQL数据库查询店铺订单的 Skill。当用户询问店铺订单情况时(如"查询今天店铺订单"、"今天的订单怎么样"、"店铺经营情况"),使用此 Skill 连接数据库查询订单数据,并生成分析报告。

使用场景

工作流程

step1. 检查配置文件

首先检查是否存在数据库配置文件 `~/openclaw-skill-data/store-order-query/config.json`。

**如果配置文件不存在**,需要询问用户以下信息:

然后基于 `config.example.json` 创建 `config.json` 文件。

step2. 解析用户查询意图

从用户的查询中提取:

如果用户说"今天",则查询当天的订单数据。

step3. 执行查询脚本

调用以下命令查询订单数据，传递参数：

node dist/index.js --date-range today

脚本会：

1. 读取配置文件连接MySQL数据库

2. 查询Order表获取订单数据

3. 根据订单号查询OrderItems表获取商品信息

4. 将数据保存到 `~/openclaw-skill-data/store-order-query/orders_data.json`

step4. 分析数据并生成报告

调用以下命令分析订单数据并生成报告：

node dist/analyze-orders.js

脚本会：

1. 读取 `~/openclaw-skill-data/store-order-query/orders_data.json`

2. 进行数据分析（订单量、总金额、支付方式分布、商品分析等）

3. 生成 Markdown 格式的报告保存到 `~/openclaw-skill-data/store-order-query/order_report.md`

5. 呈现报告

读取生成的报告文件,向用户展示分析结果。

配置文件格式

`~/openclaw-skill-data/store-order-query/config.json` 示例:

{
  "database": {
    "type": "mysql",
    "host": "localhost",
    "port": 3306,
    "database": "shop_db",
    "user": "root",
    "password": "your_password"
  },
  "tables": {
    "orders": "Order",
    "order_items": "OrderItems"
  },
  "fields": {
    "orders": {
      "id": "orderSn",
      "created_at": "createdAt",
      "total_amount": "orderActualAmount",
      "payment_method": "payType",
      "status": "orderStatus"
    },
    "order_items": {
      "order_id": "orderSn",
      "product_name": "name",
      "sku": "sku",
      "quantity": "counts",
      "price": "actualPrice"
    }
  }
}

数据库表结构

Order 表（订单表）

| 字段 | 类型 | 说明 |

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

| orderSn | VARCHAR(50) | 订单号(主键) |

| createdAt | DATETIME | 创建时间 |

| orderActualAmount | DECIMAL(10,2) | 订单实际金额 |

| payType | VARCHAR(50) | 支付方式 |

| orderStatus | VARCHAR(20) | 订单状态 |

OrderItems 表（订单商品表）

| 字段 | 类型 | 说明 |

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

| id | INT | 主键ID |

| orderSn | VARCHAR(50) | 订单号(外键) |

| name | VARCHAR(200) | 商品名称 |

| sku | VARCHAR(100) | SKU |

| counts | INT | 数量 |

| actualPrice | DECIMAL(10,2) | 实际价格 |

注意事项

1. 确保已在根目录安装依赖：`pnpm install`

2. 配置文件包含敏感信息，不要将其提交到公共仓库

3. 首次使用时需要配置数据库信息

4. 确保MySQL数据库用户有读取Order和OrderItems表的权限

5. 生成的报告会保存在 output 目录中,可以重复查看

错误处理