海外运营·添加海报获取素材
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的说明,在你的 AI 助手中安装 @user_ac9585d3/platform-marketing-poster-poster-resource。
技能介绍
要解决什么问题
在海外运营平台里添加海报时,前端或 Agent 往往需要先拿到平台侧可用的海报素材(图片、模板资源等),再进入选图、裁剪或提交海报配置的后续步骤。若把 getPosterResource 混进一个大而全的「海报模块」工具里,编排、重试和权限错误会很难拆清楚。本技能把这一动作收成最小颗粒度:只负责一次 GET 查询,把接口原样结果交给上层继续编排。
技能如何工作
- 固定正式环境:执行器使用 frontmatter 中的
base_url(https://www.kutetailor.com/api/marketing/poster/getPosterResource),不接受用户输入覆盖域名或环境。 - 单一 action:
poster_resource→ GET/poster/getPosterResource,无 path/query/body 必填项(仍受登录态与租户权限约束)。 - 参数约定:tool 参数统一放在嵌套对象
params最外层;需要登录时在params.accessToken生成Authorization: Bearer …(值里已有Bearer则勿重复拼接);path/query/body/headers 分别写入params.path、params.query、params.body、params.headers。 - 返回与错误:以接口响应为事实来源,返回类型记为 RS;不要自行补造库存、价格、订单号或物流类字段。认证、权限、参数或业务错误时,把原始错误码与错误信息透传给上层 Agent。
适用边界
本技能不完成「创建海报、上架、投放」等完整链路;多步业务应由上层 Agent 按聚合 skill platform-marketing-poster 或计划文档组合多个原子 skill。若你的需求不止「添加海报前拉素材」,请在本步之后接其它接口 skill。
使用场景
- 海外运营平台「添加海报」流程里,Agent 在展示可选素材前需先调用 getPosterResource 拉取平台资源列表
- 编排 platform-marketing-poster 多步链路时,本步只负责 GET 素材,再把 RS 交给选图或创建海报的后续 skill
- 对接 kutetailor 正式环境营销接口,在已持有 accessToken 的前提下为海报配置页预加载素材数据
- 用户口述「加海报前先拿素材」且无需其它接口时,由上层只触发 poster_resource 这一原子动作
适合人员
- 负责酷特/kutetailor 海外运营后台对接、要在添加海报页接入素材接口的后端或全栈工程师
- 用多个原子 skill 拼装营销海报链路的 Agent 编排者,需要明确本步只读 getPosterResource
- 维护 platform-marketing-poster 聚合文档、要把 poster_resource 与创建/上架步骤拆开的平台集成同学
- 在测试正式环境固定 base_url 与 Bearer 登录态下,排查海报素材为空或权限错误的接口联调人员