用途:审查 GitHub Pull Request 或本地 Git 分支差异,输出代码审查报告,并按需将意见以行内评论形式发布到 GitHub。
主要能力:
- 三维修偏执分级(OQ3):计算 Audience Ring(0 至 4B)、作者领域置信度与可逆性,据此选择 Standard(单遍)或 Deep(多子代理并行)审查模式。
- 双轴评估:核对关联 issue 的需求可追溯性(gh issue view <N>),并对接 ~/.agents/CODING_STANDARDS.md 与 RUBRIC.md 的 13 角度缺陷评分表。
- 对抗性 Inquisitor 过滤与可点击固定链接:候选发现需通过 RUBRIC.md 中的五道 Inquisitor 过滤,并直接链接到 GitHub 源码行。
- 两级所有权动作闸门(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,除非传入深度标志或为单向门变更。部分环境变量与路径细节以实际运行环境为准,其余事实暂未提供。