SuperAPI AI 工具集

review-pr

编程与开发

查看项目

更新于 10-16 06:46

技能介绍

用途:在交接代码前做一次显式的本地自审,审查暂存/未提交改动,或工作树干净时审查当前分支相对基线的 diff;仅在用户明确指向已有 PR 时输出交接摘要。

主要能力:按严重级别(severity)筛选高置信度问题,涵盖编译/类型/导入错误、明确逻辑或状态错误、有直接利用路径的安全风险、可测量的性能回归、缺失必要回归或验证测试、修复缺陷却无先失败后通过的测试、改动导致的 lint/类型检查/测试失败、明确的指令文件违规(引用规则并核对范围)、YAGNI 与 KISS 违规。同时检查 AGENTS.md / CLAUDE.md 等仓库指令文件,仅应用改动路径范围内的规则。

使用方式:先发现审查目标(优先暂存或未暂存改动,否则分支 diff),采集变更意图与范围指令文件,运行项目 lint、类型检查、测试命令并记录既有失败作为基线;逐条核对具体行,仅保留高置信度问题,合并同根因评论。报告分 Must fix before push、Should fix soon、Ready for handoff 三部分,每条含严重级别、文件路径与行号、事实性标题、影响说明与可提交的修复建议。无问题时输出无阻塞项说明。需格式参考可读 references/comment-examples.md,判断严重级别可读 references/severity-rubric.md,涉及认证、输入处理、外部 API、文件上传或环境配置时读 references/security-checklist.md,涉及数据获取、渲染、图片、依赖或打包导入时读 references/performance-checklist.md,判断是否移交 PR 工作流时读 references/review-surfaces.md。

适用场景:本地自审、交接前检查、分支审查。

限制:不用于入站 PR 评论或线程解决(应使用 pr-comments);不发布行内评论、不解决线程;不标记风格偏好、与改动无关的既有问题、依赖未知输入的潜在问题、仅由 linter 捕获的问题及已显式静默的违规;不用于泛化替代原生 PR 审查工具。官方文档未提供更多安装与配置细节。