用途:该技能用于 Apache Airflow 供应商(provider)发布周期,替代发布经理手动逐提交输入 d/b/f/x/m/s/v 的分类步骤,由 AI 驱动完成变更分类、版本号递增、changelog 生成,并支持增量更新。它保留现有 breeze 工具作为模板生成的事实来源,Claude 仅负责分类、版本递增和 changelog 条目;其余文件(init.py、README.rst、pyproject.toml、conf.py、get_provider_info.py、index.rst)仍由 breeze release-management prepare-provider-documentation --reapply-templates-only 重新生成。
适用场景:常规供应商发布周期,替代 breeze release-management prepare-provider-documentation 或 --incremental-update 的手动分类;分为 Wave(默认,发布所有有变更的 provider)与 Ad-hoc(固定 provider 列表)两种形态。不适用于 --only-min-version-update、从非 main 分支发布(除非传 --base-branch)、删除 provider。
使用方式:需先向发布经理确认 RELEASE_DATE(YYYY-MM-DD)、base branch(默认 main)、provider 子集、include 标志,并设置环境变量:
export RELEASE_DATE=<date> export DISTRIBUTIONS_LIST="<provider1> <provider2> ..."
流程分五阶段:Phase 1 用 breeze release-management classify-provider-changes --base-branch main --output-file /tmp/provider-changes.json 确定性预分类并重跑模板;Phase 2 按 provider 取提交列表(注意 tag 命名用连字符、跳过哨兵与 rc tag);Phase 3 分类 needs_llm 提交(≲15 条内联,更多则每 provider 一个 Explore 子代理,按 provider 切片看 diff);Phase 4 版本递增与 changelog;Phase 5 及增量更新。分类含义:d 文档、b 修复、f 特性、x 破坏性、m 杂项、s 跳过、v 最低 Airflow 版本提升。
限制与注意:该技能会批量修改 provider.yaml 与 changelog.rst,须在干净工作树或专用分支运行并由发布经理审阅 diff。版本递增后需重跑发现,否则会漏掉被 doc-only 标记抑制的条目。provider.yaml 是源文件,任何改动至少为 misc,绝不跳过。分类应基于 provider 切片 diff,而非提交标题。