用途
该技能用于在开放的 GitHub Pull Request 上处理评审评论或 issue 反馈,借助 GitHub CLI(gh)系统化地逐条回应。适用于已有 PR 存在评审线程或 issue 评论、需要限定范围的代码修复并给出有证据回复的场景。
前置条件
需确保 gh 已认证:
gh auth status
若未登录,运行 gh auth login。
工作流程
1. 检查评论
获取当前分支 PR 的评论:
gh pr view --comments
--comments 显示会话评论,但不会枚举每个行内评审线程。需使用可用的 GitHub 连接器或 GraphQL 的 pullRequest.reviewThreads 连接并分页,以检查行内评论、文件/行锚点及解决状态。记录仓库、PR 编号、当前 head SHA、线程 ID 与变更请求。
2. 分类与规划
列出评论与评审线程,为每条提出修复方案。对已包含在用户请求范围内的反馈直接处理;仅当反馈冲突、扩大范围或需要重大取舍时才询问。
3. 应用修复
阅读周边实现,保留无关改动,针对选定评论应用变更。运行相关仓库检查,并将结果绑定到更新后的 head 后再报告修复。
4. 回复评论
在用户授权发布回复后,附上提交与验证证据进行回复:
gh pr comment <PR_NUMBER> --body "Addressed in <commit SHA>; verified with <check and result>."
会话评论不能解决行内评审线程。仅在该线程的请求确实已处理且解决操作获得授权后,才通过支持的 GitHub API 解决特定线程;否则留下拟议回复供用户确认。
常见错误
- 未理解上下文就应用修复:始终阅读评论周边的代码。
- 未验证认证:开始前检查
gh auth status。
限制
- 仅在任务明确匹配上述范围时使用本技能。
- 不要将输出视为环境特定验证、测试或专家评审的替代。
- 若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。