SuperAPI AI 工具集

review-pr

部署与运维

查看项目

更新于 10-15 21:46

技能介绍

用途:自动化审查一个 Pull Request,并持续跟踪其后续变化。传入 PR 编号或 URL 作为参数;若未提供,会用 gh pr list 列出开放 PR 让用户选择。

主要能力:一、基线审查:用独立子代理(干净上下文)读取 gh pr diff 与该 PR 标题/正文,产出 path:line 形式的发现,作为第一批评论进入分流流程。二、持久监视:通过 Task 启动 persistent: true 的 Monitor,运行 ${CLAUDE_PLUGIN_ROOT}/skills/review-pr/scripts/review-loop.sh,并传入 PR、REPO、INTERVAL 环境变量(脚本也接受 --pr/--repo/--interval)。轮询间隔按新增+删除行数选择,小/中/大为 180/300/480 秒,下限 60 秒、上限 7200 秒。三、事件响应:[ci] 失败会拉取日志并修复、提交推送;[comment] 批量评论交给独立分流代理,只采纳修复类结论,其余驳回或升级;模糊评论只发通知并上报,不猜测、不回复。

用法要点:先用 gh pr view 解析出纯数字 PR,因为 gh api 的 URL 路径不能直接使用完整 URL;--auto-merge 是收尾选项,需在解析 PR 编号前剥离。修复提交用一条 git add/commit/push 完成;内联评论用 gh api repos/$REPO/pulls/$PR/comments/<id>/replies 回复,问题级评论用 gh pr comment。完全解决的问题评论标记为 OUTDATED 并解决对应线程。

停止与收尾:正常停止需 CI 全部通过、评论全部处理完毕、用户表示完成;达到约 2 小时上限或用户明确退出则强制停止。收尾时先执行 arm-closeout.sh 武装状态,再询问是否合并,只有选择合并才发布摘要评论并改写正文;合并后执行工作树移除、切换 main、同步 origin 等清理。限制:CI 与评论暂空不是停止信号;认证/权限、缺失密钥、抖动或基础设施类 CI 失败不自动修复;不强制更新长期分支;未提供具体平台与价格信息。