SuperAPI AI 工具集

gitnexus-review

测试与质量

查看项目

更新于 10-15 08:15

技能介绍

用途

GitNexus Review 是 GitNexus 生态中一个只读的代码审查工作流技能,用于审查指定变更面上的代码改动。它不编辑源码、不提交、不推送、不发布评论或解决讨论线程;除非用户后续明确要求,否则这些操作不会被授权。它把 GitNexus 提供的结构化证据与源码检查结合起来,两者互不替代。

主要能力

目标解析:接受多种输入形式——GitHub PR 的 URL、owner/repo#42、#42 或裸编号;base...head(merge-base 范围);base..head(精确两点范围);分支、标签或提交(相对于仓库默认分支的引用);本地、已暂存、未暂存或工作树形式的本地改动;无目标时依次回退到当前分支的开放 PR、本地改动或当前分支。显式目标始终优先。裸编号仅在具备可用 gh 认证的 GitHub 仓库中解释为 PR,否则会要求提供引用或 URL。

变更面识别与前置信息记录:记录解析出的目标类型、仓库根、默认分支、base SHA、head SHA、适用时的 merge-base,以及纳入的本地状态。默认分支从远端元数据解析,仅作为显式回退时才使用 main 或 master,并说明何时这样做。

PR 处理:使用 gh pr view/gh api 固定 PR 编号、仓库、标题、URL、base 引用、base SHA、head 引用和 head SHA,在不切换用户分支的情况下获取这些精确提交;计算 git merge-base 作为审查基准,并以本地 git diff 作为完整差异的事实来源;对于 fork PR,会获取 pull ref 或贡献者远端。

分支/引用/范围处理:审查前将每个引用解析为提交。分支或 A...B 使用 merge-base 作为比较基准;显式 A..B 则把 A 作为精确基准。

本地改动处理:检查 git status --short、已暂存差异、未暂存差异及每个未跟踪文件,使用 detect_changes 按要求处理 staged、unstaged 或 all。未跟踪文件不保证出现在 Git diff 或图映射中,因此会直接读取并列入审查来源。

检出与索引对齐:复用处于精确目标 SHA 的现有工作树,否则创建临时分离工作树进行审查,并在之后仅移除该临时工作树,绝不切换或重置用户当前工作树。检查 GitNexus 状态,过期时运行 analyze --index-only 刷新;当差异可能触及信任或数据流边界时,同次刷新中加入 --pdg。

审查工作流:阅读完整差异与变更文件列表,区分生成文件、依赖变更、测试与行为变更;对精确变更面运行 detect_changes;对每个行为变更符号运行 includeTests: true 的上游影响分析;检查差异之外的所有直接(d=1)依赖;对关键或有歧义符号使用 context 并检查受影响的执行流;对信任或数据流边界上的改动运行 explain 并进行源→汇污点判断,必要时用 pdg_query 验证;检查测试是否覆盖变更行为、边界条件与受影响流程,并在可行时运行聚焦的只读验证。

专家视角与交叉视角:在完成编号工作流后,按图已知的功能区域对变更文件与符号分组,为每个触及区域分配专家视角;同时运行四个跨领域视角:架构契合度、语言一致性、完成的定义(DoD)和简洁性。工作量随变更面规模调整,多领域变更可为每个触及区域分配一个视角,在支持子代理的环境中并行运行。

Swarm 通道:随技能提供六个可调度的通道定义(位于 ci-personas/),包括五个发现通道(ci-correctness-lens、ci-security-lens、ci-blast-radius-lens、ci-coverage-lens、ci-adversarial-lens)和一个作为门禁的 ci-critic-lens。所有通道报告均被视为未经验证的声明,需重新锚定到差异、源码或自身图查询后再纳入审查。

发现标准:仅在变更引入具体缺陷、回归、安全问题、兼容性破坏、实质性覆盖缺口,或带有具体承载场景的可维护性成本时才报告。每条发现需包含严重程度与精确的 path:line 锚点、失败场景或契约、适用的 GitNexus 证据、现有代码或测试为何不能缓解、以及简明的修复或缺失测试建议。不报告风格偏好、既有问题、原始风险计数或推测。

使用方式

技能通过 GitNexus 工作流调用,输入目标形式(PR URL/编号、分支/引用/提交范围或本地改动描述)即可开始审查。它以只读方式运行,输出结构包括:按严重程度排序的发现项(若没有则明确说明)、变更与影响范围摘要、覆盖与残余风险、以及裁决结论。对于分支或本地审查,裁决使用 READY、NOT READY 或 NEEDS DISCUSSION,而非 PR 审批动作,并附上精确的目标 SHA,以便后续运行判断证据是否过期。

适用场景

适用于需要结合结构化代码图证据进行只读审查的场景,包括 GitHub PR 审查、分支或提交范围比较、以及本地工作树改动审查。特别适用于关注依赖影响范围、执行流、污点分析与安全边界、以及跨领域一致性检查的代码变更评估。

限制

该技能为只读,不执行编辑、提交、推送、发布评论或解决讨论线程。如果无法建立精确的目标检出或索引,会声明限制,且不声称完成完整的图支持审查。污点与依赖证据需要 PDG 层;若无法构建该索引,会声明污点检查被跳过,而非暗示覆盖。未跟踪文件不保证出现在 Git diff 或图映射中。关于收费、价格、平台等具体商业信息,资料中暂未提供。