技能介绍

解决的问题

在企业运营场景里，CRM 中的客户分组信息往往和其他接口能力混在一起。上层 Agent 想完成一次「拿到客户分组」的动作，通常要自己拼认证头、拼 URL、处理错误，再决定下一步怎么走。任何一环出问题——比如 Authorization 重复加了 Bearer、base_url 被用户输入覆盖——都会让后续链路拿到不可信的数据。

这个 skill 把这件事压缩成一个原子动作：调用 GET /customer/group-user/getAllCusGroupInfo，拿到分组信息后交给上层 Agent。它不负责编排，也不补全其他字段。

核心能力与调用方式

动作固定为 group_list，HTTP method 为 GET，正式环境地址写在 frontmatter 的 base_url 中，不接受用户输入覆盖。
参数统一放在嵌套的 params 对象里，最外层只出现 params，不要写 params.xxx 这类点号顶层 key。
Path 参数放 params.path，Query 参数放 params.query（例如 groupId），JSON body 放 params.body，额外请求头放 params.headers。
登录态通过 params.accessToken 生成 Authorization: Bearer 头；如果传入值已包含 Bearer，不要重复拼接。
POST/PUT 默认发送 JSON body；如果上层接口网关另有约定，以网关契约为准。

适用边界与注意点

这是查询/计算类接口，仍需遵守当前登录态、租户和用户权限。接口返回什么就是什么，不要补造库存、价格、订单号、优惠金额或物流状态。
如果接口返回认证、权限、参数或业务错误，把原始错误码和错误信息透传给上层 Agent，不要吞掉或改写。
当用户需求需要多个接口步骤时，由上层 Agent 按聚合 skill（例如 platform-customer-crm）或计划文档编排多个原子 skill，本 skill 只完成本接口调用，并把关键返回字段交给后续 skill。