Agent Skills
返回列表
订单面料单耗查询

订单面料单耗查询

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 的指引,安装技能 @user_ac9585d3/platform-order-progress-fabric-usage-by-order-no。

技能介绍

解决的问题

海外运营平台在跟进订单进度时,经常需要核对面料单耗。例如确认某张订单实际用了多少面料、是否和计划一致。如果没有标准化的调用封装,每次查询都要手动拼 URL、处理鉴权、判断参数结构,容易出错也难复用。这个技能把 fabric_usage_by_order_no 这个接口动作封装成可调用的原子 skill,让上层 agent 可以直接按订单号查询。

如何工作

核心能力很单一:给定订单号,调用正式环境接口获取面料单耗。

  • 固定正式环境地址:base URL 写在 SKILL.md 的 frontmatter 中,调用时不接受用户输入覆盖,避免误连测试环境。
  • 统一嵌套参数:所有 tool arguments 都放在 params 对象里,不再使用 params.xxx 这类点号顶层 key。
  • 查询参数映射:GET 接口的 ordenNo 写入 params.query,由执行器拼接到 URL 上。
  • 登录态鉴权:通过 params.accessToken 生成 Authorization: Bearer ;如果传入值已含 Bearer,不会重复拼接。

返回结果以接口响应为事实来源,不做任何补造。接口返回的面料单耗字段会直接交给上层 agent,用于后续汇总或校验。

适用边界

这是一个最小颗粒度接口 skill,只完成本接口调用。如果用户需求涉及多个步骤,例如先查订单再算面料再比对计划,上层 agent 需要通过聚合 skill 或计划文档编排多个原子 skill,而不是由本 skill 一次完成。

另外,虽然这是查询类接口,仍然需要遵守当前登录态、租户和用户权限。如果接口返回认证错误、权限不足或业务错误,技能会把原始错误码和错误信息原样传给上层 agent,不吞错、不改写。返回结果中不会凭空补充库存、价格、订单号、优惠金额或物流状态。

使用场景

  • 订单进度跟进时,拿到订单号后需要查询面料单耗,核对该订单实际面料用量是否与生产计划一致。
  • 成本核算前,需要按订单号获取面料单耗数据,作为计算该订单面料成本的输入。
  • 面料用量出现异常反馈时,用订单号重新查询面料单耗,与计划单耗对比定位差异。
  • 上层 agent 编排订单处理链路时,需要先按订单号拉取面料单耗,再交给后续步骤聚合使用。

适合人员

  • 海外订单运营,跟进订单进度时需要按订单号查询面料单耗数据核对用料情况。
  • 后端开发,集成面料单耗查询接口,需要按订单号拉取单耗返回字段做后续处理。
  • 面料成本核算员,核算订单成本前需要按订单号获取实际面料用量。
  • AI 应用工程师,构建订单处理 agent 时需要调用该技能按订单号获取面料单耗数据。