SuperAPI AI 工具集

review-pr-comments

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:按顺序处理当前分支 PR 上的全部评审反馈,把每条评论当作要回应的事项,把其背后的问题当作只修一次的工作。同一改动的多条评论共用一个提交,并在后续每条评论下回复指向该提交(例如“Addressed in <sha> — same fix as …”)。

前提:gh 已认证(gh auth status);当前检出分支存在对应 PR(gh pr view 不带编号即指向它);遵守仓库的 git 写入规则,未经本次会话授权不得提交或推送。

主要能力与用法:先用 gh pr view --json number,url,title,headRefName,baseRefName 确认 PR,无 PR 则停止并告知用户。加载评审材料时不要跳过行内评论:gh pr view 的 comments、reviews、latestReviews 只含 issue 级对话与评审摘要,不含逐行的 PullRequestReviewComment。行内评论需用 REST 的 gh api repos/{owner}/{repo}/pulls/<n>/comments --paginate,或 GraphQL reviewThreads(含 id、isResolved、body、path、line、author)。将 issue 评论与行内评论合并、按时间排序成工作清单,同类需求聚类。逐条阅读、判断(改动请求/提问/小意见/讨论),必要时做范围内修复;共享问题时只提交一次,推送后用 git rev-parse HEAD 取 SHA 用于回复。回复位置:时间线用 gh pr comment;行内线程用 gh api -X POST repos/{owner}/{repo}/pulls/comments/<COMMENT_ID>/replies;需要时可 gh pr review --comment。解决线程用 GraphQL resolveReviewThread,参数为 thread.id。

限制与注意:gh pr view 无法获取行内评论,必须补充 REST 或 GraphQL;不要用 gh pr comment 代替行内线程回复;不要静默推送;不要把不相关修复混入一个提交;仍处于讨论中的线程不要标记解决。仓库授权与团队实践细节资料未完整提供。