Modernize 是一个用于处理旧 PR(拉取请求)的技能,帮助判断 PR 是否仍然值得保留,并在合适时将其更新到最新基础分支。它适用于用户要求“rebase a PR”或“modernize”的场景。
用途: 该技能的核心用途不是单纯解决 Git 冲突,而是先确认 PR 的目标是否仍然对产品有价值,再决定后续动作。它强调“现代化想法,而不仅仅是分支”。
主要能力与流程:
- 防护规则:开始前必须拉取分支、主分支及其他相关分支的最新远程状态;将现有工作区变更视为用户所有;允许 rebase 和更新 PR 分支,但不允许合并、关闭、更改基础分支或扩大范围;禁止无限定的强制推送,必须使用 --force-with-lease 并基于 rebase 前观察到的 head SHA;除非用户要求,否则不发布 PR 评论。
- 确定 PR 意图:解析 PR 并记录 URL、状态、基础分支、头仓库和分支、当前 head SHA、作者、检查状态和审查状态;阅读标题、正文、关联 issue、提交、审查线程和完整 diff;在评判实现之前,先陈述 PR 试图达成的最小一致目标;获取最新的远程基础分支和 PR head,记录合并基。
- 检查周围变更:检查自 PR 分叉以来基础分支上新增的提交和 diff;搜索已合并和开放的 PR,看是否有替代或竞争实现;考虑同一用户问题是否已被解决、API/类型/schema/依赖或架构边界是否变化、双方是否声称拥有相同行为、代码是否被删除或移动、落地 PR 是否会恢复旧行为或造成重复方式、原始收益是否仍足以证明维护成本。
- 推送前决定处置方式:MODERNIZE(目标仍有用且实现形状合适,执行 rebase、解决冲突、测试并更新分支)、REWORK(目标仍有用但机械 rebase 会保留错误实现,解释最小可信重写并在推送前停止,除非用户同时要求返工)、CLOSE(PR 已被取代、过时、方向错误或不再值得成本,引用具体证据并停止,未经明确许可不关闭)。年龄本身不是证据,沉没成本不是保留 PR 的理由。
- 不丢失意图地 rebase:为 MODERNIZE 创建安全本地分支或一次性工作树,将提交 rebase 到新获取的基础分支;根据 PR 当前意图和基础分支的新不变量解决冲突;若冲突揭示产品或架构分歧,停止并重新考虑处置方式;使用 git range-diff 比较 rebase 前后提交序列并检查最终 diff,确认没有有意行为消失或已落地行为被重新引入;运行仓库针对触及区域的聚焦检查;使用 --force-with-lease 推送;若 lease 失败,获取并重新评估而不是覆盖新工作;不合并 PR。
- 报告:以 MODERNIZE、REWORK 或 CLOSE 及原因开头,然后总结基础分支上的有意义变更、概念冲突或确认无冲突、rebase 和推送结果(如执行)、运行的检查及结果、剩余决策或工作,并附 PR 链接。区分观察到的事实与判断,说明无法验证的内容而不是制造信心。
使用方式: 该技能通过自然语言指令触发,例如用户要求“rebase 这个 PR”或“modernize”。技能内部包含具体操作步骤和防护规则,但未提供安装命令或平台细节。
适用场景: 适用于维护旧 PR、需要判断 PR 是否仍然有价值、在基础分支变化后更新 PR 分支等场景。特别适合需要避免盲目 rebase 和强制推送的团队工作流。
限制: 仅授权 rebase 和更新 PR 分支,不授权合并、关闭、更改基础分支或扩大范围;不发布 PR 评论,除非用户要求;不使用无限定强制推送;如果 lease 失败需重新评估;如果冲突揭示产品/架构分歧应停止;无法验证的内容应明确说明。该技能未提供具体的安装方式、收费信息或支持平台。