<p align="center"> <img alt="Elastic 徽标" src="https://assets.kitploit.com/production/public/readmes/12587/8e357b6e4cbecb13a462cd8da398525dbe599bb7210c6426f2f1103702561816.png" width="200"> </p> <p align="center"> <a href="https://github.com/elastic/agent-skills/blob/main/LICENSE"><img alt="许可证" src="https://img.shields.io/badge/license-Apache%202.0-blue"></a> </p> # Elastic Agent Skills Elastic Agent Skills — 由构建 Elastic 的团队打造 — 将原生平台专业知识直接交付给你的 AI 编码代理。这是官方的 Agent Skills 库,兼容 Cursor、GitHub Copilot、Windsurf、Gemini CLI 等代理式 IDE。技能遵循 [Agent Skills](https://agentskills.io/) 开放标准。 > [!NOTE] > **技术预览** > > 这些技能处于早期发布阶段,正在积极开发中。随着技能通过稳健的评估被规范化,以及模型格局的演变,预计会有变化。请经常回来查看更新。 ## 关于 本仓库包含精选技能,这些技能是指令、上下文和工具包的集合,用于教会任何 AI 代理如何正确地使用 Elasticsearch、Kibana、Elastic Observability 和 Elastic Security。将它们放入你已在使用的代理运行时中,你的助手就会停止使用过时的模式,并开始正确地工作。 ## 什么是技能? 技能是自包含的包,为 AI 代理提供以可重复方式完成特定任务所需的知识和工具。每个技能都位于自己的文件夹中,包含一个 `SKILL.md` 文件,其中含有代理遵循的元数据和指令。 有关 Agent Skills 标准的更多背景信息,请参阅 [agentskills.io](http://agentskills.io/)。 ## 范围 本仓库中的技能专注于: - 与 Elasticsearch API 交互(搜索、索引、集群管理) - 构建和管理 Kibana 内容,例如告警、连接器等 - Elastic Observability、Elastic Security 和 Agent Builder 的模式 <!-- BEGIN-SKILL-TABLE --> ## 可用技能 <details> <summary>Cloud (2)</summary> | 技能 | 描述 | 版本 | 作者 | | ----- | ----------- | ------- | ------ | | [cloud-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/cloud/onboarding/SKILL.md) | 引导 Elastic Cloud 组织入门:配置 `elastic` CLI 的 Cloud 上下文和 API 密钥,建立默认区域,然后邀请用户,分配预定义或自定义的 Serverless 项目角色,并创建或撤销 Cloud API 密钥。适用于设置 Cloud 身份验证,或授予、修改、审计用户对组织及其项目的访问权限时。 | 0.3.0 | elastic | | [cloud-provisioning](https://github.com/elastic/agent-skills/blob/main/skills/cloud/provisioning/SKILL.md) | 预配和运维 Elastic Cloud 基础设施:创建、连接、更新和删除 Serverless 项目(Elasticsearch、Observability、Security);管理流量过滤器(IP 和 AWS PrivateLink 网络安全);以及管理 Elastic Cloud Hosted 部署的生命周期。适用于创建 Serverless 项目或托管部署、对其执行日常运维操作,或限制其网络访问时。 | 0.3.0 | elastic | </details> <details> <summary>Elasticsearch (10)</summary> | 技能 | 描述 | 版本 | 作者 | | ----- | ----------- | ------- | ------ | | [elasticsearch-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection/SKILL.md) | 通过 API 创建和管理 Elastic ML 异常检测作业。适用于在索引或数据流上设置作业、配置作业和数据源,或打开、启动、停止作业的场景。 | 1.1.0 | elastic | | [elasticsearch-anomaly-detection-explainer](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection-explainer/SKILL.md) | 解释 Elasticsearch ML 异常检测分数、模型行为和结果解读。适用于用户询问分数为何偏高或偏低、模型如何学习、这些数字代表什么,或如何排查意外的异常分数。 | 0.3.0 | elastic | | [elasticsearch-cluster-health](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-cluster-health/SKILL.md) | 诊断非绿色状态的 Elasticsearch 集群,并给出最可能的单一原因及修复建议。适用于运维人员报告黄色或红色状态、未分配分片、分配失败,或希望在深入调查前进行只读分诊的场景。讲解副本与主分片的影响、分配决策器分类以及数据丢失意识。 | 0.1.0 | elastic | | [elasticsearch-esql](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-esql/SKILL.md) | 执行 ES\|QL(Elasticsearch 查询语言)查询,适用于用户想要查询 Elasticsearch 数据、分析日志、聚合指标、探索数据,或基于 ES\|QL 结果创建图表和仪表盘的场景。 | 0.10.0 | elastic | | [elasticsearch-index-design](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-index-design/SKILL.md) | 针对既定的访问模式设计和审查 Elasticsearch 索引映射:正确的字段类型、text+keyword 多字段、doc_values 调优、避免映射爆炸,以及显式的分片设置。适用于创建新索引、审查映射以优化存储或查询性能、修复错误的字段类型,或用户询问某字段在搜索、过滤、排序或聚合时应使用哪种类型的场景。 | 0.1.0 | elastic | | [elasticsearch-ingest](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-ingest/SKILL.md) | 使用 bulk API 和显式映射(当字段类型很重要时)将 CSV、JSON 和 NDJSON 文件加载到 Elasticsearch 索引中。适用于批量导入本地文件、将 CSV 行或 JSON 数组转换为 NDJSON bulk 格式、在摄取前用 elastic es info 确认集群连通性,或在摄取后验证文档数量和映射——不适用于 Logstash 管道、Beats、自定义脚本或索引到索引的 reindex。 | 0.1.3 | elastic | | [elasticsearch-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-onboarding/SKILL.md) | 帮助刚接触 Elasticsearch 的开发者从零开始获得可用的搜索体验。引导他们理解自身意图、映射数据,并构建融入最佳实践的搜索体验。适用于用户表现出构建搜索相关功能的意图、询问与其用例相关的 Elasticsearch 概念,或表示需要帮助入门 Elasticsearch 的场景。 | 0.3.0 | elastic | | [elasticsearch-query-optimization](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-query-optimization/SKILL.md) | 诊断缓慢的 Elasticsearch Query DSL 搜索并提出经过实测的修复方案。适用于搜索缓慢、性能分析输出显示存在高开销子句、精确匹配过滤器处于评分上下文,或前导通配符主导延迟的场景。每条建议都以搜索性能分析为依据——将非评分子句移至过滤上下文、消除前导通配符,并重新分析以确认改进效果。 | 0.1.0 | elastic | | [elasticsearch-reindex](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-reindex/SKILL.md) | 指导 Elasticsearch reindex 的性能优化:本地和远程、切片、限流、任务 API。适用于复制或迁移索引、更改映射,或在 reindex 过程中进行数据转换的场景。 | 0.2.0 | elastic | | [elasticsearch-search-relevance](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-search-relevance/SKILL.md) | 提升内容和目录索引的 Elasticsearch 搜索相关性:使用查询规则(正确的规则类型、条件和规则-查询关联)固定或提升结果,并通过 multi_match、字段加权和基于索引映射的分析来调优自然排序。适用于搜索结果排序不佳、特定文档必须在某个查询中排在首位,或用户要求调优全文匹配的场景——不适用于 ES\|QL 分析、索引摄取或集群健康。 | 0.1.0 | elastic | </details> <details> <summary>Kibana (7)</summary> | 技能 | 描述 | 版本 | 作者 | | ----- | ----------- | ------- | ------ | | [kibana-agent-builder](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-agent-builder/SKILL.md) | 创建和管理 Kibana Agent Builder 代理及自定义工具。当被要求创建、更新、删除、测试或检查 Agent Builder 中的代理或工具时使用,或当用户想了解已存在哪些代理或工具时使用。 | 0.3.0 | elastic | | [kibana-alerting-rules](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-alerting-rules/SKILL.md) | 创建和管理 Kibana 告警规则。当创建、更新或管理规则生命周期(启用、禁用、静音、暂停),选择指标阈值规则类型和参数,或使用标签过滤器进行只读查找/列出时使用。 | 0.3.0 | elastic | | [kibana-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-anomaly-detection/SKILL.md) | Elastic ML 异常检测——调查/根因分析、分数解释、作业生命周期故障排查以及作业操作。当回答“什么坏了?”/“哪个实体?”/RCA、“为什么分数高/低?”/重新归一化、“datafeed 停止”/“内存限制”/hard_limit,或配置 ML 异常检测作业时使用。从 `.ml-anomalies-*` 读取结果,从 ML REST API 读取作业状态。 | 0.3.0 | elastic | | [kibana-cases](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-cases/SKILL.md) | 跨 Elastic Security、Observability 和 Stack Management 管理调查和事件案例——创建、搜索、更新案例,并用评论、告警、事件和可观测对象(IOC)丰富案例。当跟踪事件、将告警关联到案例、添加调查笔记、更新状态或严重性,或管理分诊输出时使用。 | 0.2.0 | elastic | | [kibana-context-engine](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-context-engine/SKILL.md) | 查询 Elastic Context Engine AI 索引及其存储的知识指标(KI)。当被要求从 AI 索引 / KI / Context Engine 知识索引中搜索、探索、计数或回答问题,以及编写查询该索引的 ES\|QL 时使用。 | 0.2.1 | elastic | | [kibana-dashboards](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-dashboards/SKILL.md) | 创建和管理 Kibana 仪表板及 Lens 可视化。当你需要以声明式方式定义仪表板和可视化、对其进行版本控制、自动化部署,或改进布局、分区、控件或图表设计时使用。 | 0.4.0 | elastic | | [kibana-workflows](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-workflows/SKILL.md) | 编写、验证、测试、运行和检查 Elastic Workflow YAML 定义。当用户想将自然语言转换为 Kibana 工作流、修复工作流 YAML、理解触发器或步骤,或针对真实 Kibana 运行快速测试循环时使用。 | 0.5.0 | elastic | </details> <details> <summary>Observability (6)</summary> | 技能 | 描述 | 版本 | 作者 | | ----- | ----------- | ------- | ------ | | [observability-csp-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/csp-investigation/SKILL.md) | 调查云服务提供商(CSP)服务问题——目前支持 AWS(其推理逻辑适用于任何 AWS 服务;针对 RDS、Lambda、SQS、ALB、EC2 的 schema 和故障特征最为深入),未来将支持 GCP 和 Azure——使用 Elastic 中的 OTel schema 云指标。适用于诊断云资源问题,无论是告警触发还是临时排查:数据库连接/CPU/内存压力、函数错误率和限流、队列积压和消费者延迟、负载均衡器 5xx、实例饱和。将所调查的资源与其自身基线进行关联,对故障模式进行分类,并排除同时发生但无关的状况。 | 0.2.0 | elastic | | [observability-k8s-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/k8s-investigation/SKILL.md) | 使用 OTel 遥测(EDOT)调查 Kubernetes 工作负载、节点和控制平面问题。适用于诊断 Pod 故障(CrashLoopBackOff、OOMKilled、Error)、节点压力、资源耗尽、镜像拉取失败、准入拒绝、自动扩缩容异常,或将 K8s 状态与应用信号关联。仅限 OTel 摄取路径——旧版 ECS Kubernetes 集成形态不在范围内。 | 0.5.1 | elastic | | [observability-llm-obs](https://github.com/elastic/agent-skills/blob/main/skills/observability/llm-obs/SKILL.md) | 基于已摄取到 Elastic 中的数据回答有关 LLM 和智能体应用行为的问题:延迟和错误率、token 和成本利用率、响应质量和护栏事件,以及智能体调用链编排。适用于用户询问 LLM 监控、GenAI 可观测性、token 开销或 AI 成本、模型延迟、提示词或护栏失败,或智能体的工具调用链如何执行。 | 0.3.1 | elastic | | [observability-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/observability/onboarding/SKILL.md) | 使用 Elastic Distribution of OpenTelemetry(EDOT)将应用接入 Elastic Observability:根据语言和运行时进行路由,检测并替换经典 Elastic APM agent,应用所需的 OTLP 配置,然后使用 ES\|QL 验证 traces、metrics 和 logs 确实以预期的服务名称到达。适用于为服务添加可观测性、从经典 Elastic APM agent 迁移,或调试为何已插桩的服务未出现在 Elastic 中。 | 0.3.0 | elastic | | [observability-service-reliability](https://github.com/elastic/agent-skills/blob/main/skills/observability/service-reliability/SKILL.md) | 在 Elastic Observability 中设计和运营服务可靠性目标:选择 SLI 类型和可辩护的目标值,选择时间窗口和预算方法,通过 Kibana API 创建和维护 SLO,附加燃尽率告警规则,并判断何时 SLO 是不合适的工具,而阈值规则、异常作业或合成监控才是正确的选择。适用于定义或审查 SLO 和错误预算、调整燃尽率告警、减少告警噪音,或为用户面向的端点设置可用性监控。 | 0.4.1 | elastic | | [observability-sre-triage](https://github.com/elastic/agent-skills/blob/main/skills/observability/sre-triage/SKILL.md) | 端到端分诊降级或可疑服务:读取 SLO 状态和燃尽率,检查活动告警规则和 ML 异常,测量吞吐量、延迟和错误率,评估依赖健康状况和基础设施饱和度,并将日志逐层筛选至解释问题的失败记录。适用于有人询问服务是否健康、为何缓慢或报错、日志中有什么内容,或哪个属性区分了失败的请求。也适用于有人询问上述任何信号——吞吐量、延迟百分位数、错误率、依赖健康状况或日志量——基于 APM/OTel traces、metrics 或 logs 的查询。 | 0.5.2 | elastic | </details> <details> <summary>安全 (6)</summary> | 技能 | 描述 | 版本 | 作者 | | ----- | ----------- | ------- | ------ | | [security-alert-analysis](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-analysis/SKILL.md) | 调查特定的 Elastic Security 检测告警:收集上下文、评估实体风险、对威胁进行分类、记录发现,并可选地确认告警。适用于对单个已知告警进行分诊、执行 SOC 调查,或在 security-alert-triage 技能识别出待调查分组后进行后续跟进。 | 0.1.0 | elastic | | [security-alert-triage](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-triage/SKILL.md) | 按加权风险对 Elastic Security 告警队列进行优先级排序和排名——包括基础风险评分、MITRE 战术加成、实体风险和资产关键性——然后将告警聚类为实体分组。适用于分析师询问应关注什么、哪些告警最紧急,或希望在开始深入调查之前获得整个队列的排名起点。 | 0.2.0 | elastic | | [security-case-management](https://github.com/elastic/agent-skills/blob/main/skills/security/case-management/SKILL.md) | 通过 Kibana Cases API 创建、搜索、更新和管理 SOC 案例。适用于跟踪事件、将告警关联到案例、添加调查笔记或管理分诊输出。 | 0.1.0 | elastic | | [security-detection-rule-management](https://github.com/elastic/agent-skills/blob/main/skills/security/detection-rule-management/SKILL.md) | 创建、调优和管理 Elastic Security 检测规则(SIEM 和 Endpoint)。适用于处理误报、例外、新增覆盖、噪声规则,或通过 Kibana API 进行规则管理。 | 0.1.0 | elastic | | [security-generate-security-sample-data](https://github.com/elastic/agent-skills/blob/main/skills/security/generate-security-sample-data/SKILL.md) | 为 Elastic Security 生成示例安全事件、攻击场景和合成告警。适用于演示、填充仪表板、测试检测规则或搭建 POC。 | 0.1.0 | elastic | | [security-ml-integrations](https://github.com/elastic/agent-skills/blob/main/skills/security/ml-integrations/SKILL.md) | 安装和管理 Elastic 安全 ML 集成包(beaconing、ded、dga、lmd、pad、problemchild)。处理完整生命周期:预检、Fleet 包安装、组件模板、摄取管道、转换、数据视图、ML 异常检测作业和检测规则。适用于用户要求安装、设置、检查状态或排查安全 ML 集成包问题。 | 0.1.0 | elastic | </details> <!-- END-SKILL-TABLE --> ## 安全注意事项 AI 编码代理在运行时拥有真实凭据、真实的 shell 访问权限,并且通常具备运行它们的用户的完整权限。当这些代理被用于安全相关工作流时,风险会更高。因此,在开始之前,有必要就风险进行一次坦诚的讨论。 - **开展你自己的威胁建模。** 评估该 agent 能访问哪些数据、能执行哪些操作,以及当其行为异常时会发生什么。[CISA 关于安全部署 AI 系统的联合指南](https://www.cisa.gov/news-events/alerts/2024/04/15/joint-guidance-deploying-ai-systems-securely)是一个不错的起点。 - **了解哪些数据流经该 agent。** 安全数据可能包含 PII、嵌入在命令行中的凭据以及其他受监管数据。当 agent 查询告警或进程事件时,这些内容会进入模型的上下文,并可能被发送到第三方 API。请尽早让信息安全与合规团队参与。 - **这些 agent 会处理攻击者控制的输入。** 告警、事件字段和文件内容经常包含攻击者精心构造的字符串。提示注入在这里并非理论问题;它是运行环境的一种固有属性。诸如 [Brainworm](https://www.originhq.com/blog/brainworm) 的研究表明,仅 agent 上下文文件本身就可以作为 promptware 的持久化机制。 - **严格限定权限范围。** 为 API 密钥授予所需的最低权限。宽泛的响应权限尤其危险。在你验证行为之前,只读访问是良好的默认设置。 - **限制 agent 的工具访问和网络可达范围。** 大多数 AI 编码 agent 默认附带宽泛权限:shell 执行、文件系统写入、互联网访问。缩小可用工具面可以限制被攻陷或误入歧途的 agent 能做什么。 - **从非生产环境开始。** 使用 Serverless 试用项目、开发集群或隔离的 Kibana 空间来评估技能,然后再将它们连接到任何承载实时安全数据的环境。 这些技能之所以开源,正是为了让你能够审计它们的功能。我们鼓励你在运行它们之前先阅读它们。 ## 入门 你可以使用 Claude Code 原生插件系统、通过 `npx` 使用 `skills` CLI,或克隆此仓库并运行捆绑的安装脚本,来安装 Elastic 技能。`npx` 方法要求你的环境中具有可用的 `Node.js` 和 `npx`。 > [!TIP] > **不要安装所有技能。** 每个已安装的技能都会增加路由上下文,你的 agent 会在每次请求时对其进行评估。安装 **cloud** 和 **elasticsearch** 认证技能——大多数其他技能都依赖它们——然后只添加与你的工作流相关的技能。保持已安装技能集的聚焦可以避免上下文膨胀,并帮助 agent 可靠地路由到正确的技能。 ### Claude Code 插件(推荐 Claude Code 用户使用) Claude Code 具有原生插件系统,可直接管理技能。首先将此仓库添加为市场源: ```sh claude plugin marketplace add https://github.com/elastic/agent-skills ``` 添加后,按名称安装各个插件: ```sh claude plugin install elastic-elasticsearch@elastic-agent-skills claude plugin install elastic-kibana@elastic-agent-skills claude plugin install elastic-observability@elastic-agent-skills claude plugin install elastic-security@elastic-agent-skills claude plugin install elastic-cloud@elastic-agent-skills ``` > [!NOTE] > 安装后,运行 `/reload-plugins` 时技能可能不会立即显示。这是 Claude Code 的一个已知问题——请重启你的 Claude Code 会话以加载新安装的插件。 或者,在任意 Claude Code 会话中使用交互式插件浏览器: ``` /plugins ``` 这会打开一个菜单,用于浏览来自所有已配置市场的可用插件、选择要安装的插件,并管理已安装的插件。 ### GitHub Copilot CLI GitHub Copilot CLI 具有原生插件系统。将此仓库添加为市场源: ```sh copilot plugin marketplace add elastic/agent-skills ``` 添加后,按名称安装各个插件: ```sh copilot plugin install elasticsearch@elastic-agent-skills copilot plugin install kibana@elastic-agent-skills copilot plugin install observability@elastic-agent-skills copilot plugin install security@elastic-agent-skills copilot plugin install cloud@elastic-agent-skills ``` 在 Copilot 会话中以交互方式浏览可用插件: ``` /plugin list ``` ### npx(推荐) 安装技能最快的方式是使用 [`skills`](https://github.com/vercel-labs/skills) CLI。无需克隆此仓库——只需运行: ```sh npx skills add elastic/agent-skills ``` 这会启动一个交互式提示,用于选择技能和[目标代理](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)。CLI 会将每个技能文件夹复制到代理可发现的正确位置。 按名称安装特定技能: ```sh npx skills add elastic/agent-skills --skill elasticsearch-esql ``` 或使用 `@` 简写直接指定技能为 `repo@skill`(等同于 `--skill`): ```sh npx skills add elastic/agent-skills@elasticsearch-esql ``` 安装到特定 agent(参见[支持的 agent](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)): ```sh npx skills add elastic/agent-skills -a cursor -a claude-code ``` 列出可用技能而不安装: ```sh npx skills add elastic/agent-skills --list ``` 将所有技能安装到所有代理(非交互式): ```sh npx skills add elastic/agent-skills --all ``` | 标志 | 描述 | | ----------------- | ------------------------------------------------- | | `-a, --agent` | 指定目标代理(参见[支持的代理](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)) | | `-s, --skill` | 按名称安装特定技能 | | `-g, --global` | 安装到用户主目录而非项目目录 | | `-y, --yes` | 跳过确认提示 | | `--all` | 无需提示即可将所有技能安装到所有代理 | | `--list` | 列出可用技能而不安装 | ### 本地克隆 如果你更倾向于使用本地检出副本,或者你的环境没有 Node.js / npx,请克隆仓库并使用捆绑的 bash 安装程序: ```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a <agent> ``` 该脚本需要 bash 3.2+ 以及标准 Unix 工具(`awk`、`find`、`cp`、`rm`、`mkdir`)。 | 标志 | 描述 | | ----------------- | ------------------------------------- | | `-a, --agent` | 目标 agent(可重复指定) | | `-s, --skill` | 按名称安装特定技能 | | `-f, --force` | 覆盖已安装的技能 | | `-y, --yes` | 跳过确认提示 | 列出所有可用技能: ```sh ./scripts/install-skills.sh list ``` ### 支持的 agent | Agent | 安装目录 | | --------------- | ------------------------- | | claude-code | `.claude/skills` | | cursor | `.agents/skills` | | codex | `.agents/skills` | | opencode | `.agents/skills` | | pi | `.pi/agent/skills` | | windsurf | `.windsurf/skills` | | roo | `.roo/skills` | | cline | `.agents/skills` | | github-copilot | `.agents/skills` | | gemini-cli | `.agents/skills` | ## 更新 skills 更新流程取决于 skills 的安装方式。 ### Claude Code 插件 将所有已安装的插件更新到最新版本: ```sh claude plugin update ``` 更新特定插件: ```sh claude plugin update elastic-elasticsearch ``` 要让插件自动保持最新,请在 Claude Code 中使用 `/plugins` 启用自动更新。 启用自动更新后,Claude Code 会在启动时检查插件的新版本,并在后台进行更新。 ### GitHub Copilot CLI 将所有已安装的插件更新到最新版本: ```sh copilot plugin update ``` 更新特定插件: ```sh copilot plugin update elasticsearch ``` ### npx 检查是否有任何已安装的技能在上游发生了变更: ```sh npx skills check ``` 拉取所有已安装技能的最新版本: ```sh npx skills update ``` CLI 会在锁文件中跟踪每个技能的源仓库和内容哈希。`check` 会将本地哈希与 GitHub 上的哈希进行比对;`update` 会重新下载任何已发生偏移的内容。 > **提示:** 默认的 npx 安装使用符号链接,因此每个 agent 都指向同一个规范副本。更新一次即可同时刷新所有 agent。 ### 本地克隆 使用 `--force` 重新运行安装程序以覆盖现有技能: ```sh git pull ./scripts/install-skills.sh add -a <agent> --force ``` 如果不使用 `--force`,脚本会跳过已安装的技能。 ## 技能格式 每个技能文件夹都包含一个 `SKILL.md`,其中带有 YAML frontmatter 和 markdown 指令: ```yaml --- name: elasticsearch-my-skill description: > What the skill does AND when an agent should activate it. metadata: version: 0.1.0 visibility: public --- # My Skill [Instructions that the agent follows when this skill is active] ``` `description` 字段是唯一的触发机制——agent 运行时通过读取它来决定何时加载某个 skill。完整的格式规范请参见 [agentskills.io/specification](https://agentskills.io/specification)。 ## 问题反馈 发现了问题或有建议?[提交 issue](https://github.com/elastic/agent-skills/issues/new),我们会进行审核。 ## 免责声明 这些 skill 按原样提供。在依赖它们执行关键任务之前,请务必在你自己的环境中对其进行充分测试。