用途:当某个提交已随发布候选进入 release/X.Y,之后又在 main 上被 revert 时,revert 不会自动进入发布分支,导致 release/X.Y 仍留有该提交。本技能找出这类“遗漏的 revert”,并为每个 revert 向 pytorch/pytorch 的 release/X.Y 开一个 cherry-pick PR,各 PR 位于用户 fork 的独立分支;绝不直接推送到 release/X.Y。
检测逻辑:由 tools/analytics/github_analyze.py(GitHub Analytics Daily 每日运行)中的 analyze_reverts_missing_from_branch 比对 main 与发布分支。对每个 revert,若被撤销的提交带 RC 标签则输出 🔴 WARNING(需人工确认);若 revert 已在发布分支输出 ✅ DETECTED;若被撤销提交从未进入发布分支输出 🟢 STATUS,后两者跳过。注意 WARNING 只是启发式判断,RC 标签可能来自其他发布线,cherry-pick 前须用 git merge-base --is-ancestor 确认。需要 cherry-pick 的是 Commit Hash 行的 revert 提交,而非被撤销的提交。Phabricator diff 的 revert 不会解析出 GitHub SHA,不在范围内。
必要用法:获取分析数据可从 GitHub Analytics Daily 运行日志拉取(gh api 取 github-analyze 作业日志),或在本地运行分析器;然后在 pytorch/pytorch 检出上,对每个标记项确认后建分支并 cherry-pick -x,推送到 fork 并以发布分支为 base 开 PR(不得用 --base main)。可选在发布跟踪 issue 上按标准格式逐条评论提名。最后汇总 PR、标题、revert_sha 与结果。
限制与护栏:开 PR 和评论属对外操作,须先确认;cherry-pick 冲突时中止并报告,不强行解决;需 gh 已认证 pytorch/pytorch 且本地检出的 origin 为用户 fork。其余细节资料未提供。