用途:该技能面向 TrueFoundry 平台的初始配置与访问管理,覆盖凭证连通性检查(preflight)、集群与工作区发现、角色/团队/协作者管理、密钥组管理及个人访问令牌(PAT)与虚拟账户(VAT)的创建。
主要能力:通过脚本调用 REST API,列出集群(GET /api/svc/v1/clusters)、按集群筛选工作区(GET '/api/svc/v1/workspaces?clusterId=...')并获取 fqn;查看 GPU 类型与集群基础域名;邀请用户(POST /api/svc/v1/users/invite);列出/创建角色、团队与协作者(/api/svc/v1/roles、/teams、/collaborators);管理密钥组(/api/svc/v1/secret-groups);列出与创建 PAT、管理虚拟账户及其令牌。
使用方式:先确认环境变量 TFY_BASE_URL、TFY_HOST、TFY_API_KEY,再用 TFY_API_SH=~/.claude/skills/truefoundry-platform/scripts/tfy-api.sh 调用接口,例如 $TFY_API_SH GET '/api/svc/v1/workspaces?limit=1' 做连通性检查。工作区选择必须先列集群再列工作区,且不可自动选取,需用户确认。授权操作前须确认主体、角色与资源;主体格式为 user:email、team:slug、serviceaccount:name、virtualaccount:name。
限制与安全:密钥值不得在对话中粘贴;令牌值仅在创建或重新生成时显示一次,默认掩码预览,且不得重复、存储或记录;更新密钥组会删除未列出的键,需包含全部键;删除角色、团队、协作者及令牌等破坏性操作应转到控制台执行;服务账号仅可授予已有主体角色,创建服务账号是否支持尚未核实;本技能不负责部署服务、配置 AI Gateway、注册 MCP 服务器、查看日志及首次注册登录。