SkillHub

qianyi-wms-test

v0.2.0

千易 Q-WMS 技能。覆盖授权、库存查询、库存变动日志核对等场景。

Sourced from ClawHub, Authored by lee

Installation

Please help me install the skill `qianyi-wms-test` from SkillHub official store. npx skills add ljqdh/qianyi-wms-test

此文件是 q-wms/SKILL.md 的发布副本（ClawHub 用）。 请勿直接编辑，修改请在 q-wms/SKILL.md 进行后同步。

q-wms-flow

核心规则

  • 语言跟随用户；用户消息包含中文时，必须使用简体中文。
  • 禁止臆测执行结果；没有真实工具结果时，不得捏造数据或状态。
  • 工具结果包含 assistantReplyLines 且非空时，必须逐行原样输出，不得改写、删减、补充。
  • 工具结果 assistantReplyLines 为空时，AI 根据 data 字段自由分析组织回复。
  • 所有 WMS 相关请求，必须先调用 q-wms-flow 工具再回复，禁止直接回答。

一、安装意图（最高优先级）

若用户消息包含以下任一表达，直接回复安装引导，不调用工具：

  • 安装 / 重装 / 更新插件 / 启用插件
  • openclaw plugins install
  • clawhub install
  • q-wms-flow.tgz

固定回复（中文场景）：

  1. 请点击安装 Q-WMS 插件：安装 Q-WMS 插件
  2. 页面会自动拉起 OpenClaw 安装助手完成安装。
  3. 安装完成后回到对话继续使用。

约束：不要输出终端安装命令；不要输出"我来帮你安装/我正在安装"等话术。

二、场景路由

根据用户意图，调用 q-wms-flow 工具时传入对应 scene 值：

用户意图 scene 值 说明
查库存、查某个 SKU 有多少货 wms.inventory.query 库存查询
查库存变动、库存日志、找库存不准原因 wms.stock.log.query 库存变动日志核对

调用工具时必须传入： - scene：场景标识 - tenantKey：从渠道上下文获取 - openId：从渠道上下文获取 - userInput：用户原始消息 - params：场景参数（见各场景说明）

三、授权流程

触发条件

工具返回以下任一情况时，进入授权引导： - code 为 AUTH_REQUIRED 或 AUTH_EXPIRED - 结果包含 authRequired: true

授权引导规范

  1. 若结果包含 authorizationGuide.verificationUri，输出：
  2. 当前操作需先完成授权。
  3. 点击登录授权

  4. 完成后直接继续发送你的查询即可。

  5. 若无 verificationUri，输出：

  6. 当前操作需先完成授权。
  7. 未获取到授权链接，请发送"授权"重试。

授权完成后

用户完成授权后继续发消息，工具会自动携带 accessToken，无需用户手动操作。

四、场景：库存查询（wms.inventory.query）

调用参数

scene: "wms.inventory.query"
params:
  warehouseCode: 仓库代码（用户指定或从上轮对话获取）
  skus: SKU 列表（用户指定，可为空）
  queryMode: "normal"（默认）或 "warehouse_all"（查整仓）

多轮对话规则

  • 若后端返回 stage: "choose_warehouse"：展示仓库列表，等待用户选择
  • 若后端返回 stage: "choose_sku"：提示用户输入 SKU
  • 用户回复仓库名/编号或 SKU 时，视为库存链路 follow-up，继续调用工具，禁止跳转其他工具

结果处理

  • assistantReplyLines 非空：原样输出
  • assistantReplyLines 为空且有 data.inventoryRows：AI 整理成表格输出

五、场景：库存变动日志核对（wms.stock.log.query）

触发意图

用户表达以下意图时进入此场景： - 查某个 SKU 的库存变动记录 - 核对库存、找库存不准的原因 - 查某时间段内的库存操作日志

参数提取规则

调用工具前，必须从用户消息中提取以下参数，缺少时先追问，不要猜：

参数 说明 示例
warehouseCode 仓库代码 SAAS01
ownerCode 货主代码 YQN_UAT
sku SKU 编码 SKU001
timeFrom 开始时间 2026-03-01
timeTo 结束时间 2026-03-20

调用参数

scene: "wms.stock.log.query"
params:
  warehouseCode: "SAAS01"
  ownerCode: "YQN_UAT"
  sku: "SKU001"
  timeFrom: "2026-03-01"
  timeTo: "2026-03-20"

结果分析规范

后端返回 data.logs 时，AI 自主分析（assistantReplyLines 为空）：

  1. 按时间顺序还原库存变动链
  2. 检查每笔变动的数量连续性（前一笔 toQty 是否等于后一笔 qty）
  3. 标记异常：数量跳变、异常操作类型、重复操作
  4. 对比最终 toQty 与当前实际库存是否一致
  5. 给出结论：哪笔操作导致了不准，操作类型是什么，操作人是谁

输出格式建议： - 先给出结论（一句话） - 再列出关键变动记录（表格） - 最后标注异常点

六、版本升级

工具返回 code: "UPGRADE_REQUIRED" 时： - 若有 assistantReplyLines，原样输出 - 若有 upgradeGuide.installPageUrl，输出安装页链接 - 不要输出"我来帮你升级"等话术

七、异常处理

code 处理方式
CONFIG_MISSING 提示用户联系管理员配置插件
IDENTITY_MISSING 提示用户确认飞书/钉钉渠道配置
BACKEND_UNAVAILABLE 提示服务暂时不可用，稍后重试
UPGRADE_REQUIRED 输出升级引导
其他未知错误 输出 message 字段内容，建议用户重试