Elasticsearch
Elasticsearch 全方位操作与优化专家
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Elasticsearch。 它的用途是：Elasticsearch 全方位操作与优化专家 完整的 Skill 内容见：https://321skill.com/skills/elasticsearch-x-10/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我的Elasticsearch集群变黄了，分片未分配，请帮我排查原因。”它会分析集群状态，建议使用GET _cluster/allocation/explain查看详情，并给出修复方案，如磁盘空间不足时清理节点或调整水印阈值。又如：“我需要优化一个聚合查询，它在大量数据上执行很慢。”它会建议使用composite聚合、调整shard size、或启用doc_values来加速。
介绍
这个 Skill 专为解决 Elasticsearch 使用中的各种疑难杂症而设计，涵盖索引映射、分析器配置、查询 DSL、聚合、批量索引、分片大小、集群健康等核心场景。当您遇到搜索返回空结果或文档错误、text 字段的 term 查询返回零命中、搜索结果排序不理想、聚合报错“fielddata 被禁用”、集群状态变为黄色或红色、分片未能分配、索引速度缓慢、批量请求返回逐项错误、磁盘水位达到洪水阶段导致索引只读、断路器触发、或分页超过 10000 条时，这个 Skill 能提供精准的诊断和修复方案。它还覆盖了 ILM 滚动更新、重建索引、快照、升级、kNN 和混合向量搜索、自动补全、同义词与分析器、嵌套建模、地理查询、ES|QL、Painless 脚本、摄取管道、数据流、安全配置、语言客户端以及 OpenSearch 兼容性等高级功能。
使用方式非常简单：您只需将 Elasticsearch 遇到的问题或想要执行的操作描述给 AI，Skill 会自动分析上下文并给出具体的命令、配置示例或调试步骤。例如，您可以问“为什么我的 term 查询在 text 字段上返回 0 条结果？”它会解释 text 字段的分词机制，并建议改用 keyword 字段或 match 查询；或者问“集群变黄了，如何修复？”它会指导您检查未分配分片的原因并重新分配。
这个 Skill 适合所有需要与 Elasticsearch 打交道的技术人员，包括后端开发工程师在设计索引映射和查询时使用，运维工程师在维护集群健康、优化分片分配时使用，以及数据分析师在构建聚合查询和数据分析管道时使用。它也适合需要处理日志分析、全文本搜索、向量搜索等场景的团队。
使用建议：请确保您的环境已正确连接 Elasticsearch 集群，并拥有相应的权限。对于复杂问题（如集群故障），建议先在测试环境中验证修复步骤。此外，注意该 Skill 专注于 Elasticsearch 本身，不适合作为独立的向量数据库（如 Pinecone）或轻量级站点搜索（如 Meilisearch）的替代方案。
核心特点
与同类 Skill 相比，它覆盖了从开发到运维的全链路 Elasticsearch 深度操作，包括索引映射设计、查询 DSL 优化、聚合分析、集群健康诊断、性能调优、安全配置等，而不仅仅是简单的查询或索引创建。
注意事项
不适合作为独立向量数据库（如 Pinecone）或轻量级站点搜索（如 Meilisearch）使用。
常见问题
为什么 term 查询在 text 字段上返回 0 条结果？
text 字段会被分词器拆分为多个词项，term 查询不会进行分词，因此无法匹配。建议改用 match 查询，或使用 keyword 字段进行 term 查询。
集群状态变黄/红怎么办？
先检查未分配分片的原因，通常使用 GET _cluster/allocation/explain 查看详细信息，然后根据原因（如磁盘空间不足、节点故障等）采取相应措施，如增加节点、调整副本数或重新分片。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/elasticsearch-x-10/raw/index.md 读取 Elasticsearch 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/elasticsearch-x-10/raw/index.md（查看排版版本）