SuperAPI AI 工具集

iterate-pr

编程与开发

查看项目

更新于 10-15 21:51

技能介绍

用途:在当前分支上持续迭代,直到所有 CI 检查通过且评审反馈得到处理。需要已认证的 GitHub CLI(gh)。所有脚本必须从仓库根目录(.git 所在处)运行,通过 ${CLAUDE_SKILL_ROOT} 使用脚本完整路径。

主要能力:附带两个脚本。fetch_pr_checks.py 获取 CI 检查状态并从日志提取失败片段,用法:uv run ${CLAUDE_SKILL_ROOT}/scripts/fetch_pr_checks.py [--pr NUMBER],返回含 pr、summary、checks 的 JSON。fetch_pr_feedback.py 获取并按 LOGAF 分级归类评审反馈,用法:uv run ${CLAUDE_SKILL_ROOT}/scripts/fetch_pr_feedback.py [--pr NUMBER],分为 high(合并前必须处理)、medium(应处理)、low(可选)、bot(信息性自动评论)、resolved(已解决)。评审机器人反馈(Sentry、Warden、Cursor、Bugbot、CodeQL 等)带 review_bot: true,归入 high/medium/low,不放入 bot 桶。

工作流:1) 用 gh pr view --json number,url,headRefName 识别 PR,无 PR 则停止;2) 运行 fetch_pr_checks.py 获取失败数据,若评审机器人检查仍在运行则等待;3) 阅读 log_snippet 与相关代码后做最小针对性修复,不要仅凭检查名猜测;4) 运行 fetch_pr_feedback.py 获取分级反馈;5) 按优先级处理:high/medium 自动修复(含 review_bot 项,误报则跳过并简要说明原因,不得静默忽略),low 列出编号让用户选择,resolved 与信息性 bot 评论静默跳过;6) git add、git commit、git push;7) 用 gh pr checks --watch --interval 30 等待;8) 若 CI 失败或出现新反馈则回到第 2 步。

退出条件:成功为所有检查通过、无未处理 high/medium 反馈且用户已决定 low 项;同一失败重试 3 次后、反馈需澄清或基础设施问题时应求助;无 PR 或分支需 rebase 时停止。脚本失败时可回退用 gh 命令:gh pr checks --json name,state,bucket,link、gh run view <run-id> --log-failed、gh api repos/{owner}/{repo}/pulls/{number}/comments。