Agent Skills
返回列表
C站链接配置查询

C站链接配置查询

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-csite-website-docking-by-user。

技能介绍

要解决的问题

在对接海外运营平台的 C 站业务时,开发者经常需要根据用户 ID 获取其对应的链接配置。如果直接硬编码接口调用,每次对接都要重复处理认证头拼接、查询参数编码、错误响应解析等细节。更麻烦的是,当业务流程涉及多个接口步骤时,单点调用很容易遗漏权限校验或返回字段处理,导致链路在生产环境出问题。

这个 skill 把「通过 userId 查询链接配置」封装成一个可被 agent 直接调用的原子动作,让上层逻辑只关注业务编排,不用重复实现底层 HTTP 细节。

技能如何工作

核心能力只有一个接口动作 docking_by_user:

  • 请求方式:GET 到固定地址,正式环境为 https://www.kutetailor.com/api/fabric/docking/public/c/get
  • 查询参数:userId,通过 params.query 传入
  • 认证方式:params.accessToken 自动拼接为 Authorization: Bearer,若传入值已含 Bearer 则不重复添加
  • 参数约定:所有参数必须放在嵌套的 params 对象内,最外层不允许出现点号 key

调用流程大致如下:

  1. 上层 agent 构造 params 对象,填入 userId 和 accessToken
  2. skill 从 frontmatter 读取固定 base_url,拼接 Query 参数
  3. 发起 GET 请求,携带认证头
  4. 将接口原始响应返回给上层,不补造任何字段

适用边界与注意点

需要明确几点:

  • 单一职责:这是最小颗粒度接口 skill,只完成本次查询。如果用户需要「先查用户信息→再查链接配置→最后跳转」,需要上层 agent 自行编排多个原子 skill
  • 权限约束:虽然接口路径包含 /public/,但仍受登录态、租户和用户权限约束,调用前必须确保 accessToken 有效且有对应权限
  • 错误透传:遇到认证、权限、参数或业务错误时,skill 不吞掉异常,而是把原始错误码和错误信息完整传给上层 agent,由上层决定如何处理
  • 地址锁定:正式环境地址固定在 frontmatter 中,调用时不接受用户输入覆盖,避免误连测试环境

使用场景

  • 用户在kutesmart海外运营平台配置C站链接,系统需根据当前userId查询对应的链接配置并返回
  • 当用户输入需要跳转到C站时,上游agent已通过登录态校验,需用userId调docking_by_user获取跳转地址
  • 开发者将本skill作为聚合skill的子步骤,在上层编排中先取userId再查链接配置,最后拼接到业务链路
  • 当多个接口组合成完整业务链路时,本skill只负责docking_by_user单步,调用后将RS返回字段交给后续skill处理

适合人员

  • 负责kutesmart海外运营平台集成的后端工程师,需要通过userId查询C站链接配置并处理RS返回
  • 编写聚合skill或agent编排逻辑的研发人员,需要将docking_by_user作为原子步骤嵌入多接口业务流程
  • 调试C站跳转问题的技术支持或运维工程师,需要根据用户输入的userId直接调用接口验证链接配置返回
  • 搭建多接口链路的全栈开发者,关注单步返回字段如何传递给后续skill并保持参数嵌套规范