用途:为自己的 PR 或本地 diff 起草说明性备注,帮助队友理解行为变更、受影响的调用方以及不明显的设计选择。该工作流只授权检查和起草,不授权额外修改代码或回复队友。
处理已有 PR 时,先读取目标与作者信息,核实仓库、PR、作者和当前 head。若不存在 PR,则检查本地 diff,并继续以私有草稿形式处理。
主要能力:阅读 diff、已有讨论和受影响的调用方,必要时追踪历史或关联 issue 以支撑理由。针对有意义的改动覆盖评审人可能提出的不同问题,没有规定的数量或上限:复杂改动可能需要多条简短备注,简单改动可能一条都不需要。起草解释时使用写作备注,每条备注保持简短、具体、有依据;不得臆造作者意图,也不以 Pete 本人身份发言。若需要持久化的代码注释,应单独标记,除非该编辑已获授权。
用法与限制:发布前先展示每一处拟公开的措辞,包括可选的评审摘要,以及每条备注的路径、侧、行号和正文;支撑证据放在拟发评论之外。若所有有用要点都已内联,摘要为空,不添加评论数量或状态声明。等待措辞和锚点获批;提供的确切文本加上发帖指令即视为批准,不要重复询问。若获批文本或锚点需要改动,先展示该改动以供批准。每次运行都检查已有评论,避免重复。获批后,阅读 GitHub 发帖方式,将获批备注作为一次评审发布,并核验 GitHub 存储了预期的文本和锚点。当作者不一致、PR 已关闭或缺少批准时不得发布;在可能的情况下继续私有起草。