关于 address-pr-feedback
Address PR Feedback 是用于处理现有 PR 反馈的技能,面向 GitHub 仓库维护者。它覆盖反馈收集与评估、代码修复、验证、推送及回复,并要求根据最新审查状态处理 Codex 和 CodeRabbit 等审查流程。
主要功能
- 01收集 PR 评论与审查反馈
- 02评估并跟踪可执行事项
- 03修复问题并运行验证
- 04推送更改并刷新反馈
- 05向审查者回复处理结果
适用场景
- 01处理 PR 内联审查意见
- 02核对机器人摘要和仓库评论
- 03在推送后继续跟进新增审查
- 04为处理或拒绝的建议提供依据
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sjunepark/ agent-scripts --skill address-pr-feedback安装后在 Claude Code 中输入/address-pr-feedback确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlevals/trigger-cases.jsonscripts/collect_pr_feedback.pyworkflows/stacked-prs.md详细介绍
处理 PR 反馈
通过评估、修复、验证、推送和面向审阅者的回复,处理现有 PR 反馈。需要 Git 和已认证的 gh;可选的收集脚本还需要 Python 3。PR 反馈包括审阅正文、议题评论、机器人摘要、差异范围外的发现、行内讨论串和后续反馈。
对于相互依赖的 PR,在映射或更改链条之前,请阅读 堆叠 PR。仅处理反馈并不授权重新指定目标分支、改写历史记录或合并;只有在获得授权时才使用合并流程。
收集和评估
确定仓库、PR、基础分支/头部分支、作者、最新头部 SHA 和审阅状态。
如果未指定 PR,则使用 gh pr view 推断当前分支对应的 PR。
优先使用 scripts/collect_pr_feedback.py,以完整收集反馈和回应:
python3 <skill-dir>/scripts/collect_pr_feedback.py <pr-url-or-number>
阅读其 Markdown 报告,并在需要 ID、回复结构或讨论串元数据时使用 JSON。
如果该脚本不可用,请使用 gh 收集等效信息:PR 正文和回应、议题评论和回应、审阅、行内评论和回复、提交、文件,以及可用的讨论串解决状态。包括回应者身份信息。
检查 Potential Outside-Diff Sources 以及任何可执行事项/小建议或
"Prompt for all review comments" 部分;关键词检测不能替代对完整反馈的阅读。
在评估或编辑之前,先执行下方的活跃审阅门控。随后维护一份精简的可执行事项清单,记录来源链接/ID、受影响代码、状态、处理方式和回复目标。包括没有可解析讨论串的发现,并在合并重复事项时保留所有来源链接。对照当前代码和 PR 意图核实建议;对于过时、已修复、不正确或有害的建议,应提供证据并标记,而不是盲目照做。
活跃审阅门控
手动发起的 Codex 和 CodeRabbit 请求是一次性的 PR 级请求,并非每次推送都要重新发起。后续增量推送不应触发新的审阅请求。 如果两项服务都未处于活跃状态,则使用现有反馈,不必等待未发起的审阅。处理自动开始的审阅。
必要时,根据最新回应、触发/状态评论、审阅、摘要和检查结果判断状态,并将证据与当前头部提交关联:
- 只有
chatgpt-codex-connector[bot]或经验证的替代者才能确定 Codex 回应状态。汇总数量或其他参与者均不能作为依据。 - PR 正文中的 Codex
eyes回应或@codex review评论表示已接受或正在处理。Codex+1表示已完成且未发现问题,即使没有审阅正文也一样;记录目标、参与者和时间戳。由 Codex 撰写且包含发现的审阅也能证明审阅已完成。 - CodeRabbit 的处理中/状态消息表示审阅正在进行;其已完成的审阅或最终摘要表示审阅已完成。
等待所有已观察到的活跃审阅完成,并在评估、创建事项清单、检出分支、编辑、推送或回复之前刷新反馈。活跃信号会消耗该请求;不要再次触发。如果出现明确失败,或审阅超过合理等待时限仍未完成,则诊断原因并报告反馈接收受阻。
修复并发布
使用 gh pr checkout <pr-url-or-number> 或仓库工作流检出 PR 分支。保留无关工作,获取更新,并在编辑前协调新的远程提交;头部提交发生变化时,重新评估受影响的反馈。
按连贯分组修复,并提交与已处理反馈相对应的提交。根据范围和委派判断选择精简修正或必要重构;解决尚未定论且影响重大的设计决策。运行有针对性的验证和必需验证,并对后续差异进行一次本地实现审查,修复可执行的发现。
验证通过后推送;如果任务持续时间较长,也可以在一个有界工作组完成后推送,以便远程查看。每次推送后刷新反馈;如果 Codex 或 CodeRabbit 开始新的审阅,则返回活跃审阅门控。
回复并完成
推送相关提交后再回复。对于行内问题,请使用评论回复接口, 并将回复文本保存在文件中:
gh api -X POST repos/OWNER/REPO/pulls/PR_NUMBER/comments/COMMENT_ID/replies -F body=@/path/to/reply.md
对于没有讨论串的审查正文、PR 级、机器人摘要和差异范围外的问题, 请发布一条简洁的 PR 评论,按来源归纳已处理事项,并说明已推送的提交、 验证结果,以及跳过或拒绝建议的原因。作为 PR 操作者,给出基于具体代码的回复; 省略本地技能和自动化细节。
当所有可操作事项都已修复并回复、附有证据地明确跳过,或确定为尚待用户决定的问题; 所有后续提交均已推送;且验证和审查证据已记录在回复中时,即可完成。 不得有任何 Codex 或 CodeRabbit 审查仍处于活跃状态,并且必须在最新审查完成后 刷新反馈。对于堆叠 PR,在宣布所选范围已完成前,必须覆盖每个已选 PR。
报告已推送的提交、验证结果,以及任何未解决的反馈或具体阻碍。 审查受阻或推送未完成,都不算完成反馈处理。