简定制款式价格查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-style-order-full-style-price 到 AI 助手中。
技能介绍
要解决的具体问题
海外运营平台在简定制下单流程中,获取 B 端款式价格是必要环节。手工调用接口或临时拼接参数,容易导致登录态失效、参数层级错乱、正式环境地址被覆盖等问题,进而影响业务链路稳定性。
技能如何工作
- 固定接口契约:
style_price对应GET https://www.kutetailor.com/api/order/order/orden/getStylePrice,正式环境地址直接写在 frontmatter 的base_url中,调用时不接受用户输入覆盖。 - 参数层级规范:所有 tool arguments 统一使用嵌套
params对象,最外层仅保留params,避免出现params.xxx这类点号顶层 key。 - 登录态与请求头:通过
params.accessToken生成Authorization: Bearer;若传入值已含Bearer,则不再重复拼接。Path 参数写入params.path,Query 参数写入params.query,JSON Body 写入params.body,额外 Header 写入params.headers。 - 返回结果处理:返回结果必须以接口响应为事实来源,不补造库存、价格、订单号、优惠金额或物流状态;若接口返回认证、权限、参数或业务错误,原样保留错误码与错误信息并交给上层 agent。
适用边界与注意点
- 本技能是最小颗粒度接口 skill,只负责单个平台接口动作
style_price。 - 若用户需求涉及多个接口步骤,本技能只完成当前接口调用,并把关键返回字段交给后续 skill。
- 尽管是查询或计算类接口,仍需遵守当前登录态、租户和用户权限约束。
- POST/PUT 默认发送 JSON body;如果上层接口网关另有约定,以网关契约为准。
使用场景
- 简定制下单链路中,上层 agent 需要获取 B 端款式价格并传递给后续步骤。
- 平台后端需要按正式环境固定地址调用 getStylePrice 接口并规范传递登录态。
- 集成方需要处理接口返回的认证、权限或业务错误,并把原始错误信息传给上层。
- 业务脚本需要把 Query 参数 PriceCalculateRequest 组装到 params.query 后完成一次查询。
适合人员
- 跨境电商平台的后端工程师,需要封装或调用 getStylePrice 接口。
- 负责简定制下单链路的 Agent 开发者,需要按原子 skill 规范编排接口。
- 海外运营系统的集成工程师,需要处理登录态、租户和权限约束下的价格查询。
- 参与接口对接的测试工程师,需要验证参数层级、错误码传递和固定地址调用。