SuperAPI AI 工具集

airflow-pr-draft-summary

编程与开发

查看项目

更新于 10-15 19:58

技能介绍

该技能用于起草 Apache Airflow 的各类贡献文本,包括提交信息、PR 标题与描述、GitHub 评论与评审,以及发布说明(release note)决策。

用途与主要能力

提交信息与 PR 标题采用祈使语气、纯散文写法,聚焦用户影响而非实现细节。标题保持在 70 字符以内,且标题中不写 issue 或 PR 编号——GitHub 在 squash-merge 时会自动追加实际 PR 号。apache/airflow 不使用 Conventional Commits,因此禁止 fix:、feat:、chore: 等前缀;项目已有的 UI:、API:、Helm: 等区域标签可以使用。提交信息正文只描述变更动机与背景,不复述 diff 内容。

PR 描述需遵循仓库模板,并填写 Gen-AI 复选框和 Generated-by: 署名(如适用)。只报告实际执行过的检查及其结果。

发布说明与 newsfragment

对 airflow-core(以及 chart/、dev/mypy/)中面向用户的变更,需在该发行版的 newsfragments/ 目录添加 newsfragment,命令为: echo "Brief description" > airflow-core/newsfragments/{PR_NUMBER}.{bugfix|feature|improvement|doc|misc|significant}.rst 仅在确定变更对用户可见时添加;构建/发布工具、CI、打包、内部重构和仅开发脚本不添加。providers/ 和 airflow-ctl/ 不添加 newsfragment,其变更日志由发布管理者从 git log 重新生成;task-sdk/ 的变更使用 airflow-core/newsfragments/。

提交前必须运行 prek install,以安装 commit-msg 钩子(check-no-conventional-commit-message)和 pre-commit,CI 会检查 PR 的每个提交。

GitHub 消息署名

智能体起草并最终以用户账号发布到 GitHub 的内容,必须在末尾单独段落以空行和水平分隔线结尾添加署名页脚,使用与 PR 正文 Generated-by: 相同的智能体名称字符串:


Drafted-by: <Agent Name and Version> (no human review before posting)

若经人工审核:


Drafted-by: <Agent Name and Version>; reviewed by @<github-handle> before posting

该页脚不替代各工具自身的披露规则;PR 正文仍保留 AI 披露复选框下的 Generated-by: 块。不得为缩短消息而省略页脚。禁止将智能体列为提交共同作者(不得添加 Co-Authored-By)。

提及限制

AI 智能体不得提及或 @ 具体贡献者、提交者、PMC 成员或维护者,除非人工审核者明确指示。建议相关方时,应改用角色、团队、代码归属信息、标签或组件。例外仅限人工明确授权的提及,以及在上述页脚中注明审核者,和在已有活跃讨论的线程内回复参与者。

授权边界

起草本身不授权发布;准备授权发布时使用 Publish Airflow changes。