UCloud UK8S 集群列表

要解决什么问题

在 UCloud 上维护 UK8S（托管 Kubernetes）时，你往往需要先确认当前 Region 里有哪些集群、各自处于什么状态，或在已知 ClusterId 时核对单集群详情。手工登录控制台翻页成本高，也容易和本地 ucloud-cli 的 Region、凭证配置不一致。

本技能把「列集群 / 查单集群」收敛成固定流程：先校验 CLI 环境，再调用列表接口，最后把结果整理成可读表格。

技能如何工作

1. 环境检查：按 references/check-ucloud-cli.md 确认 ucloud-cli 可用且配置正确，避免在无效环境下发起 API 调用。
2. 查询列表：依据 references/ListUK8sClusterV2.md 解析响应。若调用方传入非空的 $ARGUMENTS，将其视为 ClusterId 过滤条件，只返回该集群；否则列出当前 Region 下全部 UK8S 集群。
3. 展示结果：将 ClusterSet 格式化为表格（每行一个集群），并对状态字段做中文说明，例如 RUNNING（正常运行）、INITIALIZING / STARTING（初始化/启动中）、DELETING（删除中）、UPGRADING（升级中）、ABNORMAL / ERROR（异常）等。若集合为空，明确提示当前 Region 无集群；若按 ID 查询，在表格之外补充该集群的详细信息。

接口返回的 RetCode 非 0 时，技能会输出完整的 RetCode + Message 并终止，不吞错误；同时会结合常见原因（权限不足、Region 填错等）给出排查方向。

适用边界与注意点

• 依赖 UCloud ucloud-cli 与 UK8S 列表 API（ListUK8sClusterV2），Region 与账号权限由你本地 CLI 配置决定，技能不会替你切换租户或 Region。
• 过滤参数仅支持通过 $ARGUMENTS 传入 ClusterId；未传参时行为是「全量列表」，不是模糊搜索集群名。
• 状态含义以技能内映射表为准，若控制台与 API 字段有版本差异，应以 API 返回的原始状态值对照文档。