1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | elasticsearch-onboarding-elastic-agent-skills |
| 作者/维护者 | Elastic（官方组织） |
| 来源链接 | https://github.com/elastic/agent-skills/tree/main/skills/elasticsearch/elasticsearch-onboarding |
| 许可证 | Apache-2.0（数据来自 GitHub API，仓库级） |
| GitHub Stars | 546（数据来自 GitHub API，仓库级，该仓库为多技能合集，星数不代表本技能个体热度） |
| Forks | 44（数据来自 GitHub API，仓库级） |
| 最新版本 | 0.1.0（数据来自 SKILL.md frontmatter） |
| 安装方式 | npx skills add elastic/agent-skills --skill elasticsearch-onboarding，或 Claude Code 原生插件市场 |
2. 功能介绍与亮点
- 对话式引导：以“Elasticsearch 解决方案架构师”的身份陪着开发者从模糊的“我想做搜索”逐步问清楚意图、数据形状、编程语言偏好，再生成可直接落地的索引与查询代码，每次只问一个问题、等用户回答后再继续
- 场景库覆盖齐全：内置电商类目搜索、关键词检索、向量/混合检索、RAG 聊天机器人、搜索 UI、MCP 配置、代码生成等专门参考文档，覆盖从传统全文检索到语义/RAG 场景的主流路径
- 先建模后写代码：把索引映射设计（mapping walkthrough）列为最贵的返工点，坚持先过一遍映射确认再生成代码，并推荐带版本号的索引别名（如
products_v1+products_current）等生产可用的最佳实践 - 显式规避过时写法：要求避免使用已废弃的 API，若必须使用会主动解释原因并提示未来兼容性风险
- 与 Elastic 官方产品打通：Kibana 的 onboarding UI 在下载技能配置时会注入
user-context提示，本技能能识别该提示并据此跳过重复提问，直接确认用户场景
3. 适用场景
固定分类：数据分析与可视化
面向初次接触 Elasticsearch、想快速搭建搜索/检索功能但不熟悉索引建模与查询语法的开发者，例如：电商团队想做商品搜索但不确定该从关键词检索还是向量检索入手、想给知识库或文档站接入语义搜索的开发者、需要搭建 RAG 检索层给聊天机器人喂数据的团队、只写过业务代码但没碰过倒排索引与向量索引选型的初中级工程师。不适合已经熟悉 Elasticsearch 索引设计、只需要具体查询语法参考的资深用户（这类需求更适合同仓库姊妹技能 elasticsearch-esql）。
4. 跨 Agent 兼容性
本技能与仓库内其他技能共享同一套安装机制，遵循 Agent Skills 开放规范。Elastic 官方 README 推荐通过 vercel-labs/skills CLI（npx skills add）安装，该 CLI 的受支持 agent 清单明确列出目标平台各自的技能目录映射：
- Claude Code：✅ 原生支持——除通用 CLI 外，仓库还提供 Claude Code 原生插件市场（
claude plugin marketplace add） - Codex：✅ 原生支持（CLI 目标
codex，安装至~/.codex/skills/） - OpenClaw：✅ 原生支持（CLI 目标
openclaw，安装至~/.openclaw/skills/） - Hermes Agent：✅ 原生支持（CLI 目标
hermes-agent，安装至~/.hermes/skills/）
5. 推荐理由
Elasticsearch 的入门门槛集中在“怎么把数据建模成能搜的索引”这一步，网上教程新旧混杂，容易学到过时或不适合自己场景的写法。这个技能把 Elastic 自己的解决方案架构师工作方式打包成对话流程——一次只问一个问题、先确认数据建模再生成代码，覆盖从关键词检索到向量/RAG 的主流路径，特别适合刚接触搜索类需求、不知道从何下手的初中级开发者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Elastic 官方发布（第一方，即 Elasticsearch/Kibana 产品所有者）；所属仓库为多技能合集，546 星为仓库整体数字、不计入单个技能；未找到该子技能自身的独立第三方采用证据 |
| 可用性 | 9 | 纯提示词+参考文档技能，复制目录即可使用，无需额外依赖或付费组件；SKILL.md 加 8 个用例参考文档结构完整；子目录最近一次功能提交为 2026-05-28（对应仓库 release v0.3.0），距今约 2.5 个月 |
| 安全性 | 9 | 检查清单：①技能本身不执行任何 shell 命令，只生成代码供用户在自己环境运行，无权限索取；②不产生任何网络外发，纯对话引导；③不涉及 API key/凭据存储；④未发现可疑指令或隐藏外发；⑤作者为 Elastic 官方，无信誉问题；⑥License 为 Apache-2.0，明确；⑦2.5 个月前有功能提交，非弃置项目 |
综合评分 = 8.33（三项均值）。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 与本技能的差异 |
|---|---|---|
| elasticsearch-esql（同仓库姊妹技能） | ES|QL 查询语法参考与校验 | 面向已确定要用 ES|QL、需要语法正确性校验的场景，不涉及从零开始的索引建模与技术选型 |
| elasticsearch-file-ingest（同仓库姊妹技能） | 批量文件流式导入 Elasticsearch | 解决“数据已确定放进哪个索引、如何高效导入”，前提是索引设计已完成；本技能解决更早一步的“该怎么设计索引” |
| Algolia data-modeling（第三方托管搜索服务技能） | Algolia 平台的数据建模指南 | 服务对象是 Algolia 这一托管 SaaS 搜索服务，不涉及 Elasticsearch 自建/自托管场景下的索引与集群概念 |
| 通用 RAG/向量数据库入门文章（非 skill，静态网络文章） | 一次性写就的说明文档 | 内容固定，不会追问用户实际数据形状与场景细节，也不会生成贴合具体场景的可执行代码 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
无。
10. 安装使用方式
方式一：npx（推荐，跨平台）
npx skills add elastic/agent-skills --skill elasticsearch-onboarding -a claude-code方式二：Claude Code 原生插件市场
claude plugin marketplace add https://github.com/elastic/agent-skills
claude plugin install elasticsearch@elastic-agent-skills注意：该插件按 elasticsearch 分类整体安装，会同时装入同目录下其余 Elasticsearch 技能（含 elasticsearch-onboarding）。
方式三：本地克隆 + 安装脚本
git clone https://github.com/elastic/agent-skills.git
cd agent-skills
./scripts/install-skills.sh add -a claude-code -s elasticsearch-onboarding安装后无需额外依赖安装（纯提示词技能），直接向 agent 描述你想搭建的搜索场景即可触发；建议先明确回答技能主动提出的问题（如“想搜索什么类型的数据”“用什么编程语言”），以获得贴合场景的建议。
11. 注意事项
- 所属仓库 elastic/agent-skills 整体标注为“Technical Preview”（早期发布、持续迭代中），后续版本可能有行为变化
- 本技能只生成建议与代码，不会替用户创建真实的 Elasticsearch 集群或索引，仍需用户自行执行生成的代码
- 面向 Elasticsearch 9.x；旧版本 Elasticsearch 的 API 差异未覆盖