用途
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:
→ 非资产文件的精确路径映射表 → 直接位于 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 严重程度必须人工分诊。
(资料来源未提供具体收费、价格、平台与效果信息。)