mirror of
https://github.com/harivansh-afk/auto-review-check.git
synced 2026-04-15 05:02:07 +00:00
Harivansh Rathi
e899b6b09e
Scripts for automating PR review loops: - poll_pr_comments.sh: Poll for new comments without wasting tokens - wait_for_checks.sh: Wait for CI checks to complete - fetch_pr_comments.sh: Fetch and format PR comments Includes SKILL.md for use as a Claude Code skill.
122 lines
3.2 KiB
Markdown
122 lines
3.2 KiB
Markdown
# Auto Review Check
|
|
|
|
Automate the PR review loop workflow - implement code, create PRs, wait for reviews, and iterate on feedback without wasting tokens or context.
|
|
|
|
## Overview
|
|
|
|
This toolkit provides scripts to efficiently manage the PR review cycle:
|
|
|
|
- **Poll for comments** without consuming AI context/tokens
|
|
- **Wait for CI checks** to complete
|
|
- **Fetch and format comments** for review
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
git clone https://github.com/harivansh-afk/auto-review-check.git
|
|
cd auto-review-check
|
|
chmod +x scripts/*.sh
|
|
```
|
|
|
|
## Prerequisites
|
|
|
|
- [GitHub CLI](https://cli.github.com/) installed and authenticated (`gh auth login`)
|
|
- [Graphite CLI](https://graphite.dev/docs/graphite-cli) (optional, for `gt` commands)
|
|
|
|
## Usage
|
|
|
|
### Poll for New Comments
|
|
|
|
Wait for new comments on a PR without consuming resources:
|
|
|
|
```bash
|
|
./scripts/poll_pr_comments.sh <owner/repo> <pr-number> [--timeout <minutes>] [--interval <seconds>]
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
./scripts/poll_pr_comments.sh myorg/myrepo 123 --timeout 30 --interval 60
|
|
```
|
|
|
|
The script:
|
|
- Polls GitHub API at specified intervals (default: 30 seconds)
|
|
- Returns immediately when new comments are detected
|
|
- Exits after timeout with status code 0
|
|
|
|
### Wait for CI Checks
|
|
|
|
Wait for GitHub Actions or other checks to complete:
|
|
|
|
```bash
|
|
./scripts/wait_for_checks.sh <owner/repo> <pr-number> [--timeout <minutes>]
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
./scripts/wait_for_checks.sh myorg/myrepo 123 --timeout 15
|
|
```
|
|
|
|
Exit codes:
|
|
- `0` - All checks passed
|
|
- `1` - Checks failed or timeout reached
|
|
|
|
### Fetch PR Comments
|
|
|
|
Retrieve and format all comments for review:
|
|
|
|
```bash
|
|
./scripts/fetch_pr_comments.sh <owner/repo> <pr-number> [--unresolved-only]
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
./scripts/fetch_pr_comments.sh myorg/myrepo 123
|
|
./scripts/fetch_pr_comments.sh myorg/myrepo 123 --unresolved-only
|
|
```
|
|
|
|
Output includes:
|
|
- Inline review comments with file:line locations
|
|
- PR-level comments
|
|
- Review decision status
|
|
|
|
## Workflow Example
|
|
|
|
Full review loop workflow:
|
|
|
|
```bash
|
|
# 1. Create branch and PR with Graphite
|
|
gt create --all --message "feat: add new feature"
|
|
gt submit --ai --stack
|
|
|
|
# 2. Wait for CI checks
|
|
./scripts/wait_for_checks.sh myorg/myrepo 123 --timeout 15
|
|
|
|
# 3. Poll for review comments
|
|
./scripts/poll_pr_comments.sh myorg/myrepo 123 --timeout 60 --interval 30
|
|
|
|
# 4. Fetch and review comments
|
|
./scripts/fetch_pr_comments.sh myorg/myrepo 123
|
|
|
|
# 5. Address feedback, then push updates
|
|
gt modify --all
|
|
gt submit
|
|
```
|
|
|
|
## Quick Reference
|
|
|
|
| Task | Command |
|
|
| ------------------- | ------------------------------------------------------ |
|
|
| Poll for comments | `./scripts/poll_pr_comments.sh owner/repo 123` |
|
|
| Wait for checks | `./scripts/wait_for_checks.sh owner/repo 123` |
|
|
| Fetch comments | `./scripts/fetch_pr_comments.sh owner/repo 123` |
|
|
| Create branch (gt) | `gt create -am "feat: description"` |
|
|
| Submit PR (gt) | `gt submit --ai --stack` |
|
|
| Amend changes (gt) | `gt modify -a` |
|
|
|
|
## Claude Code Skill
|
|
|
|
This can also be used as a Claude Code skill. Copy the contents to `.claude/skills/implement-review-loop/` in your project.
|
|
|
|
## License
|
|
|
|
MIT
|