返回精选库
gh-address-comments·开发与工程

gh-address-comments:把 PR 评审意见逐条落实到代码(旧版独立 Skill)

本页介绍已弃用的 openai/skills 仓库保留的旧版。安装前请先核对当前官方项目。 查看当前 OpenAI 插件

本文目录

PR 里同时出现行内评论、一般讨论和多轮回复时,容易漏掉需要修改的地方。gh-address-comments 先汇总当前分支关联 PR 的反馈,给每项编号并说明需要做什么,再按你选择的范围修改代码。它适合接手评审回合,而不是代替你判断所有建议都应该接受。

安装与准备

本文介绍 openai/skills 保留的独立 Skill 版本。该仓库已弃用,当前官方示例转至 openai/plugins;这里的步骤对应本页链接的旧仓库版本,不代表最新插件。

在 Codex 对话框输入下面这一行;它不是终端命令。安装后若找不到该 Skill,重启 Codex 再试。

提示词
$skill-installer gh-address-comments
  • 已检出目标 PR 分支的本地 Git 仓库
  • GitHub CLI gh 已安装并能访问仓库
  • 有权读取 PR;修改应在你的工作副本中完成

在终端用 gh auth status 检查登录;未登录时运行 gh auth login 完成浏览器授权。GitHub CLI 的权限与当前账号决定哪些私有 PR 可读。 [4]

第一次怎么用

在目标 PR 分支里,可以先请求一份评审清单:

提示词
$gh-address-comments
检查当前分支 PR 的评审意见。先按编号列出每条意见、所在文件、讨论结论和建议改动,标出已过时或可能重复的意见;等我选定编号后再修改。保留现有未提交改动,不自动回复评论或合并 PR。

接下来怎样推进

  1. 确认 PR 身份。 检查当前仓库和分支,核对 PR 链接,避免把另一个工作树的反馈带进来。

  2. 选择需要解决的意见。 阅读编号清单,告诉 Codex 要处理哪些;对相互矛盾的建议先明确取舍。

  3. 检查每条修改。 让它把选中的意见对应到 diff 和相关验证,并报告尚未处理的编号。回复评审和发布修改可以另行安排。

一次评审怎么处理才不会漏项

在目标 PR 的分支上开始,先用 gh auth status 确认账号,再把 PR 链接交给 Codex。要求它按线程列出编号、评论人、受影响的文件、要解决的问题和当前状态。评审里常有已经过时的意见、单纯提问或互相冲突的建议;先选出真正需要修改的编号,再开始编辑。你可以说:“先只处理第 2 和第 4 条;第 3 条先解释为什么与现有接口约定冲突。”

处理一条评论时,先读它针对的 diff 和当前代码,避免修复旧行号却破坏新实现。修改后按问题选择最相关的测试、类型检查或手工复现。让 Codex 返回“编号 → 改动位置 → 验证结果”的简短对应表,这样复审时能知道哪些意见已解决、哪些需要继续讨论。

另一个场景:两条评审意见互相牵连

例如一位评审要求“删去重复的数据读取”,另一位要求“每次保存后都刷新列表”。可以输入:“先列出这两条评论各自针对的代码和预期,不改动;解释是否真的冲突,以及可以同时满足的最小方案。” 先读完整线程和当前 diff,再决定是修改实现、补测试,还是在评审中澄清误解。完成后检查刷新时机、请求数量和错误状态,尤其不要为减少一次请求而让保存后的列表显示旧数据。若某条已被后来提交解决,也应在编号清单中标为已处理,而不是重复修改。

完成标志与边界

完成本地改动并不等于已经在 GitHub 回复评审、推送分支或解决线程。交付时确认当前工作区的 diff、失败的验证以及尚未处理的评论;是否发评论或推送应单独明确。若脚本拿不到评论,先核对当前分支是否真有打开的 PR、账号是否有读取权限,不要凭浏览器通知里的片段猜测线程内容。

交付后先检查什么

你应拿到“意见编号 → 改动文件 → 验证结果”的对应关系。先对照原评论确认问题得到解决,再检查是否引入了意见之外的大幅重构;意见被整理或代码被改动,都不自动代表评审线程已经关闭。

脚本找不到时先检查安装目录

如果提示 fetch_comments.py 不存在,先区分“目标仓库里没有”和“安装的 Skill 里没有”。该脚本应从 Skill 自身的 scripts/ 目录定位;有用户报告 Agent 误在业务仓库查找,连续多次走了 GraphQL 兜底。即使成功拉到评论,也应回到原 PR 核对线程位置和是否仍未解决,避免根据过期评论改错文件。

常见卡点

找不到当前 PR。 检查当前分支是否确实有已打开的 PR,必要时直接提供准确链接并检出对应分支。

评论读不全或认证失败。 重新检查 gh 账号、仓库访问权限和限流情况,不靠猜测补全线程。

意见已经过时。 要求对照当前代码判断它是否仍成立,再决定修改或解释原因。

你的首次任务进行得怎么样?

选择项通过网站统计帮助我们了解常见卡点。屏蔽统计可能导致无法送达;具体问题请通过邮件反馈。

参考来源

  1. gh-address-comments:独立 Skill 使用说明OpenAI
  2. openai/skills 仓库状态与安装说明OpenAI
  3. Codex:构建与安装 SkillOpenAI
  4. GitHub CLI 登录说明GitHub
  5. gh-address-comments can’t find scripts/fetch_comments.py and falls back to GraphQLbc-lee
发现过期或有误的信息?告诉我们

继续发现

其他值得了解的技能。