iterate-pr

iterate-pr - PR 自动迭代技能

技能概述

iterate-pr 是一个 GitHub PR 自动化处理技能，可以持续迭代当前分支直到所有 CI 检查通过并完成代码审查反馈处理，自动化反馈收集、代码修复、推送提交和等待检查的完整循环。

适用场景

1. CI 检查失败修复

当代码推送后 GitHub Actions 或其他 CI 系统检查失败时，iterate-pr 可以自动识别失败原因，获取详细日志，并引导修复流程。支持 Sentry、Codecov、Cursor、Bugbot、Seer 等常见代码质量检查工具。

2. 代码审查反馈处理

面对大量人工审查意见或机器人评论时，该技能能够系统化地收集所有反馈（包括内联评论和会话评论），验证每个问题的有效性，并指导进行有针对性的代码修改。

3. 持续迭代直到合并

在需要多次推送修复才能通过所有质量门禁的场景下，iterate-pr 会循环执行"检查-修复-推送-等待"流程，直到所有检查变为绿色且没有未处理的审查意见，确保 PR 符合合并标准。

核心功能

1. 智能 CI 状态检查

通过 gh pr checks 命令实时监控 PR 的所有检查状态，智能识别 pass、fail、pending、skipping 和 cancel 五种状态。特别针对 pending 状态的检查（如 Sentry、Codecov）提供等待建议，避免重复劳动。

2. 全面反馈收集

整合 GitHub CLI 的多个 API 端点，一次性收集审查状态、内联代码评论和会话评论。能够区分来自自动化工具的反馈和人工审查意见，优先处理真正需要修复的问题。

3. 验证与修复机制

在处理任何反馈前，要求先阅读相关代码上下文，验证问题是否真实存在，检查是否已在后续提交中修复。对于无效反馈可以跳过处理，确保只针对真实问题进行代码修改。

常见问题

iterate-pr 需要什么前置条件？

使用该技能需要安装并配置好 GitHub CLI (gh) 工具，且已完成身份认证（通过 gh auth login）。同时，当前分支需要已创建对应的 Pull Request，否则技能会提示无法继续。

同一个失败多次重试后会停止吗？

会的。如果同一个失败在尝试 3 次修复后仍然存在，技能会建议停止自动迭代，因为这可能是测试不稳定（flaky test）或需要人工判断的深层问题，应该寻求帮助而不是继续自动重试。

如何处理 Codecov 和 Sentry 这类检查的 pending 状态？

对于 Codecov、Sentry、Cursor、Bugbot、Seer 等可能发布评论的自动化检查，当它们处于 pending 状态时应该等待检查完成。这些工具往往会在检查完成后发布额外的反馈评论，过早处理可能导致重复工作。技能建议使用 gh pr checks --watch --interval 30 来等待所有检查完成。