Agent Skills
返回列表
简定制工艺冲突列表查询

简定制工艺冲突列表查询

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-craft-catalog-craft-conflict-by-ids

技能介绍

要解决的问题

在海外运营平台的简定制业务里,一次工艺选择可能命中多条工艺路线,路线之间是否存在冲突需要靠后端接口判定。调用方手里通常只有一组工艺 ID,如果自己去拼装鉴权头、拼路径参数、判断该把哪些参数放进 Path 还是 Body,很容易出错:比如把 {ids} 拼进 query、把登录态写成普通字段、或者在接口报业务错误时凭空补一个「默认无冲突」的结果。

这个 skill 把「按工艺 ID 列表拉取冲突列表」这一件事收敛成一个原子动作 craft_conflict_by_ids,把容易出错的协议细节固化在执行器里。

技能如何工作

核心只有一个接口动作:

  • HTTP 方法与路径:POST /craft/craft-conflict/selectConflictByCraftIds/{ids}
  • 正式环境固定地址:执行器从 frontmatter 的 base_url 取值,固定指向 https://www.kutetailor.com/api/craft/craft/craft-conflict/selectConflictByCraftIds/{ids},不接受用户输入覆盖。
  • 参数组织:tool arguments 统一放进嵌套的 params 对象,最外层只有 params 一个 key,不使用 params.xxx 这类点号顶层字段。
  • 三类参数的落位:Path 参数写 params.path(这里就是 ids),JSON Body 写 params.body(冲突请求体),额外 Header 写 params.headers。请求体按参数列要求以 application/json 提交,不降级为普通 JSON。
  • 鉴权:登录态接口用 params.accessToken 生成 Authorization: Bearer ;若传入值本身已含 Bearer,执行器不重复拼接。
  • 编排方式:这是最小颗粒度接口 skill。需要多个接口步骤时,由上层 agent 按聚合 skill(platform-craft-catalog)或计划文档编排多个原子 skill,本 skill 只负责完成自己这一个调用,并把关键返回字段交给后续步骤。

适用边界与注意点

  • 只做单接口:本 skill 不负责工艺目录查询、冲突解决或重试策略,这些要由上层 agent 组合完成。
  • 不做数据补全:返回结果以接口响应为唯一事实来源,不补造库存、价格、订单号、优惠金额或物流状态。
  • 仍然是受限接口:虽然是查询/计算类接口,仍受当前登录态、租户和用户权限约束,没有有效 token 或越权调用会直接失败。
  • 错误原样透传:遇到认证、权限、参数或业务错误时,把原始错误码和错误信息原样传给上层 agent,由上层决定如何处理,不要在执行器里吞掉或改写。
  • 变更工艺 ID 列表即变更语义:Path 中的 ids 直接决定返回的冲突集合,调用方需保证传入的 ID 列表本身是本次简定制场景的正确集合。

使用场景

  • 在海外运营平台处理简定制订单时,拿到一组工艺 ID,需要调用接口判断这些工艺路线是否存在冲突并取得列表。
  • 上层 Agent 正在编排简定制完整业务链路,需要先由本 skill 完成 conflict 查询,再把返回字段交给后续 skill。
  • 工艺目录聚合流程走到冲突校验环节,调用方只持有 craft IDs,需要按 Path 参数提交并拿到接口原始结果。
  • 排查简定制下单失败原因时,需要直接查看该批工艺 ID 对应的冲突列表,确认是否因路线冲突被业务拦截。

适合人员

  • 海外定制业务的运营工程师,需要在简定制下单前确认工艺路线是否冲突,避免提交无效订单。
  • 负责编排原子接口的 Agent 开发者,需要把 craft_conflict_by_ids 作为单步能力接入上层业务链路。
  • 工艺目录聚合服务的后端工程师,需要在流程中调用冲突列表查询并按错误码排查失败原因。
  • 做定制下单链路联调的测试工程师,需要用一组工艺 ID 验证接口返回的冲突列表是否符合预期。