SuperAPI AI 工具集

pr-review-navigator

编程与开发

查看项目

更新于 10-15 20:14

技能介绍

用途:在开始审查 PR 时生成导航辅助材料,帮助审查者快速定位大型或复杂 PR 的结构与审查顺序。它只提供事实性描述和结构梳理,不做业务意图解读或代码质量判断。

主要能力:获取 PR 信息与 diff,分析文件依赖关系,按由外到内的顺序确定审查顺序(API 端点、服务/业务逻辑层、仓储/持久层、数据模型、装配/配置、单元测试、Cornichon/集成测试最后),生成 Mermaid 流程图(含编号节点、依赖箭头、按架构层分组、单元测试绿色、集成测试蓝色虚线边框),并生成带编号的审查表格(含文件、功能描述、PR 内文件锚点链接)。

使用方式:参数 pr-number 必填,--comment 可选。未提供 --comment 时写入工作区根目录的 pr-review-navigator.md;提供时通过 gh pr comment 发布为 PR 评论。使用 gh pr view、gh pr diff 获取信息,无 PR 的提交/分支改用 git show --name-status 和 git diff。文件链接通过文件路径的 SHA256 哈希构造。

适用场景:大型或复杂 PR 的审查起步阶段,帮助审查者建立整体认知。

限制:仅辅助审查定位,所有代码质量、正确性和批准判断由人工审查者做出;不解读业务意图或价值;PR 超过 30 个文件时建议分块审查。