Elasticsearch
Elasticsearch全栈操作助手，从映射到集群健康
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Elasticsearch。 它的用途是：Elasticsearch全栈操作助手，从映射到集群健康 完整的 Skill 内容见：https://321skill.com/skills/elasticsearch-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的Elasticsearch集群状态变黄，索引logs-2025有3个分片未分配，请帮我诊断并修复。' 它会先请求集群健康状态，然后调用分配解释API分析原因，建议如'调整节点磁盘阈值'或'手动reroute分片'，并给出具体curl命令。
介绍
该技能专门解决Elasticsearch使用中的高频痛点：当你编写搜索查询或索引映射时，遇到搜索返回空结果或错误文档、text字段上的term查询返回0命中但无报错、搜索结果排序差、聚合报错“fielddata is disabled”、集群状态变黄或变红、分片无法分配、索引速度慢或批量请求出现逐项错误、磁盘达到洪水水位导致索引只读、断路器触发、或分页超过10000条时，这个技能都能提供诊断与修复方案。
使用时，只需描述你遇到的ES问题或需要执行的操作，技能会分析当前集群状态、检查索引和映射配置，并给出具体的查询DSL、聚合语法、索引设置调整建议，甚至直接生成可执行的REST API调用命令。它覆盖了从索引映射设计、分析器配置、查询DSL编写、聚合操作，到批量索引优化、分片大小调整、集群健康管理，以及ILM滚动、重建索引、快照、升级、kNN和混合向量搜索、自动补全、同义词、嵌套模型、地理查询、ES|QL、Painless脚本、摄取管道、数据流、安全设置、语言客户端和OpenSearch兼容性等全场景。
适合运维工程师、后端开发者和全栈开发者，尤其是那些需要深度管理Elasticsearch集群、排查性能问题或构建复杂搜索应用的团队。也适合需要从传统搜索迁移到向量搜索或混合搜索的开发者。
使用建议：确保你的ES集群版本与技能建议的API兼容（建议7.x以上）。对于生产环境，先在小范围测试索引变更或分片分配操作。技能可配合Curl或Kibana Dev Tools使用，但不会直接修改集群数据，所有操作需用户确认后执行。
核心特点
与通用的ES查询工具不同，该技能不仅提供语法建议，还能主动诊断集群健康问题（如分片未分配、磁盘水位），并给出修复命令和参数调优方案，覆盖从映射设计到运维排障的全生命周期。
注意事项
不适合作为独立向量数据库或轻量级站点搜索使用，需要已部署的Elasticsearch集群。
常见问题
聚合报错“fielddata is disabled”如何解决？
对text字段启用fielddata：PUT index/_mapping { "properties": { "field": { "type": "text", "fielddata": true } } }，或改用keyword子字段进行聚合。
索引速度慢怎么办？
建议使用批量索引（bulk API），调整刷新间隔（index.refresh_interval），暂时关闭副本，或增大分片缓冲区大小。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/elasticsearch-x-3/raw/index.md 读取 Elasticsearch 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/elasticsearch-x-3/raw/index.md（查看排版版本）