pr-review-loop

该 Skill 构建了一个与 Greptile 深度集成的自主 PR 审查闭环系统，旨在将代码审查反馈的处理流程完全自动化。当用户触发审查循环后，系统通过 GitHub CLI 获取 Greptile 生成的最新审查意见，解析其中的质量评分（1-5 分制）。若评分达到 4 分及以上，系统自动执行合并并清理分支；若评分不足，Agent 会逐条分析审查评论，定位到具体代码位置，自动应用修复并提交更改，随后推送代码并重新触发 Greptile 审查，形成持续改进的闭环。系统通过本地 JSON 文件追踪审查轮次和评分变化，内置 5 轮循环上限和连续同分退出机制，防止资源浪费。

核心优势在于实现了真正的"无人值守"代码审查自动化，显著缩短 PR 合并周期，特别适合高频率提交的团队。与 Greptile 的量化评分机制结合，提供了客观的合并决策依据。基于 GitHub CLI 的实现确保了与 GitHub 生态的无缝兼容，而状态追踪机制避免了重复处理。智能升级功能可在检测到架构层面反馈时自动通知人工介入，平衡了自动化与关键决策的安全性。

局限性方面，作为 T3 来源的个人开发者项目，长期维护的持续性存在不确定性。功能高度耦合 Greptile 服务，若其 API 变更或不可用，循环将中断。自动合并机制在评分算法误报时可能过于激进，导致未充分测试的代码进入主分支。此外，实现基于 bash 脚本，对 Windows 原生环境支持有限。

适用群体主要包括已采用 Greptile 审查工具、面临大量重复性审查反馈的技术团队，以及希望将代码审查纳入 CI/CD 流水线的 DevOps 团队。特别适合遵循敏捷开发、追求快速迭代的中大型开发团队，能显著减少开发者在等待审查和处理反馈上的时间成本。

使用风险需重点关注自动合并的权限控制，关键架构变更或安全修复应禁用自动合并。依赖 GitHub CLI 认证状态意味着权限变更或认证过期会导致执行中断。本地状态文件若损坏可能导致处理状态混乱，建议定期备份。此外，虽然设置了循环上限，但在 Greptile 服务异常时仍可能消耗不必要的计算资源。

核心用法

pr-review-loop 是一个轻量级 bash 脚本，专为 AI Agent 设计，实现与 Greptile 代码审查工具的无缝集成。核心工作流包含五个阶段：

1. 获取审查结果：通过 GitHub CLI 调用官方 API，拉取 Greptile bot 的 PR review 和 inline comments
2. 解析评分：从 review body 提取 Score: X/5 或 Confidence: X/5，≥4 分触发自动合并，<4 分进入修复循环
3. 自动合并：调用 gh pr merge 完成合并并删除分支
4. 智能修复：针对每条 Greptile 评论读取对应文件、理解反馈、应用修复，提交描述性 commit 后推送并重新触发审查
5. 状态追踪：使用 review-state.json 记录轮次、分数、最大轮次（默认 5 轮），支持退出条件判断和异常升级

显著优点

• 零第三方依赖：仅使用 bash、jq、gh 系统标准工具，供应链攻击面极小
• 官方 API 优先：全程通过 gh api 调用 GitHub REST API，TLS 加密，来源可信
• 鲁棒性设计：采用 set -euo pipefail 严格错误处理，状态文件使用 flock 锁防止并发竞争
• 智能决策：内置多种退出条件（max rounds、分数停滞、架构性问题升级），避免无限循环
• 隐私合规：状态数据本地存储，不收集敏感信息，符合 GDPR 数据最小化原则

潜在局限

• 输入验证有限：仅检查参数存在性，缺乏 owner/repo 格式和 PR 编号正则校验
• 临时文件可预测：使用 ${STATE_FILE}.tmp 固定路径，存在低概率竞争条件
• 无超时机制：gh api 调用可能因网络延迟长时间挂起
• 许可证未声明：元数据中缺少明确许可证信息

适合人群

• 使用 Greptile 进行代码审查的开发团队
• 需要自动化 PR 工作流的 AI Agent 开发者
• 追求极简依赖、高可审计性的 DevOps 工程师

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 参数注入 | 低 | 建议增加正则验证防止非法 repo/PR 格式 |

| 并发写入 | 低 | 已使用 flock，但临时文件名可预测 |

| API 速率限制 | 中 | 高频使用需注意 GitHub API 配额 |

| 架构误判 | 低 | 复杂架构问题可能错误自动修复，已设置升级机制 |

安全等级 S（优秀），来源可信度 T2（可信 GitHub 组织账号），建议生产使用前在沙箱环境验证。