酷特海外工艺目录·按编码查冲突
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-craft-catalog-craft-conflict-by-ecode。
技能介绍
要解决什么问题
在海外运营平台的工艺目录维护里,同一套工艺编码往往要对照平台侧的「冲突」规则:哪些组合互斥、哪些条目不能并存。业务同学或上层 Agent 通常只知道 ecode(工艺编码),需要一份按编码拉取的冲突列表,而不是手工翻后台或拼多条无关接口。
本技能是 platform-craft-catalog 聚合能力下的原子接口技能,只负责动作 craft_conflict_by_ecode:用 Path 参数 ecode 调正式环境固定地址,把接口原样返回交给后续编排(例如再查详情、写回工单)。
技能如何工作
- 固定环境:执行器使用 frontmatter 中的
base_url(正式环境https://www.kutetailor.com),不接受用户输入覆盖。 - 请求形态:
GET /api/craft/craft/craft-conflict/selectConflictList/{ecode},{ecode}从params.path替换。 - 参数约定:tool 参数统一放在嵌套对象
params内;需登录时通过params.accessToken生成Authorization: Bearer(值已含Bearer则不重复拼接);额外 Header 走params.headers。 - 事实来源:返回必须以 HTTP 响应为准,不要补造库存、价格、订单号或物流状态;认证、权限、参数或业务错误时,把原始错误码与信息传给上层 Agent。
适用边界与注意点
- 若用户需求是「查冲突 + 改工艺 + 提交审批」等多步链路,本技能只完成查询冲突列表一步,其余由聚合 skill 或计划文档编排其它原子 skill。
- 这是查询类接口,仍受当前登录态、租户与用户权限约束;无 token 或权限不足时,应如实上报接口错误而非猜测结果。
使用场景
- 上层 Agent 在编排海外工艺上架或变更流程时,先根据用户给出的工艺编码调用本接口,拿到冲突列表再决定是否阻断或转人工审核。
- 工艺数据治理同学在核对某条 `ecode` 是否违反平台互斥规则时,用固定正式环境地址查询冲突条目,避免手工在后台逐条对照。
- 把「按编码查冲突」嵌入内部工单或 PLM 回调:审核单里只带工艺编码,系统自动拉取冲突列表供审批人判断。
- 在 `platform-craft-catalog` 聚合链路里作为原子步骤,仅完成 `craft_conflict_by_ecode`,后续再由其它 skill 查详情或写回平台。
适合人员
- 负责对接 kutetailor 工艺目录 HTTP 接口、需要按 Path 参数 `ecode` 封装查询的后端或集成工程师
- 维护海外运营工艺主数据、上架前必须核对编码冲突规则的平台运营或工艺管理员
- 编写多步工艺目录 Agent 计划、要把「查冲突」拆成独立原子 skill 再编排的 Agent 维护者
- 在酷特海外运营平台做权限与租户隔离联调、需把认证错误原样上报给上层逻辑的 QA 或实施顾问