Agent Skills
返回列表
海外运营平台成品详情及订单编辑

海外运营平台成品详情及订单编辑

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 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,并核查租户、权限和接口契约。