技能介绍

这个技能解决什么问题

海外运营平台在报价、打样确认、订单评审阶段需要频繁拿面料价格。面料价格受计价方式（按米、按公斤、按码）、批次、汇率、客户等级影响，前端页面每一次切换计价模式，背后都是一次接口查询。如果让上层 agent 自己拼 HTTP 请求、自己管理鉴权头和租户上下文，很容易出现三类问题：一是请求地址漂移到测试环境，或被用户输入覆盖；二是 Authorization 头里的 Bearer 被重复拼接，直接换来 401；三是接口返回为空时，agent 自行「补全」一个价格，把猜测写进报价单。

这个技能把「按计价模式查面料价格」收敛成一次固定的接口动作，让 agent 只负责发起调用并原样传递结果。

它是怎么工作的

固定的接口契约。 生产环境地址写在 frontmatter 的 base_url 中，执行器只会调用 GET /api/fabric/fabric-price/getFabricPriceByPriceMode，不接受上层传入的地址覆盖。Path 参数写入 params.path，Query 参数写入 params.query，额外请求头写入 params.headers，JSON 请求体写入 params.body。

统一的参数包裹。 所有 tool arguments 都放在最外层的 params 对象里。不要写成 params.xxx 这种带点号的顶层 key，也不要把 query 参数平铺到 arguments 顶层。

登录态与权限。 调用时从 params.accessToken 生成 Authorization: Bearer；如果传入的值本身已包含 Bearer，不要再重复拼接。虽然这是查询/计算类接口，它依然受当前登录态、租户边界和用户权限约束。

结果不做二次加工。 返回内容以接口响应为唯一事实来源。价格、库存、订单号、优惠金额、物流状态这些字段，只要接口没给，就不允许由 agent 推断补造。遇到认证、权限、参数或业务错误时，把原始错误码和错误信息原样交给上层 agent，由它决定是重试还是中断流程。

适用边界与注意点

这是一个最小颗粒度的原子技能，只做 fabric_price 这一个动作。它不负责选面料、不负责算用量、不负责写报价单，也不保证连续多步的状态衔接。当你的业务链路需要「先按编码查面料 → 再按计价模式取价 → 再算整单金额」时，应由上层 agent 按聚合 skill platform-fabric-catalog 或计划文档编排多个原子技能，本技能只完成自己那一步，并把关键返回字段交给后续技能。

另外，POST / PUT 默认发送 JSON body；如果上层接口网关另有约定，以网关契约为准。GET / DELETE 的查询参数一律放在 URL query 中，不要塞进请求体。