1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | elasticsearch-cluster-health-elastic-agent-skills |
| 作者/维护者 | Elastic(官方) |
| 来源链接 | https://github.com/elastic/agent-skills/tree/main/skills/elasticsearch/elasticsearch-cluster-health |
| 许可证 | Apache-2.0 |
| GitHub Stars / Forks | 603 / 71(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-05 读取) |
| 最新版本 | 技能内标注 0.1.0;仓库主分支最近一次提交 2026-10-29 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;另需 Elastic 官方 elastic CLI(≥ 0.2)并连上集群 |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:集群变黄或变红时,只读地把问题定位到最可能的一个原因,并给出修复建议,而不是丢一堆分片状态给你。
- 只读排障:不改集群状态,先本地化问题、再分类分配决策器(allocation decider),最后给出单一最可能原因。
- 分清主副本:副本缺失与主分片缺失是两种性质——前者影响冗余,后者可能丢数据;技能要求把区别讲清楚。
- 分配失败分类:磁盘水位、分片数上限、节点过滤、感知配置等,按决策器逐类归因。
- 数据丢失意识:涉及主分片未分配时,先提示数据风险与备份状态,再谈修复动作。
- 边界明确:不适用于 Elastic Cloud Serverless(相关 API 由平台托管),也不替代深度调查。
3. 适用场景
所属分类:DevOps 与基础设施。
- 早上巡检发现集群黄了、想知道第一个该看什么的运维;
- 出现未分配分片、分配失败,需要快速归因的 SRE;
- 上线前评估副本与水位设置是否合理的平台工程师;
- 想在动手前先拿到一份只读诊断结论、避免误操作的人。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,CLI 调用方式需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
集群变黄时最容易犯的错是「看到未分配分片就先调副本数」。这个技能把顺序反过来:先只读定位、分类决策器、再给单一结论;涉及主分片时先提醒数据风险。对半夜被叫起来处理告警的人来说,这比一堆 cat API 输出有用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Elastic 官方出品;所属仓库 603 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 8 | 文档与命令对照齐全、结论格式明确;前置是装好 elastic CLI 并有集群访问 |
| 安全性 | 9 | 见下方清单;只读操作,不修改集群状态,不接触凭据内容 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 通过 elastic CLI 执行只读诊断命令,作用域限于目标集群 |
| ② 联网外发 | 只与用户配置的 Elasticsearch 端点通信 |
| ③ 凭据 | 使用 CLI 已配置的凭据,明确禁止猜测或绕过 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Elastic 官方仓库,Apache-2.0 |
| ⑥ License | Apache-2.0,全文可查 |
| ⑦ 维护时间 | 2026-10-29 仍在更新 |
扣分点:技能版本 0.1.0;需要集群与 CLI 才能实操;结论是「最可能原因」,真正确认仍需看日志与监控。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| elasticsearch-query-optimization-elastic-agent-skills | 慢查询诊断与改写 | 管查询性能;本技能管集群与分片状态 |
| logs-search-elastic-agent-skills | 在日志里检索定位 | 面向日志排查;本技能面向分片分配与水位 |
| kibana-anomaly-detection-elastic-agent-skills | 异常检测作业 | 面向时序异常;本技能面向集群健康本身 |
核心差异:同类多查查询或日志,它专门回答「为什么集群不是绿的,最可能是哪一件事」。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-05)。
9. 其他补充
- 标注
universal: true,不绑定单一部署形态;但 Serverless 不在适用范围内。 - 属于
elastic/agent-skills合集(30 个技能),可按需只装这一条。
10. 安装使用方式
git clone https://github.com/elastic/agent-skills
mkdir -p ~/.claude/skills
cp -r agent-skills/skills/elasticsearch/elasticsearch-cluster-health ~/.claude/skills/
装好后说「集群是黄的,帮我定位最可能的原因」,它会先做只读诊断再给修复建议。
11. 注意事项
- 只读:不会替你改副本数或水位,修复动作仍需人工确认。
- 需要
elasticCLI 与集群访问权限。 - Elastic Cloud Serverless 不适用。
- 涉及主分片未分配时,先确认快照与备份再动手。