SuperAPI AI 工具集

pr-review-navigator

通用与其它

查看项目

更新于 10-15 20:14

技能介绍

用途:为人工代码审查生成导航辅助,帮助审查者更快进入状态。它只提供定位与结构,不做预审或质量判断,也不解读业务意图或目的,仅对变更内容做事实性描述。

主要能力:接收必填参数 pr-number(要审查的 PR 编号),可选 --comment 将结果作为 PR 评论发布,省略时写入本地 markdown 文件。流程包括:用 gh pr view $ARGUMENTS --json title,body,files,additions,deletions,url 获取 PR 信息;用 gh pr diff <pr-number> 获取差异;分析依赖关系;按由外到内的顺序确定审查顺序(API 端点/HTTP 路由/GraphQL 解析器、服务/业务逻辑层、仓储/持久化层、数据模型/实体、装配/配置、单元测试、Cornichon/集成测试最后);生成 Mermaid flowchart TB 图,节点带圈号、依赖箭头、按架构层分组,单元测试绿色、集成测试蓝色虚线;生成含编号、文件名、事实性说明和 PR 文件锚点链接的审查表格。文件链接通过文件路径的 SHA256 哈希构造:hash=$(echo -n "<filepath>" | shasum -a 256 | cut -d' ' -f1),链接格式为 https://github.com/{owner}/{repo}/pull/{number}/files#diff-{hash}。无 PR 的提交/分支使用 git show --name-status 和 git diff,并省略链接列。

使用方式:提供 PR 编号运行;加 --comment 则用 gh pr comment <pr-number> --body "<content>" 发布评论,否则写入工作区根目录 pr-review-navigator.md 并告知路径。输出为 markdown,含摘要、Mermaid 图和审查顺序表。

限制:仅辅助审查定位,代码质量、正确性和批准由人工判断;PR 超过 30 个文件时建议分块审查;摘要只陈述变更事实,不使用“optimized for”“designed to”“intended for”等表述。其他收费、平台与效果信息暂未提供。