5分钟快速上手:4种方式把Elastic agent-skills装进Cursor、Claude Code与GitHub Copilot

原创2026-11-15 12:11:052,322 阅读

5分钟快速上手:4种方式把Elastic agent-skills装进Cursor、Claude Code与GitHub Copilot

agent-skills 是 Elastic 官方出品的 AI 智能体技能库(Official Elastic Skills),把 Elasticsearch、Kibana、可观测性和安全领域的平台专家经验直接注入你的 AI 编程助手。把它装进 Cursor、Claude Code 或 GitHub Copilot 后,你的 AI Agent 就能正确执行 ES|QL 查询、管理 Kibana 仪表盘、处理 Elastic Cloud 项目——不再胡编过时的 API 用法。

下面用最少的步骤,带你 5 分钟内完成安装。🚀

先了解:Skill 是什么?

每个 Skill 都是一个独立文件夹,核心是一个 SKILL.md 文件,里面包含元数据和 Agent 要遵循的指令。例如 elasticsearch-esql/SKILL.md 教会 Agent 如何执行 ES|QL 查询、聚合指标和生成图表。

仓库中目前有 30+ 个技能,按 5 大领域组织:

领域 典型技能 能做什么
Cloud cloud-setup、cloud-create-project 管理 Elastic Cloud 项目与凭据
Elasticsearch elasticsearch-esql、elasticsearch-file-ingest 写查询、导入数据、安全管理
Kibana kibana-dashboards、kibana-anomaly-detection 建仪表盘、配置告警与 ML 异常检测
Observability edot-java-instrument、logs-search 应用接入 OTel、日志排查、SLO 管理
Security alert-triage、detection-rule-management 告警分诊、SOC 案件与检测规则

完整清单见 README.md 中的 Available Skills 表格。

安装前准备:环境与选型建议

  • 需要已安装目标 AI Agent(如 Cursor、Claude Code、GitHub Copilot CLI)
  • 方式三 npx 需要 Node.js 环境;方式四只需要 bash 3.2+
  • 💡 官方建议:不要一次装全部技能。 每个技能都会占用 Agent 的路由上下文,优先安装 cloud 和 elasticsearch 认证类技能(多数技能依赖它们),再按需补充

方式一:npx 一键安装(最推荐,30 秒完成)

无需 clone 仓库,运行一条命令即可,适合大多数用户:

npx skills add elastic/agent-skills

命令会启动交互式界面,让你勾选想装哪些技能、装给哪些 Agent,然后自动把技能文件夹复制到正确位置。

常用技巧:

# 只安装指定技能
npx skills add elastic/agent-skills --skill elasticsearch-esql

# 同时装给 Cursor 和 Claude Code
npx skills add elastic/agent-skills -a cursor -a claude-code

# 先预览可装哪些技能,不实际安装
npx skills add elastic/agent-skills --list
参数 作用
-a, --agent 指定目标 Agent
-s, --skill 按名称安装指定技能
-g, --global 装到用户主目录而非项目目录
--list 仅列出可用技能

方式二:Claude Code 原生插件安装

Claude Code 用户有原生插件系统,是最省心的选择:

# 第一步:把仓库添加为插件市场来源
claude plugin marketplace add https://github.com/elastic/agent-skills

# 第二步:按领域安装插件
claude plugin install elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills

也可以在会话内输入 /plugins 打开交互式插件浏览器,浏览、安装和管理插件。

⚠️ 已知小坑:安装后执行 /reload-plugins 可能不会立即生效,重启一次 Claude Code 会话即可看到新技能。

方式三:GitHub Copilot CLI 插件安装

GitHub Copilot CLI 同样提供原生插件系统,步骤与 Claude Code 类似:

# 添加市场来源
copilot plugin marketplace add elastic/agent-skills

# 按名称安装插件
copilot plugin install elasticsearch@elastic-agent-skills
copilot plugin install kibana@elastic-agent-skills

在 Copilot 会话中输入 /plugin list 可交互式浏览已配置的插件。每个领域插件(如 elasticsearch)的技能定义可参考 plugins/elasticsearch/plugin.json。

方式四:本地克隆 + 安装脚本(无 Node 环境也能装)

如果你的环境没有 Node.js/npx,或者习惯本地管理,仓库自带纯 bash 安装脚本 install-skills.sh:

git clone https://gitcode.com/gh_mirrors/agentskills1/agent-skills
cd agent-skills
./scripts/install-skills.sh add -a cursor -a claude-code

脚本会自动扫描 skills/ 目录下所有技能并复制到对应 Agent 的目录。常用参数:

参数 作用
-a, --agent 目标 Agent,可重复指定
-s, --skill 按名称或通配符安装,如 -s 'observability-*'
-f, --force 覆盖已安装的技能
-y, --yes 跳过确认提示

查看仓库内全部技能:

./scripts/install-skills.sh list

支持的 Agent 与安装目录速查

Agent 安装目录
claude-code .claude/skills
cursor .agents/skills
github-copilot .agents/skills
codex / opencode / cline .agents/skills
windsurf .windsurf/skills
roo .roo/skills
pi .pi/agent/skills
gemini-cli .agents/skills

更新技能:按安装方式对号入座

装完不更新,等于白装。不同方式的更新命令各不相同:

  • Claude Code 插件:claude plugin update(全量)或 claude plugin update elastic-elasticsearch(指定),还可开启自动更新
  • Copilot CLI:copilot plugin update
  • npx 方式:npx skills check 检查上游变化,npx skills update 拉取最新版本。npx 默认使用符号链接,更新一次即可同步所有 Agent
  • 本地克隆:git pull 后重新执行 ./scripts/install-skills.sh add -a cursor --force 覆盖更新

常见问题 FAQ

Q1:装完技能,Agent 没反应?

确认技能已复制到正确目录(见上表),并重启 IDE / Agent 会话。Claude Code 用户请记得重启而非只执行 /reload-plugins。

Q2:技能依赖环境变量吗?

部分技能需要。例如 cloud-setup/SKILL.md 需要 EC_API_KEY,elasticsearch-esql 需要 ELASTICSEARCH_URL 加 API Key。具体以各技能 SKILL.md 中 compatibility 字段说明为准。

Q3:技能会访问我的数据吗?

会。AI Agent 持有真实凭据和 shell 权限,技能查询到的安全数据(告警、事件)会进入模型上下文。官方在 README.md 的安全须知中建议:最小化 API Key 权限、默认只读、先在非生产环境验证、并亲自审查这些开源技能的实现。

写在最后

只需一条 npx skills add elastic/agent-skills,你的 AI 编程助手就能获得 Elastic 官方团队沉淀的平台专家经验——从 ES|QL 查询到 Kibana 告警、从 APM 接入到 SOC 告警分诊。选对安装方式,5 分钟后即可开工。🎯

登录后查看全文
agent-skills