SuperAPI AI 工具集

gh-review-requests

编程与开发

查看项目

更新于 10-16 09:48

技能介绍

用途:获取指定 GitHub 团队的未读 review_requested 通知,筛出仍处于开放(未合并)状态的 PR,得到过滤后的评审队列,而不必手动浏览 GitHub 通知。

主要能力:按团队过滤,支持团队标识(slug)或显示名称(传入脚本前转换为小写连字符格式);一次可传多个团队(逗号分隔)。输出 JSON,包含 total 与 prs 数组,每条含 notification_id、title、url、repo、pr_number、author 和 reasons;reasons 可能为 "review requested from: 团队名" 或 "opened by: 登录名",也可能两者都有。

使用方式:前置要求是已通过验证的 GitHub CLI(gh)。未指定团队时先询问要按哪个团队过滤。脚本调用示例:uv run ${CLAUDE_SKILL_ROOT}/scripts/fetch_review_requests.py --org getsentry --teams <team-slug>;多团队时传逗号分隔列表。结果以 markdown 表格展示,含完整 URL;若 total 为 0,则回复“No unread review requests found for that team.”。

回退方案:脚本失败时可手动执行 gh api notifications --paginate,再对每条 review_requested 通知依次检查:gh api repos/{repo}/pulls/{number}(state 为 closed 或已设 merged_at 则跳过)、gh api repos/{repo}/pulls/{number}/requested_reviewers(查看 teams[].name)、gh api orgs/{org}/teams/{slug}/members(判断作者是否为成员)。

适用场景:需要查看某团队相关 PR 评审请求、查看自己或队友待评审的开放 PR 时使用。

限制:仅在任务明确符合上述范围时使用;输出不能替代针对具体环境的验证、测试或专家评审;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。认证方式、速率限制与费用等信息资料暂未提供。