Kutesmart B 端营销海报列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-marketing-poster-poster-list。
技能介绍
要解决什么问题
在海外运营平台的 B 端场景里,运营或内部工具经常需要按条件拉取已配置的营销海报列表(分页、筛选等),而不是手工拼 URL 或混用多套参数命名。本技能只做一件事:在已登录前提下,调用 Kutetailor 正式环境的 GET /api/marketing/poster/getPosterList,把接口原样返回的分页结果交给上层 Agent 或后续 skill 继续编排。
技能如何工作
执行器使用 frontmatter 里固定的正式环境 base_url(https://www.kutetailor.com),不接受用户输入覆盖地址。调用约定与其它平台原子接口一致:
- 工具参数最外层只放嵌套对象
params,不要用params.xxx这类点号顶层 key - Query 条件写入
params.query,对应文档中的 ListPosterRequest - 登录态通过
params.accessToken生成Authorization: Bearer;若传入值已含Bearer前缀则不再重复拼接 - 可选的 Path / Body / 额外 Header 分别写入
params.path、params.body、params.headers(本动作为 GET,主要使用 query)
返回字段以接口响应为唯一事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递,由上层决定重试、换 skill 或提示用户。
适用边界与注意点
- 这是最小颗粒度接口 skill,仅覆盖
poster_list;完整「选海报 → 详情 → 投放」链路需由上层按聚合 skill 或计划文档组合多个原子 skill - 仍需遵守当前租户、用户权限;本 skill 不会补造库存、价格、订单号等字段
- 若用户需求包含多步接口,本 skill 只完成列表查询一步,并把关键返回字段交给后续步骤
使用场景
- 海外运营后台要按活动或状态筛选海报,需调用 getPosterList 拉取分页列表再交给上层做投放决策
- Agent 编排「先列海报再查详情」时,第一步用本 skill 带 ListPosterRequest 查询条件取 IPage 结果
- 内部工具集成 Kutetailor 正式环境,运营同学输入 accessToken 后需同步展示当前租户可管理的 B 端海报目录
- 排查某张海报在后台是否存在时,通过列表接口按名称或 ID 条件检索,避免手工拼正式环境 URL
适合人员
- 负责 Kutetailor 海外运营后台配置与巡检、需要程序化读取 B 端海报分页列表的运营同学
- 把 platform-marketing-poster 拆成多原子 skill 编排的 Agent 开发者,需在链路里固定调用 poster_list 一步
- 维护企业内海报管理小工具的后端,要把 Bearer 登录态与 ListPosterRequest 按平台规范传给正式环境
- 做多租户权限联调时,需要把接口原始错误码与分页字段原样回传以便定位认证或参数问题