SuperAPI AI 工具集

structural-pr-review

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:作为结构化语义代码审查器,对 Pull Request 建立架构心智模型,跨组件边界追踪数据流(API 契约、类型转换、错误传播),对照代码库惯例与自定义规则,按影响范围分级并给出可执行的审查意见。输出为单条结构化 PR 评论,需使用 HTML 标题标签以获得一致渲染。

主要能力:按固定章节输出——Summary(目的、关键变更、优点、问题、设计边界)、Confidence Score(1-5 分,反映累积风险而非问题数量)、Important Files Changed(文件表)、Diagram(一张 Mermaid 图:多组件流程用 sequenceDiagram,单组件决策逻辑用 flowchart TD,纯样式改动用跳过)、Inline Findings(按行给出问题与修复建议)、Comments Outside Diff(仅当未改动代码受本 PR 影响时)、Footer(最后审查提交与轮次)。严重度仅三级:P0 数据丢失/安全漏洞/鉴权绕过等;P1 影响运行时正确性的缺陷、跨租户数据泄露、静默失败、错误处理改变控制流等;P2 性能、代码卫生、可观测性、可维护性。审查维度覆盖安全与数据暴露、API 契约与错误处理、运行时/平台差异、性能与并发、类型安全、代码质量、UI/UX 正确性、跨文件一致性。支持多轮审查协议(确认已解决项、区分遗留项、更新评分、递增轮次)。

适用场景:Claude Code 技能、GitHub Action、Gitea CI 步骤或独立调用。需输入 PR 描述与元数据、完整 diff、所有变更文件全文、仓库自定义规则及历史评论;需能读取 diff 之外的文件。

使用方式:可用 gtr 或 gh 发布,例如 gtr comment --owner OWNER --repo REPO --index IDX --body-file /tmp/review.md,或 gh pr review <PR> --comment --body-file /tmp/review.md。每轮只发一条评论,行级问题优先用行内评论。自定义规则以 name/description/severity/pattern/fix 格式定义,冲突时优先于通用启发式。

限制:不评论风格偏好、命名、自解释代码缺注释、锁文件与纯格式改动;不为凑篇幅输出空章节;不对已标记解决的问题重复提出,除非先验证修复。资料未提供具体安装命令、收费方式与平台支持细节。