SuperAPI AI 工具集

pr-fix

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:对 PR 做完整分诊、修复与合并前预检,诊断合并冲突、CI 失败、机器人评论和评审请求等问题并修复,推送前强制执行 /pre-commit,最后交给 /pr-merge 执行合并与合并后流程。用法:/pr-fix <pr-number>。与 /pr-merge 的分工是:/pr-fix 负责分诊问题、修复并做预检,停留在 PR 分支;/pr-merge 负责验证就绪、执行合并及合并后工作流(文档、里程碑、发布)。已知有问题时先用 /pr-fix,预期已就绪时用 /pr-merge。

主要能力:先执行 gh pr checkout <pr-number> 检出分支,再并行检查四类来源:PR 元数据(mergeable、isDraft、state、reviewDecision、增删行数)、CI 检查状态、机器人行内评论(Codex、Gemini 等)、顶层评审状态;如为双远端项目还会检查 Forgejo CI。机器人评审未完成时最多轮询 3 次、间隔 30 秒。

分诊决策:硬性停止条件包括 mergeable 为 CONFLICTING(提示先解决冲突)、isDraft 为 true、state 非 OPEN;软性问题(CI 失败、机器人 P1/P2 评论、CHANGES_REQUESTED)进入修复循环;REVIEW_REQUIRED 留到交接阶段处理;全部通过则跳过修复直接进入预检。

修复循环:一次只修一类问题,本地验证后再继续。资料给出构建/依赖、测试失败、代码质量、安全问题的常见修复命令,以及按失败类型(单元测试、集成测试、安全测试、类型、lint、文档)的实现建议;机器人评论按 file:line 逐条处理,P1 优先于 P2;人工 CHANGES_REQUESTED 需全部处理并回复。还按 JavaScript/TypeScript、Python、Docker/基础设施给出快速参考命令。

预检与推送:推送任何修复前必须运行 /pre-commit(质量检查→测试→覆盖率→安全扫描→变更日志→companion gate);大 diff(增删超过 200 行)还需先运行 /review changes --quick,处理 BLOCK 级发现。通过后提交并推送,用 gh pr checks <pr-number> --watch 监控 CI,双远端项目另监控 Forgejo CI,失败则回到修复循环。

交接:若 REVIEW_REQUIRED,建议先运行 /review pr <N> 获取外部 AI 评审,再运行 /pr-merge <N>;合并决策、分支清理、里程碑检查和发布就绪由 /pr-merge 负责,此处不自动合并。

限制:资料未提供该技能的安装方式、收费、支持平台或效果数据;命令中的部分片段(如 Forgejo 相关变量与 URL)在原文中不完整,需按实际环境补全。