酷特海外运营·按用户名查账号
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-member-account-member-by-username。
技能介绍
要解决什么问题
在海外运营平台里,客服、运营或内部 agent 经常需要按用户名定位账号,再去做权限核对、订单关联或后续编排。若每次都在对话里手写 GET 地址和参数,容易混用环境、漏传登录态,或把多个接口步骤塞进一个「大工具」里难以维护。
本技能是最小颗粒度的原子接口 skill,只负责 member_by_username 这一动:根据 username 查询单个会员账号,并把接口真实返回交给上层继续编排。
技能如何工作
- 固定正式环境:执行器使用 frontmatter 中的
base_url(https://www.kutetailor.com/api/member),调用GET /member/getMemberOne,不接受用户输入覆盖 base_url。 - 统一参数形状:tool arguments 最外层只放嵌套
params;Query 写入params.query(本接口为username);需登录态时用params.accessToken生成Authorization: Bearer(值已含Bearer则不重复拼接)。 - 返回以接口为准:响应字段以平台 RS 为事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息传给上层 agent,不要自行补造账号、订单或库存类数据。
适用边界与注意点
- 用户若需要「查账号 + 改资料 + 下单」等多步链路,本 skill 只完成查账号这一步;完整业务应由上层 agent 按聚合 skill(如
platform-member-account)或计划文档组合多个原子 skill。 - 仍是查询类接口,须遵守当前登录态、租户与用户权限;无权限时以接口错误为准,不要猜测结果。
使用场景
- 客服收到海外用户报的用户名,需先调用平台接口确认该用户名对应哪条会员账号再处理工单
- 编排 agent 在下单或改资料前,用 username 查询 getMemberOne 拿到会员主键与状态字段
- 核对运营后台名单与平台账号是否一致时,按名单中的用户名逐条查询会员记录
- 上层聚合 skill platform-member-account 编排链路中,单独执行 member_by_username 这一步并传递 RS 结果
适合人员
- 处理酷特海外运营平台工单的客服,需要按用户提供的 username 核实会员是否存在及基础信息
- 编写多步业务 agent 的集成工程师,要把 member_by_username 作为原子节点接入 platform-member-account 编排
- 海外运营同学在做账号盘点或风控复核时,需批量或单次按用户名拉取单个会员接口结果
- 对接 kutetailor.com 正式环境 member API 的后端开发,需统一 params.query.username 与 Bearer 登录态约定