订单面料单耗查询
将以下提示词粘贴到你的 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 时需要调用该技能按订单号获取面料单耗数据。