SuperAPI AI 工具集

pr-review

通用与其它

查看项目

更新于 10-15 23:45

技能介绍

用途:审查 GitHub Pull Request 或本地 Git 分支差异,输出代码审查报告,并按需将意见以行内评论形式发布到 GitHub。

主要能力:

  1. 三维修偏执分级(OQ3):计算 Audience Ring(0 至 4B)、作者领域置信度与可逆性,据此选择 Standard(单遍)或 Deep(多子代理并行)审查模式。
  2. 双轴评估:核对关联 issue 的需求可追溯性(gh issue view <N>),并对接 ~/.agents/CODING_STANDARDS.md 与 RUBRIC.md 的 13 角度缺陷评分表。
  3. 对抗性 Inquisitor 过滤与可点击固定链接:候选发现需通过 RUBRIC.md 中的五道 Inquisitor 过滤,并直接链接到 GitHub 源码行。
  4. 两级所有权动作闸门(OQ1):区分自有分支(可本地自动修复并运行 kscripts pr-check)与外部/同伴 PR(严格只读本地检出)。

使用方式:

  • 指定 PR:gh pr view <PR> --json author,headRepositoryOwner,headRepository,headRefName,baseRefName,headRefOid,number,title,body,url 与 gh pr diff <PR>。
  • 本地分支/工作树(无参数):用 git merge-base 计算基线后执行 git diff ${TARGET_BASE}..HEAD,并用 gh pr view --json 识别 PR。
  • 关联 issue:gh issue view <N> --json title,body。
  • 报告写入 <appDataDir>/brain/<conversation_id>/pr_review_<PR>.md;子代理需直接返回 markdown 供父代理写入。
  • 可传 --deep / --paranoid 强制 Deep 模式。

适用场景:Dart 与包级代码审查、公共 API 表面验证(dart run api_summary@^1.1.0)、测试反同义反复检查、复杂跨文件重构审查。

限制:报告区分内部证据与外发行内评论,外发评论限 50 词以内且不得泄露内部 Inquisitor 证据;外部 PR 为严格只读检出,不本地修改;Ring 0-2 默认 Standard,除非传入深度标志或为单向门变更。部分环境变量与路径细节以实际运行环境为准,其余事实暂未提供。