C站链接配置查询
将以下提示词粘贴到你的 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
调用流程大致如下:
- 上层 agent 构造
params对象,填入userId和accessToken - skill 从 frontmatter 读取固定
base_url,拼接 Query 参数 - 发起 GET 请求,携带认证头
- 将接口原始响应返回给上层,不补造任何字段
适用边界与注意点
需要明确几点:
- 单一职责:这是最小颗粒度接口 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并保持参数嵌套规范