关于 address-pr-comments
address-pr-comments 是一项技能,可查找当前分支的开放 PR,并通过 gh 处理审查评论。它涵盖问题筛选、代码修复、验证、提交推送及 CI 跟进。
主要功能
- 01获取 PR 评论和审查线程
- 02筛选可执行的问题
- 03应用并验证代码修复
- 04解决审查线程或回复评论
- 05提交、推送并监控 CI
适用场景
- 01处理当前分支开放 PR 的反馈
- 02区分有效缺陷与提问或建议
- 03验证修复并跟进 CI 失败
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ gannonh/ skills --skill address-pr-comments安装后在 Claude Code 中输入/address-pr-comments确认已加载。
附带文件scripts/fetch_comments.py
详细介绍
PR 评论处理程序
使用 gh CLI 查找当前分支对应的未合并 PR,并处理其中的评论。运行所有 gh 命令时都要使用提升的网络权限。
预检
- 创建包含以下步骤的结构化任务列表
- 告知用户你正在做什么
你应尽力自主完成整个工作流,只有遇到问题或不确定如何妥善处理时才联系用户。
步骤 1:检查需要处理的评论
- 运行
<path-to-skill>/scripts/fetch_comments.py,该脚本会打印 PR 中的所有评论和审查讨论串
步骤 2:列出评论和审查讨论串中发现的问题
- 为所有审查讨论串和评论编号
- 简要总结每个“候选问题”,包括审查者建议的修复方案
步骤 3:确定可处理的问题
- 针对每个候选问题,结合代码库进行分析,区分可处理事项与误报或无需更改代码的评论(例如,问题、建议或风格评论)。
- 根据当前代码验证每项发现。仅计划修复仍然成立的问题,以简要理由跳过其余问题,尽量减少更改,并进行验证。
步骤 4:修复所有可处理的问题并解决/回应评论
- 尽可能采用 TDD:先编写一个能复现问题的失败测试,再应用修复,使测试通过。
- 处理评论时,在 GitHub 界面中解决或回复相应的讨论串。对于未处理的评论,向审查者说明理由并请求澄清(如有需要)。
步骤 5:运行检查、提交并推送更改
- 应用修复后,在本地运行相关测试和检查,确认问题已解决。
- 总结所做更改,使用清晰的提交说明并注明 PR 和问题编号,然后将更改推送到 PR 分支。
步骤 6:监控 CI Actions 并处理任何新故障
- 推送后,监控 PR 的 CI 检查,留意更改可能引发的新故障。
- 如果出现新故障,使用
gh-fix-ci技能分析 CI 日志、找出根本原因并应用必要的修复。
最终验证和总结
- 仔细确认所有评论都已在 GitHub 界面中处理并解决。
- 总结评论处理的结果,包括尚未解决的问题或需要与审查者跟进的事项。
注意:
- 如果 gh 在执行过程中遇到身份验证或速率限制问题,请提示用户使用
gh auth login重新进行身份验证,然后重试。 - 如果沙盒限制导致
gh auth status无法运行,请使用sandbox_permissions=require_escalated重新运行。
评论
支持 Markdown