PR 审查循环

自主循环流程：Greptile 审查 PR → Agent 根据反馈修复问题 → 推送变更 → 重新触发审查 → 重复该过程，直至评分 ≥ 4/5 或达到最大轮次限制。

快速开始

当通过 PR URL 或审查载荷（review payload）触发时：

# 运行审查循环
bash scripts/pr-review-loop.sh  

或手动执行各步骤——详见下文。

工作流

1. 获取审查结果

# 获取 Greptile 最新审查记录
gh api "/repos/{owner}/{repo}/pulls/{pr}/reviews" 
  --jq '[.[] | select(.user.login == "greptile-apps[bot]")] | last'

# 获取行内评论（inline comments）
gh api "/repos/{owner}/{repo}/pulls/{pr}/comments" 
  --jq '[.[] | select(.user.login == "greptile-apps[bot]")]'

2. 解析评分

在审查正文（review body）中查找置信度/质量评分。Greptile 通常会包含类似 Score: X/5 或 Confidence: X/5 的格式。提取该评分：

• 评分 ≥ 4/5 → 自动合并
• 评分 < 4/5 → 修复问题
• 未找到评分 → 若存在评论则视为需修复；否则直接合并

3. 自动合并（评分 ≥ 4）

gh pr merge  --merge --delete-branch --repo 

4. 修复问题（评分 < 4）

针对每条 Greptile 评论：

1. 读取所引用的文件及具体行号
2. 理解反馈内容
3. 应用相应修复
4. 暂存（stage）变更

提交时使用描述性提交信息，逐条列出修复项：

Address Greptile review feedback (round N)

- Fix X in path/to/file.ts
- Fix Y in path/to/other.ts
- Improve Z per reviewer suggestion

推送并重新触发 Greptile 审查：

git push
gh pr comment  --repo  --body "@greptileai review"

5. 状态追踪

在 workspace 中维护 review-state.json 文件：

{
  "owner/repo#123": {
    "rounds": 2,
    "maxRounds": 5,
    "lastScore": 3,
    "sameScoreCount": 1
  }
}

每次循环后更新该文件。检查退出条件：

• rounds ≥ 5 → 强制合并，并通知 Master
• sameScoreCount ≥ 2（连续两轮评分相同）→ 强制合并，并通知 Master

6. 升级处理（Escalation）

• 架构类决策（审查中提及 architecture、design patterns 或 breaking changes）→ 在 Telegram 中 @Master，禁止自动修复
• 已达最大轮次限制 → 合并 PR 并向 Master 发送汇总通知
• 反馈不明确 → 向 Master 提出疑问

命令接口

Agent 应支持响应以下命令：

• pr review —— 对指定 PR 启动审查循环
• pr review —— 以引用形式启动同上操作
• pr status —— 显示当前所有活跃的审查循环及其状态

参考资料

详见 references/greptile-patterns.md，其中汇总了常见的 Greptile 反馈模式及对应修复策略。