SuperAPI AI 工具集

package-spec

通用与其它

查看项目

更新于 10-15 21:37

技能介绍

用途:该技能用于 Elastic 集成包的规范合规,适用于构建或审查根级与数据流级 manifest.yml、校验 changelog.yml、选择变更类型与语义化版本、配置策略模板与变量声明、声明 var_groups 或 provider_permissions,以及排查 elastic-package lint 或 elastic-package check 报错。

主要能力:说明 format_version 的选取原则,即使用支持所需特性的最低版本而非最新版本;给出特性与最低版本对应关系,如基础结构 1.0.0、输入级变量 2.0.0、routing_rules.yml 2.9.0、secret 变量 3.0.0、var_groups 3.6.1、provider_permissions 3.6.4。说明 conditions.kibana.version 默认约束为 "^8.19.0 || ^9.1.0",仅根 manifest 设置。说明变量四个作用域(包、策略模板、输入、数据流)及禁止变量遮蔽。说明 Handlebars 变量必须声明、路由规则需 dynamic_dataset 与 dynamic_namespace 标志、YAML 需正确嵌套。给出 changelog.yml 结构、条目必填字段与合法类型(enhancement、bugfix、breaking-change),以及 patch/minor/major 版本递增规则和不需递增的情形。

使用方式:编辑 changelog.yml 或使用 elastic-package changelog add;PR 创建后将占位链接替换为真实 PR 号并运行 elastic-package lint 验证。

适用场景:集成包 manifest 与 changelog 的构建、审查与排错。

限制:不适用于包脚手架与目录布局、Federated Identity 端到端启用、ingest pipeline 设计、字段映射与 ECS 合规、CEL 程序及 transform 配置,这些需参考其他技能。上游权威为 elastic/package-spec 仓库。