1688-supplychain-order-inquiry（订单询盘 + 商品 SKU 提取 Skill）

本 Skill 承载两个互斥的能力域，进入任何流程前必须先做能力域语义路由（见下一节），路由结果决定执行方式与输出契约：

订单询盘域统一入口：python3 {baseDir}/cli.py <command> [options]（必须使用绝对路径，{baseDir} 为 Skill 所在目录）

能力域语义路由（第一步 · 先判域再判命令）

按以下顺序判定，先命中者即为最终路由：

消歧要点

• 「订单号」vs「商品链接」是最强区分信号：出现订单/采购单号 → 域 A；出现商品详情页 URL 且无订单号 → 域 B。
• 「询价 / 要价格」在订单上下文里是询盘（域 A，question 走 目标总价<金额>）；在商品链接上下文里则走域 B，但注意域 B 已不再交付价格字段（只有 image + query），应向用户如实说明。
• 同一句里既有订单号又有商品链接时，以用户动词诉求为准：「问商家」→ 域 A；「提取 SKU」→ 域 B；两者都要则分两步依次执行，两个域的产物作为两条独立消息输出（域 A 的纯 JSON 必须单独成一条，不得与域 B 的交付内容拼接）。
• 域 B 不涉及 AK、网关、cli.py，不要为域 B 检查或引导配置 AK。

严格禁止 (NEVER DO)

• 不向用户透出内部工具名和技术状态
• 不编造询盘结果和 SKU 数据，所有结果必须来自工具返回
• 不凭本文件摘要拼凑参数——执行前先阅读 references/capabilities/<command>.md
• 域 A（订单询盘）最终回复必须是纯 JSON（首字符 { 或 [，末字符 } 或 ]），不得包含任何自然语言、markdown 格式或解释文字
• 不得跨域套用输出契约：域 A 与域 B 均只能输出裸 JSON / JSON 数组（无代码块、无汇总行、无自然语言包裹），且域 B 不得夹带价格 / 库存 / 店铺字段

最终输出契约（HARD RULE · 入口无关 · 最高优先级）

本条对所有调用入口无条件生效——无论是 POST /workflow/run 直连本 skill 的 workflow，还是 POST /task/create 经由 ReAct 主 agent 把本 skill 的 workflow 当作 Workflow tool 调用，也无论未来新增任何入口：

主 agent 的最终一条消息，必须原样等于 workflow（或 cli.py）返回的那段 JSON 字符串，逐字透传。

• ⛔ 不得把 workflow 返回的 JSON 当作"中间结果"再总结、改写、转成表格或自然语言。
• ⛔ 不得在 JSON 前后追加任何话术、markdown 包裹、解释或 emoji。
• ⛔ 不得合并进度话术与 JSON（进度话术若有，必须是执行前的独立消息）。
• ✅ workflow 返回什么 JSON，最终就交付什么 JSON，一个字符都不改。

即 {"success": true, "wwTaskId": "...", "message": "询盘已成功发送"} 这类结构化 JSON 必须原封不动抵达调用方，与走哪条入口无关。

域 B（商品 SKU 提取）同样遵循纯 JSON 输出：域 B 由 browser 工具执行，交付的是 image + query 的纯 JSON 数组（首字符 [，末字符 ]），不得包裹代码块、不得附加汇总文字或任何自然语言，与域 A 输出契约一致。具体格式见 references/capabilities/sku_extract_shopify.md / sku_extract_aliexpress.md。

直连 workflow 入口（零思考直通）

当用户明确指定 workflowName（如"用 / 走 / 调用 order-inquiry-workflow 这个 workflow"），或 Harness 平台工作模板节点的 agentHints 指向本 skill 的 workflow 时，主 agent 不参与业务理解，只做一次路由调用：

POST /workflow/run
{
  "workflowName": "1688-supplychain-order-inquiry-workflow",
  "instruction": "<用户原话>",        // 二选一或两者都传
  "params": { "command": "...", ... } // 结构化时传
}

• 结构化（零 LLM）：{ "params": { "command": "inquiry_send", "orderIds": ["..."], "question": "目标总价<1200>" } }
• 自然语言：{ "instruction": "帮我问下 705123456789 那个订单什么时候能发货" }

路由原则：用户诉求必须落在已生成订单/采购单的上下文里才进本 workflow——包括：向商家就订单提问（发货时间/物流单号/订单状态）、订单议价（目标总价）、查询商家询盘回复、订单对话配置、访问 AK 配置。不承接商品搜索、供应商询盘、找货、选品等非订单类诉求；也不承接域 B 的商品 SKU 提取（域 B 不走 workflow，直接用 browser 工具执行）。workflowName = 1688-supplychain-order-inquiry-workflow（= SKILL name + -workflow 后缀，与 SKILL name 显式区分）。

⛔ 主 agent 不得：理解业务意图 / 引导用户补参数 / 改写 workflow 输出的 JSON / 用本 SKILL 下的 cli.py 绕开 workflow 直调。（其中"不得改写 workflow 输出的 JSON"由上文《最终输出契约》约束，对所有入口生效，不限本小节。）

输出两阶段（独立两条消息，严禁合并）

1. 执行前：可单独输出进度话术（如"正在向商家发起询盘，请稍等..."）
2. 执行后：单独输出纯 JSON，格式见各命令 reference 的"Agent 输出格式"

❌ 禁止：正在向商家发起询盘，请稍等...{"success": true, ...}（话术与 JSON 拼在同一条消息）

上述两阶段仅适用于域 A。域 B（SKU 提取）可先输出进度话术（如"正在打开商品页面提取 SKU，请稍等..."），最终以纯 JSON 数组交付（无代码块、无汇总）。

执行前置（MUST）

同一会话内首次执行某命令/能力前，MUST 完整阅读 references/capabilities/<command>.md 获取准确参数、输出格式和注意事项（域 B 对应 sku_extract_shopify.md / sku_extract_aliexpress.md）；本会话已读过且文件无变更则无需重读。

遇到 success: false 时（域 A），MUST 先阅读 references/common/error-handling.md，不要自行猜测错误原因。

能力速查

域 A·订单询盘（cli.py 命令）

所有命令输出 JSON：{"success": bool, "markdown": str, "data": {...}}

域 B·商品 SKU 提取（browser 工具，无 CLI）

两个能力均交付 image + query 的 JSON 数组，不输出价格、库存、店铺信息。

域 A·订单询盘触发流程

意图识别（泛化）：绑定了订单/采购单号 + 诉求指向商家 → 即为询盘，不限表达形态——指令式（"帮我问商家XX / 询个价 / 问下发货时间"）或正文式祈使句（"麻烦提供一下快递单号 / 麻烦尽快发货"），把用户诉求作为询盘 question 传入。

1. 确认订单 ID 和询盘问题（缺失则引导用户提供）
2. 识别可选参数意图（对话轮次 --order-single-round、超时 --timeout、附件 --image-url / --image、扩展字段 --ext），识别规则见 references/capabilities/inquiry_send.md；用户未提及的可选参数一律不传
3. 输出中间话术 → 执行命令 → 按 reference 的"Agent 输出格式"输出纯 JSON

命令路由（判断标准）

本小节仅在上文《能力域语义路由》已判定为域 A 后适用。

本 skill 已下线 batch_inquiry 能力。多订单同问题直接用 inquiry_send 的 -o 传多个订单号即可；各订单问题不同的场景，请分多次调用。

复合意图（配置 + 发送）

当用户输入同时包含对话配置指令（"设置单轮询盘"/"设置超时时长"等）和面向商家的发送内容（订单号 + 发送内容/消息正文）时，必须作为一次 inquiry_send 调用处理，将配置参数（--order-single-round、--timeout）作为 inquiry_send 的可选参数一并传入。严禁拆成两次调用（一次 inquiry_config + 一次 inquiry_send）。inquiry_send CLI 原生支持这些配置参数，一次调用即可完成全部诉求。

仅当输入纯粹只有配置指令、没有任何面向商家的内容（无订单号、无发送正文）时，才走 inquiry_config。

目标总价

「目标总价」本身就是询盘问题，question 格式为 "目标总价<金额>"（如"目标总价17"）。各订单目标总价相同 → 合并走 inquiry_send；不同 → 分多次调用 inquiry_send。仅提供订单 ID 无目标总价/问题时，引导用户说明询盘目的。

orders-detail 触发条件（必须同时满足两条）

1. 关键词：用户输入含"分别附"/"各配"/"每个订单配"/"各自附"等按订单维度分配附件的表达
2. 格式：用户输入逐订单列举了各自的图片/文件链接（形如"订单A：图片 xxx，文件 yyy；订单B：图片 zzz"）

不满足任一条件 → 附件走全局 --image-url 传入。JSON 结构与细节见 references/capabilities/inquiry_send.md。

询盘结果查询

用户说"商家回复了吗 / 总结询盘结果 / 询盘有结果了吗 / 那个订单问完没 / 商家回消息没"等 → 确认 taskId（= 发起询盘时返回的 wwTaskId，缺失则引导用户提供或从上下文提取）→ 中间话术"正在查询商家回复，请稍等..." → 执行 inquiry_query -t <taskId> → 按 references/capabilities/inquiry_query.md 的 "Agent 输出格式" 输出纯 JSON（终态透传 status + summary，非终态只返回 status + 固定 message）。

询盘对话配置

用户明确要对询盘的对话能力本身做配置（"设置成单轮 / 关掉 AI 自动回复 / 开启多轮对话"等，而非发起一次询盘）→ 中间话术"正在为您配置对话能力，请稍等..." → 执行 inquiry_config（明确要多轮加 --multi-round，其余默认单轮）→ 按 reference 输出纯 JSON。若用户实际是要发起询盘，走 inquiry_send。

注意：若用户输入同时包含配置指令和发送内容（订单号 + 面向商家的正文），不要走 inquiry_config，应走 inquiry_send 并将配置参数（--order-single-round、--timeout）一并传入。inquiry_send CLI 原生支持这些参数，无需分两次调用。

域 B·商品 SKU 提取流程

意图识别：用户给出商品详情页链接（无订单号）+ 诉求指向该商品的 SKU / 变体 / 规格 / 各款式图片 → 即为 SKU 提取。表达形态不限："提取一下这个链接的 SKU"、"这个商品有哪些颜色尺码"、"把各款式的图拉出来"。

统一交付契约：两个平台能力最终都输出同一形状的纯 JSON 数组（首字符 [，末字符 ]，无代码块包裹），每项仅含两个字段：[{"image": "<原图URL>", "query": "<SKU 属性组合>"}]

• query 分隔符按平台约定：Shopify 用英文逗号（"Grøn,38"），AliExpress 用空格（"Red Large"），不要互相套用
• 两个平台均不交付价格、库存、店铺、商品描述；用户若明确要价格，如实说明当前能力不返回价格

1. 判平台：按链接域名 / 路径特征选定能力
   • aliexpress.com / aliexpress.us / zh.aliexpress.com，路径含 /item/<id>.html → sku_extract_aliexpress
   • *.myshopify.com 或自定义域名且路径含 /products/<handle> → sku_extract_shopify
   • 无链接 → 引导用户补链接；平台无法判定 → 先按 Shopify 通用路径试探，失败则如实说明暂不支持该平台
2. 读 reference：本会话首次执行该能力前，MUST 完整阅读对应的 references/capabilities/sku_extract_*.md，取其中的 evaluate 脚本原文，不得凭记忆改写脚本
3. 执行：browser navigate（wait_until=networkidle、timeout=60000）→ browser evaluate 执行脚本
   • Shopify：单脚本三级降级（product.json → 内嵌 JSON → ShopifyAnalytics meta），一次 evaluate 完成
   • AliExpress：先跑维度探测脚本；仅当其返回空数组时，才降级到逐个点击脚本，不要两个都跑
4. 组装输出：按 reference 的第 3 步将原始返回映射为 image + query 的纯 JSON 数组
   • Shopify：变体 title 按 / 拆分后用逗号拼接为 query；脚本额外返回的 price / available / sku 一律忽略
   • AliExpress：单维度直取选项值；多维度做笛卡尔积、图片取带图维度、query 空格拼接
   • 脚本返回失败或空结果时如实说明未能提取及可能原因，不编造 SKU、图片链接和属性组合

多个链接 → 逐个执行并分节输出，每节标明商品标题或链接。跨平台混合链接 → 各自走对应能力。