SuperAPI AI 工具集

the-judge

通用与其它

查看项目

更新于 10-16 03:05

技能介绍

The Judge 是一个面向代码审查的智能体技能,目标是以资深工程师的标准审查拉取请求(PR),只给出少量但每条都有证据支撑的意见,并通过 gh CLI 以单条整合的 GitHub 审查形式发布,包含行内评论。

主要能力与规则:证据优先,内部结论需已验证的 file:line 引用,外部结论需本次审查中获取的官方来源 URL,无证据不发布;不得凭记忆断言依赖或框架行为,须查官方文档、变更日志或安全公告;行内 nit 评论最多 5 条,超出部分只在摘要中计数;仓库自身工具(lint、类型检查、测试)能发现的问题不重复评论;所有评论与摘要须通过 scripts/review_gate.py 且退出码为 0。

严重级别分为 blocker(🔴,影响是否合并)、should-fix(🟠,真实缺陷但非合并风险)、nit(🟡,最多 5 条行内)、pre-existing(🟣,仅摘要)。判定映射:存在 🔴 则 REQUEST_CHANGES;无 🔴 且无 🟠 则 APPROVE;其余为 COMMENT。审查自己提交的 PR 时 GitHub 返回 422,脚本会改为 COMMENT 并在摘要末尾说明预期判定。

使用方式:通过 gh 命令解析上下文,如 gh pr view --json number,title,body,author,url,baseRefName,headRefName,additions,deletions,changedFiles、gh api user --jq .login、gh pr diff <number>;运行 gh pr diff <number> | python3 scripts/scan_bypasses.py 做确定性绕过扫描;随后进行强制外部研究、六轮审查(正确性、安全、结构、AI 冗余注释、PR 描述声明、绕过与重复)、验证、撰写 findings.json,再依次运行 python3 scripts/review_gate.py findings.json 与 python3 scripts/post_review.py findings.json 发布。

适用场景:需要高质量、低噪音、可收敛的 PR 审查流程的团队。限制:依赖 gh CLI 与仓库自身工具链;不安装任何工具;不审查机械/生成文件;第 2 轮起只检查上一轮发现是否解决并仅接受新 blocker,最多 3 轮;语言默认英文,可按调用指定。具体安装方式与更多细节暂未提供。