SuperAPI AI 工具集

setup

通用与其它

查看项目

更新于 10-22 06:33

技能介绍

用途:setup 是 Spacefast 插件体系中的一个入门技能,用于检查 Spacefast 连接状态,并基于用户请求和已有对话继续其任务。它强调复用已建立的任务上下文,不让用户重复描述,并在用户把工作带到 Spacefast 发布时直接开始发布流程。

主要能力:

  • 连接检查:支持两类连接方式。On-Device MCP 使用本地已有的 Spacefast 登录或已配置的服务凭据,若账户读取需要认证,按返回的登录指引操作,不要求用户为本地 stdio 连接进行主机 OAuth。托管 MCP(https://mcp.spacefast.com)使用连接已配置的认证;直接托管连接走主机的 OAuth 控制,CLI 代理使用其已有的 CLI 登录。认证失败时引导用户通过对应方式重新连接。
  • 账户读取:通过 Spacefast API 工具读取已连接账户。每个 API 操作以操作 ID 命名的 MCP 工具形式提供,例如 getAccount。需要先阅读其输入输出架构,再直接发送声明的 JSON 输入;仅使用该连接公布的工具。读取 getAccount 时以 {} 调用,用户提供引用时可在顶层增加可选的 teamRef 或 spaceRef 字段。
  • 结果处理:保留完整操作结果于工具回执中,检查返回状态与 result.ok,保留失败结果及其后续动作。已完成回执中的账户数据位于 result.data.data。仅报告主体或账户名称以及相关团队名称和 ID,不返回完整账户载荷或凭据。
  • 澄清提问:任务不明确时提出一个简洁问题并等待。对于全新的发布对话,询问“What would you like to build or publish?”;其他操作只询问缺失的细节。

使用方式:

  • 基于用户请求和对话历史继续已建立的任务,不要求用户重复。
  • 连接不可用或工具不可用时,引导用户到主机配置的 Spacefast 连接控制或重新连接,不要在聊天中索要令牌。在读取成功前不报告连接正常。
  • 以一句话确认已连接的账户或服务身份;服务连接不等同于其创建者的个人账户。
  • 复用对话中已确定的 Space;普通发布不需要 Space 选择器。
  • 按需使用主机功能:Space Library 和提及选择器可帮助选择 Space;若 choose_space 可用且需要选择时使用,并尊重取消操作。插件设置、HTML 预览和事件订阅取决于主机支持,不能仅因技能描述就承诺这些功能。

适用场景:初次接入 Spacefast、验证连接与账户身份、继续既有任务、开始发布工作、在需要时选择 Space,以及处理认证或工具不可用等连接问题。

限制:setup 本身不授权发布、更改设置或创建监控;保留用户已给出的任务授权,连接 Spacefast 不要求其重复授权。选定的 Space 仅提供上下文,本身不授权写入。不同主机的功能支持存在差异,未明确提供的功能不应承诺。