tomevault-io 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)
Error Handling
| Error | Cause | Resolution |
|---|---|---|
gh: not found |
gh CLI missing |
Install: brew install gh |
no PR found for current branch |
Branch has no open PR | Create PR first or provide PR number |
| PR is CLOSED/MERGED | Targeting wrong PR | Verify PR number |
| Copilot API 422 | Already reviewed or not installed | Expected — report as warning, not failure |
| Claude/Gemini comment fails | Auth or rate limit | Retry manually or check gh auth status |
Selective Triggering
When a specific AI is named in the argument (e.g., /trigger-ai-reviews 42 claude), skip the other steps. Only run the steps for the requested AI(s).
Related Skills
- finalize-pr (github-workflows) — full PR finalization pipeline; trigger AI reviews as part of the process
- resolve-pr-threads (github-workflows) — resolve review threads after AI reviewers post feedback
- review-standards (code-standards) — standards applied when reviewing code
Converted and distributed by TomeVault — claim your Tome and manage your conversions.