Agent Skills
返回列表
KutSmart 建站草稿列表

KutSmart 建站草稿列表

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,在 AI 助手中安装技能 @user_ac9585d3/platform-website-builder-draft-template。

技能介绍

要解决的问题

在 KutSmart 海外运营平台的 C 站建站流程里,第一步往往不是生成站点,而是先拿到当前账号下的草稿列表:用户之前保存过的未发布站点、模板半成品、待继续编辑的站点记录都在这里。这个动作对应一个固定接口 GET /website-info/getDraftTemplate,但真正写代码时麻烦的地方在于:请求地址写在正式环境域名上、鉴权走 Authorization: Bearer、参数要按 path / query / body / headers 分类塞进去,返回结构还得原样透传给下一个环节。如果每次都让上层 agent 重新拼这些细节,出错概率很高。

技能如何工作

这个 skill 只做一件事:完成 draft_template 这个原子接口动作。关键步骤如下:

  • 固定地址:正式环境调用地址写死在 frontmatter 的 base_url 中,执行器不会接受用户输入覆盖域名,避免把请求打到测试环境或被随意改写。
  • 参数结构:tool arguments 统一使用嵌套的 params 对象。最外层只有 params 一个 key,不允许出现 params.xxx 这类点号顶层 key。
  • 鉴权拼接:登录态通过 params.accessToken 生成 Authorization: Bearer;如果传入值本身已经带了 Bearer 前缀,不会再重复拼接。
  • 请求分类:Path 参数写入 params.path,Query 参数写入 params.query,JSON Body 写入 params.body,额外 Header 写入 params.headers。GET/DELETE 的查询条件走 URL query,POST/PUT 默认发送 JSON body,若上层网关另有契约则以网关为准。
  • 事实来源:返回结果以接口响应为准,不会补造库存、价格、订单号、优惠金额或物流状态这类业务数据。

适用边界与注意点

这是一个最小颗粒度接口 skill,不负责完整业务链路。当需求涉及多个接口步骤时,由上层 agent 按聚合 skill(platform-website-builder)或计划文档编排多个原子 skill 完成,本 skill 只执行当前这一步,并把关键返回字段交给后续 skill。

它也不会替你处理登录态、租户切换或权限校验,这些约束来自当前会话上下文,执行时必须遵守。如果接口返回认证失败、权限不足、参数错误或业务错误,skill 会把原始错误码和错误信息原样传给上层 agent,由上层决定是否重试或降级,而不是自行猜测或编造成功结果。

使用场景

  • 用户需要拉取 C 站建站的草稿列表,展示当前账号下未发布的站点记录,供选择继续编辑或发布
  • 上层 agent 编排完整建站流程时,此步先获取草稿列表,取返回字段供后续步骤使用
  • 前端页面需展示用户已保存的草稿模板,后端调用此接口获取实时列表,确保数据准确
  • 需要按登录态筛选当前用户可见的草稿,执行器自动处理鉴权和租户约束,返回对应结果

适合人员

  • 负责 C 站建站的前端或后端工程师,需要在用户打开建站页时展示草稿列表,依赖固定接口和登录态
  • 参与建站工具集成的开发者,需处理草稿列表接口调用,遵守固定地址和鉴权规则
  • 平台运营人员,需要查看用户草稿以提供支持,通过此接口获取准确列表,不手动筛选
  • 构建多步骤建站流程的 agent 开发者,需将此原子技能纳入聚合流程,管理步骤间数据传递