用途:作为 Elastic 变更日志 YAML 文件的质量检查关口,对照 schema 与写作规范报告问题,从不自动改文件。输入 $ARGUMENTS 为文件或目录,为空时需询问用户;目录会自动 glob *.yaml 和 *.yml。
主要能力与用法:先加载规范(优先工作区 docs-content/contribute-docs/content-types/changelogs.md,其次抓取官方指南,否则用内置模式)与仓库配置(docs/changelog.yml 的 pivot.areas 用于校验 areas)。随后解析 YAML,解析失败即报告并跳过。schema 检查为硬错误:title、type、products 必填;type 取值限于 feature、enhancement、security、bug-fix、breaking-change、deprecation、known-issue、docs、regression、other;products 非空且每项含 product;PR 关联文件需 prs 且禁止 versions/target,版本列表文件需 versions 且禁止 target;subtype 仅限 breaking-change 且取 api、behavioral、configuration、dependency、subscription、plugin、security、other;含 : 的文本值须加引号。质量检查为警告,覆盖标题动词形式、生僻缩写、时态、类型与标题对齐、技术化措辞、推荐删除仅测试/重构条目等。
适用场景与限制:适合合并前的评审流程(评审→修复→再评审)。只报告问题,不修改文件;product ID、lifecycle 等需联网抓取校验列表,抓取失败时只能标记“可能无效”。文件删除仅建议不执行。其余细节资料未提供。