trigger-ai-reviews

Trigger AI Reviews

Trigger Claude, Gemini, and/or Copilot reviews on a PR with a single invocation.

Usage

/trigger-ai-reviews              # Trigger all 3 AIs on current branch's PR
/trigger-ai-reviews 42           # Trigger all 3 AIs on PR #42
/trigger-ai-reviews 42 claude    # Trigger only Claude
/trigger-ai-reviews 42 gemini    # Trigger only Gemini
/trigger-ai-reviews 42 copilot   # Trigger only Copilot
/trigger-ai-reviews 42 all       # Explicitly trigger all 3 AIs

Step 1: Resolve PR Context

OWNER=$(gh repo view --json owner --jq '.owner.login')
REPO=$(gh repo view --json name --jq '.name')

# If PR_NUMBER not provided, get from current branch
PR_NUMBER=${PR_NUMBER:-$(gh pr view --json number --jq '.number' 2>/dev/null)}

Verify the PR exists and is open:

STATE=$(gh pr view "$PR_NUMBER" --json state --jq '.state')
[ "$STATE" = "OPEN" ] || { echo "PR #$PR_NUMBER is $STATE — only open PRs can be reviewed"; exit 1; }

Step 2: Trigger Claude

Post a comment mentioning @claude:

gh pr comment "$PR_NUMBER" --body "@claude review this PR"

Expected: Claude Code bot picks up the mention and posts a review.

Step 3: Trigger Gemini

Post the Gemini slash command:

gh pr comment "$PR_NUMBER" --body "/gemini review"

Expected: Gemini Code Assist bot responds with a review.

Step 4: Trigger Copilot

Request Copilot as a reviewer via the GitHub API:

gh api \
  --method POST \
  "/repos/${OWNER}/${REPO}/pulls/${PR_NUMBER}/requested_reviewers" \
  -f "reviewers[]=copilot-pull-request-reviewer[bot]"

Important limitation: Copilot can only be requested once per PR. If Copilot has already submitted a review, this API call will return an error — that is expected behavior. See references/ai-triggers.md for details.

Step 5: Report Results

After all steps, report clearly:

AI Review Triggers — PR #{NUMBER}

✅ Claude    — comment posted (@claude review this PR)
✅ Gemini    — comment posted (/gemini review)
✅ Copilot   — reviewer requested via API
  OR
⚠️  Copilot   — request failed (already reviewed or not installed)