用途：列出 TrueFoundry 的工作区（Workspace）与集群（Cluster）。工作区是部署目标，集群是底层基础设施。适合在部署前查找工作区 FQN、检查集群连通性、发现可用 GPU 类型与基础域名。
优先执行方式：简单读取/列表操作优先使用 MCP 工具调用 tfy_clusters_list 与 tfy_workspaces_list；若 MCP 服务器未配置或工具缺失，自动回退到通过 tfy-api.sh 直接调用 API。直接调用时需将 TFY_API_SH 设为该技能 scripts/tfy-api.sh 的完整路径，路径参见 references/tfy-api-setup.md。
推荐流程为集群→工作区：先列出集群让用户选择，再按所选集群过滤工作区。不要要求用户手动设置 TFY_CLUSTER_ID。 集群列表：工具 tfy_clusters_list()；API $TFY_API_SH GET /api/svc/v1/clusters。 按集群过滤工作区：工具 tfy_workspaces_list(filters={"cluster_id": "selected-cluster-id"})；API $TFY_API_SH GET '/api/svc/v1/workspaces?clusterId=SELECTED_CLUSTER_ID'。关键字段 fqn 即部署所需的 TFY_WORKSPACE_FQN。若用户仅能访问一个集群，可跳过集群选择直接列出工作区。
其他查询：列出全部工作区 tfy_workspaces_list() 或 $TFY_API_SH GET /api/svc/v1/workspaces；获取指定工作区 tfy_workspaces_list(workspace_id="ws-id-here") 或 $TFY_API_SH GET /api/svc/v1/workspaces/WORKSPACE_ID；集群详情 tfy_clusters_list(cluster_id="cluster-id") 或 $TFY_API_SH GET /api/svc/v1/clusters/CLUSTER_ID，连接状态、addons 分别用 /is-connected、/get-addons 接口。
基础域名：公网暴露服务需用集群基础域名构造合法主机名，否则部署失败，详见 references/cluster-discovery.md。可用 GPU 类型：可查集群 addons/节点池，或从部署报错信息中获知有效类型；并非所有类型在每个集群可用，应先查询再提供选项，详见 references/gpu-reference.md。
限制：工作区列表可能为空，原因包括所选集群无工作区、API 密钥无权限，或需换集群；权限不足时无法列出工作区。