SuperAPI AI 工具集

pr

编程与开发

查看项目

更新于 10-16 05:42

技能介绍

用途:对拉取请求(PR)或 issue 做综合评审。PR 评审聚焦代码质量、架构、测试覆盖与范围蔓延(混入的无关改动);issue 则转为理解问题并起草有用评论。

触发方式:用户说 review pr 123、check pr 123、look at pr 123、review the pr、review draft pr、comment on issue 42 等。

工作流:先获取 PR 元数据、讨论历史与合并状态,再询问评审模式——Full(默认)或 Quick。Full 路径会创建工作树并启动子代理做深度分析(读取改动文件、运行验证、架构与范围蔓延检查、清理),随后呈现精简结论、解决开放问题、起草评审评论。Quick 路径只读 diff,概括做了什么/为什么/规模,标记明显问题,再起草评论。

类型识别:若给的是 URL,检查是否含 /pull/ 或 /issues/;若只给编号,可用 gh pr view <number> --json number 2>/dev/null && echo "PR" || echo "ISSUE" 判断。issue 走 Issue Comment Flow,跳过所有 PR 专属阶段。

Issue 流程:用 gh issue view <number> --json title,body,author,state,labels,comments,createdAt 获取详情,阅读完整讨论,必要时查代码库,起草评论后经确认再以 gh issue comment <number> --body-file /tmp/issue-comment.md 发布。

评审要点:检查合并状态(mergeable、mergeStateStatus、statusCheckRollup),分析已有讨论,不重复已解决或用户已提出的问题,也重视 Copilot 等自动评审中有价值的发现。起草评论前先调用 writing-style 技能,不重述 PR 做了什么,只写需修复的问题、待澄清的设计和 LGTM。

限制:技能描述与文档未说明支持的具体平台范围、依赖版本、收费情况或效果保证;相关事实暂未提供。