mcpField
A
auth-setup

auth-setup

github.com/goldsky-io云与 DevOps124.1k 次安装今天更新
代码仓库

关于 auth-setup

用于安装 Goldsky CLI、完成登录并配置项目的技能，面向管理 pipelines 和 subgraphs 的用户。它要求逐步验证安装与认证状态，并涵盖项目创建和团队邀请。

主要功能

  1. 01安装并验证 Goldsky CLI
  2. 02通过浏览器登录并验证认证
  3. 03列出及创建项目
  4. 04邀请项目成员并设置角色

适用场景

  1. 01配置 Goldsky 项目环境
  2. 02登录后检查项目访问权限
  3. 03创建项目并邀请团队成员

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/goldsky-io/goldsky-agent --skill auth-setup

安装后在 Claude Code 中输入/auth-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
trigger-eval.json
references/
windows.md
scripts/
install.ps1
install.sh

详细介绍

Goldsky 身份验证与项目设置

设置 Goldsky CLI，验证你的帐户，并为你的管道和子图配置项目。

先决条件

  • macOS、Linux 或带有 WSL 的 Windows（有关二进制文件兼容性，请参阅步骤 1）
  • 互联网连接
  • Goldsky 帐户。请在步骤 3 中通过浏览器创建帐户。不要让用户单独前往注册。

身份验证工作流

请按此工作流操作并验证每个步骤。执行命令并检查结果。

步骤 1：安装并验证 CLI

自行安装缺少的工具。不要要求用户安装二进制文件或输入 sudo 密码。你将在步骤 3 中运行登录命令。用户只需在浏览器中批准。

在 macOS 和 Linux（包括 WSL）上，从此技能所在目录运行捆绑的安装程序。自行解析该路径。不要询问用户路径。

bash scripts/install.sh

默认安装 Goldsky、Compose 和 Turbo。仅需基础 CLI 时，传入 cli。若任务只需 Compose 或 Turbo，请传入 compose 或 turbo；两者都包含基础 Goldsky CLI。该脚本通过 npm install --global --prefix "$HOME/.local" 安装 @goldskycom/cli@^13.17.0（最新的 13.x 版本，至少为 13.17.0；不使用 sudo，也不使用 @latest），然后针对所请求的扩展运行 goldsky compose install 和 goldsky turbo install。如果 goldsky turbo install 不是有效命令，脚本会以状态码 1 退出。它不会下载或执行远程 shell 脚本。缺少 npm 即视为失败。它要求每个所请求命令的版本检查都成功。无需登录。

每次新的 shell／工具调用都必须恢复 PATH，包括下面的身份验证和项目命令。之前工具调用中的导出不会保留：

export PATH="$HOME/.local/bin:$HOME/.goldsky/bin:$PATH"
goldsky --version
goldsky compose --version
goldsky turbo --version

仅检查所请求的组件。若 Turbo 二进制文件缺失，不要触发 Turbo 的交互式自动安装程序。如果安装程序或必要的版本检查失败，不要报告设置已完成。

平台限制： goldsky turbo install 会强制执行已发布的 Turbo 二进制文件限制。失败时不要通过 curl 获取备用版本，也不要要求用户使用 sudo。当前 Linux Turbo 二进制文件要求 x64 和 glibc 2.39+（例如 Ubuntu 24.04）。当前 Turbo Mac 二进制文件仅支持 Apple Silicon。Goldsky 和 Compose 发布了适用于 macOS Intel／Apple Silicon 以及 Linux x64／ARM64 的二进制文件，因此即使无法安装 Turbo，仍可安装 compose。请报告 CLI 的错误。Turbo 安装失败不代表完整安装成功。

**Windows：**目前，完整工具集只能在 WSL 中运行，不能在原生 PowerShell 或 Git Bash 中运行：Compose 没有已发布的 Windows 二进制文件。请使用现有的 x64 Ubuntu 24.04+ WSL 发行版来运行所有三个工具。有关 PowerShell 调用方式和先决条件，请参阅 Windows 设置。安装、后续 CLI 命令、项目文件和 goldsky login 必须在同一个 WSL 环境中进行。请在该环境中自行运行登录命令。安装／启用 WSL 本身可能需要管理员权限并重启；不要声称这一先决条件总能在无需干预的情况下自动完成。

所选环境中的先决条件：Bash、npm、CA 证书、标准 Unix 实用工具、互联网访问权限，以及可写的主目录。如果环境缺少其中任何一项，请报告缺失的先决条件，不要声称安装成功。不要为了将远程安装程序通过管道传入而安装 curl。

步骤 2：检查身份验证状态
goldsky project list 2>&1

**已登录：**输出会显示包含项目 ID 和名称的表格。跳到步骤 4。

**未登录：**输出包含 Make sure to run 'goldsky login'。继续步骤 3。

步骤 3：登录

绝不要在聊天中处理用户的 API 令牌。 粘贴到对话中的令牌会出现在聊天记录中，并被发送给模型。不要向用户索要令牌，也不要传递 --token。

恢复 PATH 后，亲自运行 goldsky login，并让它最多运行 5 分钟。它会输出一个 URL、打开浏览器，并将令牌写入磁盘。令牌不会被输出。用户只需在这台机器上的浏览器中批准登录。创建账户或选择项目也在浏览器中完成。如果浏览器没有打开，请自行打开输出的 URL。只有在无法打开浏览器时，才将该 URL 提供给用户。

如果此主机在登录完成前终止了命令，请重新运行。只有在没有 shell 的情况下，才将命令交给用户。然后进行验证（步骤 4）。

步骤 4：验证登录

登录后务必进行验证：

goldsky project list

成功： 退出代码为 0，并显示包含项目的表格

失败迹象：

  • 仍然出现 Make sure to run 'goldsky login'
  • 出现 invalid token 或 unauthorized

如果验证失败，请重新运行 goldsky login。

完成摘要

设置成功后，向用户提供摘要：

## Setup Complete

**What was done:**
- ✓ Goldsky CLI installed (version X.X.X)
- Turbo: verified version, not requested, or explicit installation failure
- Compose: verified version, not requested, or explicit installation failure
- ✓ Authenticated to Goldsky
- ✓ Connected to project: [project-name]

**Your available projects:**
[List projects from goldsky project list output]

**Next steps - try these skills:**
- `/secrets` - Set up credentials for pipeline sinks (PostgreSQL, ClickHouse, Kafka)
- Ask "create a pipeline" to start building data pipelines
- Ask "deploy a subgraph" to deploy a subgraph to Goldsky

如果用户尚未说明想做什么，请询问，并且只建议已安装的技能能够完成的任务。在用户选择并同意之前，不要创建机密、管道、子图或部署。

命令参考

命令用途关键标志
goldsky login使用 Goldsky 进行身份验证打开浏览器。不要传递 --token
goldsky logout删除本地凭据
goldsky project list列出你所属的所有项目
goldsky project create创建新项目--name（必填）
goldsky project users list列出当前项目中的用户
goldsky project users invite邀请用户加入项目--emails、--role

常见模式

创建新项目
goldsky project create --name "my-new-project"
邀请团队成员
goldsky project users invite --emails [email protected] --role Editor

可用角色： Owner、Admin、Editor、Viewer

切换账户
goldsky logout
goldsky login
# MUST verify after: goldsky project list

错误模式

模式含义
Make sure to run 'goldsky login'尚未通过身份验证
invalid token / unauthorized令牌不正确或已过期
Permission denied / 403用户缺少所需角色
token expired / session expired需要重新进行身份验证

故障排除

问题操作
安装程序要求确认或 sudo使用内置安装程序。它会通过 npm 安装到 $HOME/.local，且不会使用 sudo。不要使用 sudo 或远程 shell 脚本重试
缺少 turbo 或 compose，或无法运行重新运行该组件的内置安装程序。如果 goldsky turbo install 不是有效命令，请停止。不要使用 curl 下载安装程序
未登录亲自运行 goldsky login，并让它持续运行，直到浏览器登录完成
令牌无效重新运行 goldsky login。不要索要令牌
权限被拒绝用户需要由项目 Owner/Admin 提升角色
会话已过期重新运行 goldsky login

相关内容

身份验证完成后，建议以下后续步骤：

  • /turbo-builder — 交互式构建并部署新管道
  • /datasets — 为你的用例查找合适的数据集
  • /secrets — 为管道接收端设置凭据（PostgreSQL、ClickHouse、Kafka 等）

评论

支持 Markdown