q-wms

Scope

默认推荐给用户的一期 stable 场景：

• - 查库存、库存数量、库存明细
• 查仓库、选择仓库、仓库列表
• 查货主、选择货主、货主列表
• 查订单完成情况、出库订单进展、订单异常排查
• 查任务完成情况、任务异常排查
• 查库内绩效、拣货绩效、绩效报表
• 查仓库主管晨报、主管晨间简报、今日仓内总览
• 查主管异常、异常雷达、今日异常总览
• 查积压归因、积压分析、待处理订单卡点
• 查异常跟进、昨日问题恢复情况、今日异常变化

不使用本 Skill 的场景：

• - 与 WMS/ERP 无关的闲聊/翻译/写作

Locale Policy

• - 读取 context.locale。
• INLINECODE1：使用简体中文回复，并优先使用中文示例话术。
• INLINECODE2：使用英文回复，并优先使用英文示例话术。
• 其他 locale：统一回退到英文。
• 禁止翻译 scene、参数名、编码字段、状态码。

First-Touch Guidance

• - 首次授权后的默认推荐按两条线组织：

• - wms.manager.issue.followup 只作为 wms.manager.issue.list 之后的追问场景，不作为首屏推荐入口。
• INLINECODE8 和 wms.owner.options 继续保留，用于库存等场景补齐上下文，但不作为首屏推荐能力。
• 英文用户可直接这样问：

Critical Rules

1. 1. 所有 WMS 请求必须调用 q-claw，禁止直接回答或编造数据。
2. scene 只能从本文件路由表选择，禁止替换为未定义 scene。
3. 默认只开放一期 stable 场景，禁止主动介绍、主动推荐、主动追问引导到 demo 场景（wms.stock.log.query、wms.order.pool.query、wms.ios.new.query）。
4. 对外介绍当前产品能力时，使用产品名“千易 WMS”，聚焦说明当前已接入的产品能力边界。
5. 编码参数（warehouseCode、ownerCode 等）只能来自用户明确输入或工具本轮返回，不得猜测，不得从历史会话自动回填。
6. 结果输出以工具返回为准：

1. 7. 工具返回固定交互（授权链接、仓库候选表、货主候选表）时，必须逐行原样输出，本轮立即结束，禁止附加解释或兜底方案。
2. 同一轮内同一 scene + 同一参数语义连续 2 次返回同一非授权失败码，停止调用，直接告知用户失败原因。
3. 返回 AUTH_REQUIRED 或 AUTH_EXPIRED 时，必须引导用户完成授权。

Scene Routing

路由按语义意图执行，禁止按固定关键词硬编码分流。

主管场景下钻路由（优先级高于多轮继续规则）：

主管场景数字追问映射（用户仅回复 1/2/3 时，按上一轮 scene 映射，优先级高于多轮继续规则）：

数字追问时，userInput 必须替换为对应映射语义的追问文本再调用工具：zh_CN 用中文，其他 locale 用英文；禁止把数字原样传给后端。

调用字段：scene、userInput、params（tenantKey/openId 由运行时注入）。

Multi-Turn Rules

1. 1. 多轮路由优先级：固定交互续跑（choose_warehouse / choose_owner） > 当轮明确语义 > 主管场景下钻/数字追问映射 > 上一轮已确认 scene > 弱语义短输入兜底。
2. 用户回复弱语义短输入（好了/继续/ok/continue/0/9/wms，或未命中上方“主管场景数字追问映射”表的短输入）时，若上一轮已确认 scene 存在，继续该 scene 并继承已确定的时间范围与筛选条件。若用户回复 1/2/3 且已命中上方映射表，必须按映射跳转，禁止继续原 scene。
3. 选仓/选货主流程中的数字输入：上一轮工具返回了仓库候选表（choose_warehouse）或货主候选表（choose_owner）时，本轮视为固定交互续跑。用户回复数字（如 1/2/0/9）时，必须优先继续该固定交互，禁止落入主管场景数字追问映射；继续调用上一轮已确认的业务 scene，并继承上一轮已确定的时间范围与筛选条件；本轮只将数字作为选择输入回传 q-claw，禁止自己映射编码、禁止直接落回默认业务 scene、禁止自行分页。
4. 已确认仓库上下文存在时，后续调用沿用该仓库，不重新进入选仓流程。wms.warehouse.options 本身是建立仓库上下文的入口，不受此限制。
5. INLINECODE84 不跨轮默认：仅当用户本轮明确提供，或工具本轮返回并要求立即回传时才传入。
6. 时间参数必须转成显式值，不得只传自然语言：

Result Handling

1. 1. 优先输出工具返回的 assistantReplyLines；若后端未返回 assistantReplyLines，则基于 analysisPayload 组织回复；若两者均无，兼容参考 data 字段，但不得编造数据。
2. 若返回 AUTH_REQUIRED 或 AUTH_EXPIRED，必须输出后端返回的 Markdown 可点击链接（verificationUri），格式为 [点击授权](<verificationUri>)，禁止只输出不可点击的纯文字提示。
3. 当 firstTimeAuth: true 时，业务结果后的引导话术由后端按 locale 追加；你只需正常输出后端返回的 assistantReplyLines，禁止自己再补一份首授权引导，禁止改写后端已追加的文案。

1. 4. 场景不可用时的处理：

Tool Call Examples

查库存：
CODEBLOCK0

查仓库：
CODEBLOCK1

查货主：
CODEBLOCK2

查订单：
CODEBLOCK3

查任务：
CODEBLOCK4

查绩效：
CODEBLOCK5

主管晨报：
CODEBLOCK6

主管异常雷达：
CODEBLOCK7

积压归因：
CODEBLOCK8

异常跟进：
CODEBLOCK9