SuperAPI AI 工具集

reviewing-prs

办公与效率

查看项目

更新于 10-15 21:43

技能介绍

用途:该技能提供一套用 gh CLI 检查 GitHub Pull Request、起草评审反馈并发布评论文本的通用工作流,来源为 flutter/devtools。

主要能力与使用方式:

  1. 用 GitHub CLI 获取信息:用 gh pr view <pr-number> --repo <owner/repo> --json title,body,author,state,headRefName,baseRefName,comments,reviews,files 获取 PR 详情;用 gh pr diff <pr-number> --repo <owner/repo> 获取代码差异;用 gh api repos/<owner/repo>/pulls/<pr-number>/comments 查看已有行内评论;用 gh pr checks <pr-number> --repo <owner/repo> 查看 CI/状态检查。
  2. 检查上下文与既有反馈:阅读 PR 描述、关联 issue 与完整 diff,确认既有机器人或人工评论是否已在后续提交中处理。
  3. 起草评审意见:评论应直接、简洁,聚焦代码质量与正确性;批准类评论保持简短(如 LGTM 或“A couple comments but lgtm.”),避免空泛赞扬或复述 PR;可操作反馈需引用具体文件、行号与理由。
  4. 先展示草稿,仅在用户明确批准后才发布。

限制与严格约束:绝对不能在没有用户事先明确批准的情况下向 GitHub 发布评论或评审;必须先在自然语言中向用户展示草稿评审意见,并询问“Would you like me to submit this review to GitHub?”,只有获得明确批准后才执行写命令(gh pr comment、gh pr review)。批准后发布的示例命令为 gh pr review <pr-number> --repo <owner/repo> --comment --body "<approved review text>"。资料未提供其他安装、收费或平台细节。