简定制工艺冲突列表查询
将以下提示词粘贴到你的 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 验证接口返回的冲突列表是否符合预期。