海外运营平台成品详情及订单编辑
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-style-catalog-finish-detail。
技能介绍
解决什么问题
在海外运营平台中,款式目录(Style Catalog)下的成品详情页面既要展示成品信息,也要承担编辑订单详情的操作入口。如果每次都从零拼装 HTTP 请求,容易遇到几个具体问题:正式环境地址被随意覆盖、登录态 Token 拼接不一致、Path 参数与 Query 参数混放导致路由错误,以及接口报错时原始错误码被吞掉。这个技能把「成品详情及编辑订单详情」收敛为一个最小颗粒度的原子动作 finish_detail,让上层 agent 可以稳定复用同一套请求约定。
技能如何工作
核心能力是一次 GET 请求:
- 调用地址固定为
https://www.kutetailor.com/api/style/style-info/getFinishDetail,由 frontmatter 的base_url声明,不接受用户输入覆盖。 - 请求参数统一封装在嵌套的
params对象中,而不是params.xxx这类点号顶层 key。 - 登录态通过
params.accessToken生成Authorization: Bearer头;如果传入值已经包含Bearer,执行器不会重复拼接。 - 查询参数放在 URL query(
id必填,ordenId可选),不塞进 body,也不占用额外的params.headers。 - 返回类型为
StyleFinishVO,执行器以接口响应为唯一事实来源,直接把成品详情与订单相关字段交给后续 skill。
当业务链路需要多个接口步骤时,本技能只完成自己这一段:发起调用、校验登录态与租户权限、把原始返回或错误码透传给上层 agent,由聚合 skill platform-style-catalog 负责编排。
适用边界与注意点
- 这是查询/计算类接口,不会修改库存、价格或物流状态,返回结果中不应出现接口未提供的数据。
- 如果返回认证失败、权限不足或业务错误,技能会把原始错误码和错误信息原样传出,由上层决定重试还是终止。
ordenId是可选参数,需要上层 agent 明确需要编辑的订单上下文时再传入;否则只返回成品详情。- 该动作依赖当前登录态、租户和用户权限,跨租户调用仍以网关契约为准。
使用场景
- 海外运营平台运营在款式目录页打开成品详情,需要按 id 拉取 StyleFinishVO 并核对可编辑订单字段。
- Agent 编排时需要先取成品详情,再根据 ordenId 进入订单编辑流程,本技能只负责第一段调用与字段透传。
- 业务方反馈详情页异常,需要用固定正式环境地址复现接口返回,区分认证、权限、参数和业务错误码。
- 多租户团队按当前登录态拉取款式成品信息,不补造库存、价格、订单号或物流状态。
适合人员
- 海外运营平台运营专员:需要在款式目录成品详情页查看并编辑订单详情,不直接改代码。
- 业务系统后端工程师:要把固定 GET 接口接入服务层,统一处理 Authorization 和错误码。
- Agent 编排工程师:需要把最小颗粒度 finish_detail 动作编排进完整业务链路。
- 平台 SRE / API 负责人:需要确认请求走正式环境 base_url,并核查租户、权限和接口契约。