海外平台工艺审核列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-craft-admin-approval-list。
技能介绍
需要解决的问题
在 KutSmart 海外运营平台的工艺后台维护场景中,业务方需要查看当前的工艺审核列表以推进后续流程。如果在客户端或临时脚本中直接拼接 HTTP 请求,容易遇到几个典型问题:基础 URL 配置漂移、鉴权逻辑在各模块不一致,以及 Path/Query/Body 参数传递混乱。
工作原理与执行步骤
该 Skill 是一个最小颗粒度接口技能,其核心能力被严格限定在单一的 approval_list 接口动作上:
- 固定端点:执行器直接读取 frontmatter 中的正式环境地址
https://www.kutetailor.com,并在末尾拼接/api/craft/craft/approval。这种硬编码方式彻底杜绝了用户输入覆盖 Base URL 的风险。 - 嵌套参数结构:所有调用参数必须封装在一个统一的
params对象中。对于本查询类接口,查询参数(如SelectCraftApprovalRequest)应写入params.query。 - 鉴权处理:登录态通过
params.accessToken注入。执行器会自动判断是否已包含Bearer前缀,避免重复拼接导致的鉴权失效。 - 结果透传:接口返回标准的
IPage分页结构。若发生认证或权限错误,Skill 会原封不动地将错误码和信息透传给上层 Agent。
适用边界与注意点
- 非全链路工具:该 Skill 只负责取回列表,不负责后续的审核通过、驳回或数据清洗。需要完成完整业务闭环时,必须由上层 Agent 进行多接口编排。
- 上下文约束:该查询接口同样受到当前租户和用户权限的严格限制,不会返回无权访问的数据。
- 事实来源:返回结果必须以接口响应为准,禁止在本地补造或估算任何库存、价格、订单号或物流状态。
使用场景
- 需要拉取海外运营平台工艺审核列表时,调用固定正式环境接口返回分页数据
- 上层Agent编排完整业务链路时,先调用该接口获取审核列表基础数据再交给后续步骤
- 接口返回认证或权限错误时,需将原始错误码和错误信息透传给上层Agent处理
- 需要按SelectCraftApprovalRequest查询条件筛选审核列表时,将参数写入params.query
适合人员
- 后端工程师:需要在后端服务中集成工艺审核列表查询接口,处理params嵌套传参与错误透传
- AI Agent开发者:需要将该原子技能作为多步骤业务编排中的一环调用,获取工艺审核列表数据
- 海外平台运营人员:需要查看工艺审核列表以推进审核流程,依赖固定正式环境接口返回结果
- 集成工程师:需要按网关契约调用该查询类接口,处理登录态与租户权限校验