1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | elasticsearch-query-optimization-elastic-agent-skills |
| 作者/维护者 | Elastic(官方) |
| 来源链接 | https://github.com/elastic/agent-skills/tree/main/skills/elasticsearch/elasticsearch-query-optimization |
| 许可证 | Apache-2.0 |
| GitHub Stars / Forks | 603 / 71(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-02 读取) |
| 最新版本 | 技能内标注 0.1.0;仓库主分支最近一次提交 2026-10-29 |
| 安装方式 | 把该技能目录复制进 agent 的 skills 目录;另需安装 Elastic 官方 elastic CLI(≥ 0.2)并连上集群 |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与仓库文档。
2. 功能介绍与亮点
一句话:先让查询跑出 profile,再从 profile 里找出真正贵的那一条,改完再测一遍——而不是凭感觉加机器。
- 证据优先:每一步都围绕 search profiling 展开,慢在哪、贵几分,都要有 profile 数据。
- 常见病灶有清单:非评分条件放在评分上下文、前导通配符、脚本字段、过深的 bool 嵌套等,逐条给出改法与预期效果。
- 改完必须复测:同一查询前后 profile 对比,确认延迟下降而不是把开销挪到别处。
- 守住语义:改写只动执行方式,不改匹配结果;报告里要求说明这次改写为什么不改变命中。
- 明确边界:只处理现有的 Query DSL(bool/match/term/wildcard),不负责迁移到 ES|QL;也不把「加分片、扩机器」当首选方案。
3. 适用场景
所属分类:数据分析与可视化。
- 搜索或聚合查询变慢,需要定位到具体 clause 的开发者;
- profile 输出里出现昂贵子句、却不知道从哪改的运维同学;
- 精确匹配被放进了评分上下文、导致大量无谓打分的检索服务;
- 前导通配符拖垮延迟、又不想直接砍功能的搜索产品团队。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文是通用格式,CLI 调用方式需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
慢查询最怕的不是慢,是「凭感觉改」:加机器、加缓存、砍功能,最后不知道哪一下起了作用。这个技能把流程钉死在 profile 上——先证明贵在哪,再改,再复测。对跑 Elasticsearch 的团队来说,这是一套能落地的排查顺序,而不是一堆调优口诀。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Elastic 官方出品;所属仓库 603 stars 是整个合集的热度,不代表本技能自身热度 |
| 可用性 | 8 | 正文完整、命令与 HTTP 简写对照齐全;前置是装好 elastic CLI 并有权访问集群 |
| 安全性 | 9 | 官方开源、纯提示词与命令说明,不执行任意代码、不收集凭据 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 通过 elastic CLI 执行查询与 profile,作用域限于用户自己的集群 |
| ② 联网外发 | 只与用户配置的 Elasticsearch 端点通信,目标透明 |
| ③ 凭据 | 要求使用 CLI 已配置的凭据,明确禁止猜测或直接调 HTTP API 绕过 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Elastic 官方仓库,Apache-2.0,提交历史完整 |
| ⑥ License | Apache-2.0,全文可查 |
| ⑦ 维护时间 | 2026-10-29 仍在更新 |
扣分点:技能版本仍是 0.1.0;需要集群与 CLI 环境,纯本地体验不了。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| elasticsearch-esql-elastic-agent-skills | 用 ES | QL 写查询与分析 |
| logs-search-elastic-agent-skills | 在日志里检索定位问题 | 面向可观测性排障;本技能面向查询性能本身 |
| clickhouse-best-practices-clickhouse-agent-skills | ClickHouse 的建表与查询最佳实践 | 另一个引擎的规范集合;本技能是围绕 profile 的诊断流程 |
核心差异:同类多给「怎么写才对」,它给的是「怎么证明哪里不对、改完怎么证明改对了」。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-02)。
9. 其他补充
- 属于
elastic/agent-skills合集,同仓库还有索引设计、相关性调优、数据摄入等技能,可按需只装一条。 - 依赖 Elastic 官方 CLI 的
stack es能力,版本要求 ≥ 0.2。
10. 安装使用方式
git clone https://github.com/elastic/agent-skills
mkdir -p ~/.claude/skills
cp -r agent-skills/skills/elasticsearch/elasticsearch-query-optimization ~/.claude/skills/
装好后给出慢查询与索引,例如「这条查询要 8 秒,帮我 profile 一下并改到 1 秒内」;它会先跑 profile,再给改法与复测结果。
11. 注意事项
- 需要可用的 Elasticsearch 集群与已配置的
elasticCLI,否则只能看文档不能实操。 - 只覆盖 Query DSL,不负责迁移到 ES|QL,也不处理写入侧性能。
- 版本 0.1.0,接口与命令可能随官方 CLI 变化。
- 生产集群上跑 profile 有额外开销,建议先在从库或低峰期验证。