| name | rancher-cluster-management |
| description | This skill should be used when the user asks to "list clusters", "show clusters", "cluster overview", "list projects", "which clusters", "compare clusters", "cluster status", "集群列表", "项目列表", "集群概览", "集群状态", "集群对比", or discusses Rancher cluster and project navigation (集群和项目管理). |
| version | 1.0.0 |
Rancher 集群管理
导航和管理 Rancher 多集群环境。简单查询直接执行；复杂的多集群分析委托给 Sub-Agent。
直接操作（无需 Sub-Agent）
这些简单操作立即执行：
| 操作 | 工具 | 何时直接使用 |
|---|
| 列出集群 | mcp__rancher__cluster_list | 用户要求查看集群列表 |
| 按名称搜索集群 | mcp__rancher__cluster_list | 提供集群名称关键词 |
| 列出项目 | mcp__rancher__project_list | 用户要求查看项目列表 |
| 按集群列出项目 | mcp__rancher__project_list | 提供集群 ID |
Sub-Agent 委托
rancher-cluster-explorer
用于: 集群概览、容量分析、多集群对比
何时委托:
- 用户要求"集群概览"或"集群健康状况"
- 用户要求对比多个集群
- 用户需要集群容量和资源使用信息
参数:
{
"action": "cluster_overview" | "compare_clusters",
"cluster": "c-abc123",
"clusters": ["c-abc123", "c-def456"]
}
决策树
用户请求：
├─ "列出集群" / "list clusters" / "show all clusters"
│ └─ 直接使用 cluster_list
│
├─ "列出项目" / "list projects" + 集群名/ID
│ └─ 直接使用 project_list
│
├─ "集群概览" / "cluster overview" / "cluster health"
│ └─ 委托给 rancher-cluster-explorer（包含容量和节点分析）
│
├─ "对比集群 A 和 B" / "compare clusters"
│ └─ 委托给 rancher-cluster-explorer（并行分析多集群）
│
└─ "哪个集群有空间" / "which cluster has capacity"
└─ 委托给 rancher-cluster-explorer（并行获取容量）
并行执行
多集群概览
用户: "对比 production 和 staging 集群"
→ 并行启动：
Agent 1: rancher-cluster-explorer（集群 A 概览）
Agent 2: rancher-cluster-explorer（集群 B 概览）
→ 合并对比展示
全集群扫描
用户: "所有集群的状态"
→ 步骤 1: 直接调用 cluster_list 获取所有集群
→ 步骤 2: 为每个集群并行启动 explorer Agent
→ 步骤 3: 汇总展示
工作流
步骤 1: 识别操作类型
- 简单列表？→ 直接调用 MCP 工具
- 需要概览/对比？→ 委托给 Sub-Agent
步骤 2: 获取集群 ID
如果用户提供集群名称而非 ID：
→ 使用 cluster_list（name: "关键词"）搜索
→ 获取匹配的集群 ID
步骤 3: 执行并展示结果
响应格式
集群列表
## 可用集群
| 集群 | ID | 状态 | 节点数 | Provider |
|------|-----|------|--------|----------|
| production | c-abc123 | Active | 5 | Custom |
| staging | c-def456 | Active | 3 | Custom |
集群概览
## 集群概览: production (c-abc123)
### 基本信息
- 状态: Active
- 节点数: 5
- 项目数: 3
### 资源容量
| 资源 | 请求 | 限制 | 实际使用 |
|------|------|------|----------|
| CPU | 65% | 120% | 45% |
| 内存 | 70% | 90% | 60% |
### 节点状态
| 节点 | 状态 | CPU | 内存 | Pod数 |
|------|------|-----|------|-------|
| node-1 | Ready | 55% | 62% | 42 |
| node-2 | Ready | 72% | 78% | 38 |
错误处理
- 集群未找到: 列出所有可用集群供用户选择
- 权限不足: 告知用户检查 Rancher token 权限
- 集群不可达: 显示集群状态，建议检查网络连接
