SuperAPI AI 工具集

address-github-comments

编程与开发

查看项目

更新于 10-15 15:46

技能介绍

用途

该技能用于在开放的 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。

限制

  • 仅在任务明确匹配上述范围时使用本技能。
  • 不要将输出视为环境特定验证、测试或专家评审的替代。
  • 若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。