酷特海外运营 App 客户列表

要解决什么问题

在海外运营平台的 CRM 场景里，App 端往往需要按分页、筛选条件拉取客户列表，再交给后续跟进、分配或统计逻辑。若把「登录态、固定网关、参数形态、错误透传」混进一个大 skill，上层 agent 很难稳定复用单一接口。本 skill 只承担 App 客户列表 这一动作：app_customer_list。

技能如何工作

执行器使用 frontmatter 中的正式环境固定地址 GET /customer/appSelectCustomerList（完整域名为 www.kutetailor.com 侧 API），不接受用户输入覆盖 base_url。

调用约定与其它酷特平台原子 skill 一致：tool arguments 最外层仅包含嵌套对象 params：

• Query：分页与筛选条件写入 params.query
• 登录态：params.accessToken 生成 Authorization: Bearer …；若已含 Bearer 前缀则不再重复拼接
• Path / Body / Header：分别使用 params.path、params.body、params.headers（本接口为 GET，以 query 为主）

返回以接口响应为唯一事实来源；遇认证、权限、参数或业务错误时，应把原始错误码与错误信息交给上层 agent，由聚合 skill 或计划文档继续编排。

适用边界

• 本 skill 是 platform-customer-crm 聚合能力下的最小颗粒度接口，单独使用只完成列表查询，不替代完整业务链路。
• 仍需遵守当前租户、用户权限；不要根据返回结果补造客户、订单或库存类字段。
• 若用户需求涉及多步接口（详情、编辑、导出等），由上层 agent 组合多个原子 skill 完成。