SuperAPI AI 工具集

resolve-bot-reviews

编程与开发

查看项目

更新于 10-16 05:56

技能介绍

用途

resolve-bot-reviews 用于在一个工作流中完成 PR 上机器人代码审查评论的抓取、分类、修复与关闭。它专门处理来自 CodeRabbit 与 Gemini Code Assist 的审查评论。

主要能力

  • 抓取(Phase 1):从 PR URL 解析 owner、repo、pr number,通过 gh api graphql 一次性拉取全部 review threads,并过滤为机器人作者(前缀匹配 coderabbitai 或 gemini-code-assist)。
  • 分类(Phase 1d):为每条线程提取严重程度、文件、行号,并归类为 banned-word、em-dash、pattern-violation、security、logic-bug、doc-mismatch、structural 等类型;判断文件是否为构建产物。
  • 分诊(Phase 2):以表格形式呈现严重程度、文件、问题与建议动作(FIX/SKIP),等待用户确认或调整(--auto 可跳过确认)。含一组针对 training-pack PR 的硬编码跳过规则。
  • 修复(Phase 3):将评论追溯到源文件后按类型应用有界修复策略,规则包括绝不直接编辑构建输出文件;security、logic-bug、structural 且无明确自动修复时需用户确认;hook 文件若存在测试套件则在修复后运行测试。
  • 提交与推送(Phase 3.5):git add、git commit、git push,推送成功后才能进入下一阶段。
  • 关闭线程(Phase 4):用 GraphQL mutation resolveReviewThread 逐条关闭,并通过独立计数检查剩余未关闭线程,最后输出汇总。

使用方式

调用形式:

/resolve-bot-reviews <PR URL>
/resolve-bot-reviews <PR URL> --auto    # skip triage confirmation

流程按 Phase 1 抓取分类 → Phase 2 分诊 → Phase 3 修复 → Phase 3.5 提交推送 → Phase 4 关闭线程依次执行。

严重程度解析

  • CodeRabbit:Critical / Major / Minor(对应红、橙、黄圆点表情),或评论中出现 [nitpick] 归为 Minor。
  • Gemini Code Assist:![high]( 为 Critical,![medium]( 为 Major,![low]( 为 Minor。
  • 无严重程度标记时归为 Unspecified,且 Unspecified 线程须人工分诊后才能标记 FIX 或 SKIP,绝不自动 FIX。

源文件追溯

追溯是确定性的,不使用通配符猜测。优先级为:assets/R*.md 资产文件(按 R 编号 frontmatter 查找)→ 非资产文件的精确路径映射表 → 直接位于 training-playbook/training-pack/ 下的文件无需追溯。对于 hook 与 settings 文件,优先检查客户端覆盖路径 training-pack/client-overlays/{client}/.claude/...,否则回退到 base-claude 路径。

适用场景

适用于对 PR 上 CodeRabbit、Gemini Code Assist 等机器人审查评论进行批量分诊与修复的开发者工作流。

限制

  • 训练包(training-pack)范围限定:抓取/分类/关闭流程可复用,但跳过规则与源文件追溯逻辑专属于该 training-pack 构建系统。
  • 绝不编辑构建输出文件,所有修复只作用于源文件。
  • 必须在推送成功后再关闭线程(Phase 3.5 成功完成后才能开始 Phase 4)。
  • hook 修复后若存在测试套件需运行测试。
  • Unspecified 严重程度必须人工分诊。

(资料来源未提供具体收费、价格、平台与效果信息。)