用途:在任何 TrueFoundry 平台操作之前做预检,确认凭据与连通性是否正常,或诊断认证问题。
主要能力:检查 TFY_BASE_URL、TFY_HOST、TFY_API_KEY 三个环境变量是否设置;通过轻量 API 调用(列出工作区)测试连接;输出状态摘要,标明哪些组件已配置、哪些缺失;发现凭据或连接问题时给出可执行的下一步建议。
使用方式:若已配置 tfy-tool-server,可调用工具 tfy_config_status,返回连接状态、已配置的 base URL 以及 API key 是否设置。也可直接检查环境变量并测试连接,需将 TFY_API_SH 设为该技能 scripts/tfy-api.sh 的完整路径,例如 Claude Code 下执行:~/.claude/skills/truefoundry-status/scripts/tfy-api.sh GET '/api/svc/v1/workspaces?limit=1'。若环境变量未设置,可检查项目根目录的 .env 文件。
适用场景:验证凭据与连通性、排查认证问题。不适用场景:列出工作区、部署、查看运行中应用等,应改用对应技能。
限制与错误处理:401 表示 API key 无效或过期,需重新生成;连接被拒或超时需检查 URL 是否含 https:// 及网络/VPN;缺少变量需通过环境变量或 .env 设置。若 tfy CLI 报 TFY_HOST 未设置,可执行 export TFY_HOST="${TFY_HOST:-${TFY_BASE_URL%/}}"。新用户可先运行 uv run tfy register,该流程可能打开浏览器进行 CAPTCHA 或人工验证,完成邮箱验证后打开返回的租户 URL 并创建 PAT。API key 获取地址:https://docs.truefoundry.com/docs/generating-truefoundry-api-keys。状态正常后可使用其他技能;如需持久化凭据,可用 tfy_config_set。