Execution Results

Result Message Templates#

Action	Result Message	Additional Info
Approve	✅ PR #{{arg}} approved successfully! Approval comment posted.	PR URL
Approve and merge	✅ PR #{{arg}} approved with auto-merge enabled! PR will merge using squash when checks pass. Verify with: `gh pr view {{arg}} --json state,mergedAt,autoMergeRequest`	PR URL Bot context (if bot): @username, Labels
Make changes and approve	✅ Changes applied and PR #{{arg}} approved! Changes committed: [SHA] Files: [list]	PR URL/commits
Request changes	✅ Changes requested on PR #{{arg}} Review posted with request-changes flag.	PR URL
Close PR	✅ PR #{{arg}} closed Closing comment posted.	PR URL
Do nothing yet	No action taken. Run /pr-review {{arg}} again when ready.	-

Additional Context by Action Type#

Approve#

Show PR URL and confirm comment posted.

Approve and Merge#

Explain auto-merge behavior (merges when checks pass)
Provide verification command
For bot PRs: Include bot username and relevant labels

Example (pulumi-bot): "✅ PR #1234 approved with auto-merge enabled! PR will merge using squash when checks pass. Verify with: gh pr view 1234 --json state,mergedAt,autoMergeRequest | Bot: @pulumi-bot | Labels: automation/tfgen-provider-docs"

Make Changes and Approve#

Show commit SHA, list modified files with links.

Example: "✅ Changes applied and PR #1234 approved! Changes committed: a1b2c3d | Files: themes/default/data/registry/packages/aws.yaml (formatting) | View: [URL]"

Request Changes#

Confirm request-changes flag set, show PR URL.

Close PR#

Confirm closed, show PR URL.

Do Nothing Yet#

Explain no changes made, remind how to re-run.

Error Handling#

If any command fails during execution:

❌ Failed to [action] PR #{{arg}}
 
Error: [error message]
 
You can retry with:
- /pr-review {{arg}} (re-run full workflow)
- Or use gh CLI directly:
  [relevant recovery commands based on what failed]

GitHub CLI Field Reference#

For status verification, use these gh CLI fields:

state - PR state (OPEN, CLOSED, MERGED)
mergedAt - When PR was merged (null if not merged)
autoMergeRequest - Auto-merge configuration (null if not enabled)

Example verification command:

gh pr view {{arg}} --json state,mergedAt,autoMergeRequest

Implementation Notes#

Always show PR URL for easy access
For bot PRs: Include bot context (username, labels)
Include verification commands where helpful
Provide recovery commands on errors
Keep messages concise but informative