Add reviewer trigger for PR review workflow (#1037)

Co-authored-by: openhands <[email protected]>

Author: simonrosenberg

.github/workflows/pr-review-by-openhands.yml

@@ -2,12 +2,15 @@
 name: PR Review by OpenHands
 
 on:
-    # Use pull_request_target to allow fork PRs to access secrets when labeled by maintainers
-    # Security: This workflow only runs when a maintainer adds the 'review-this' label
+    # Use pull_request_target to allow fork PRs to access secrets when triggered by maintainers
+    # Security: This workflow only runs when:
+    #   1. A maintainer adds the 'review-this' label, OR
+    #   2. A maintainer requests openhands-agent as a reviewer
+    # Only users with write access can add labels or request reviews, ensuring security.
     # The PR code is explicitly checked out for review, but secrets are only accessible
     # because the workflow runs in the base repository context
     pull_request_target:
-        types: [labeled]
+        types: [labeled, review_requested]
 
 permissions:
     contents: read
@@ -16,9 +19,13 @@ permissions:
 
 jobs:
     pr-review:
-        # Security: Only run when 'review-this' label is added by a maintainer
-        # Maintainers should review PR code before adding this label
-        if: github.event.label.name == 'review-this'
+        # Security: Only run when one of the following conditions is met:
+        #   1. 'review-this' label is added by a maintainer, OR
+        #   2. openhands-agent is requested as a reviewer by a maintainer
+        # Maintainers should review PR code before triggering this workflow
+        if: |
+            github.event.label.name == 'review-this' ||
+            github.event.requested_reviewer.login == 'openhands-agent'
         runs-on: blacksmith-4vcpu-ubuntu-2404
         env:
             LLM_MODEL: litellm_proxy/claude-sonnet-4-5-20250929

examples/03_github_workflows/02_pr_review/README.md

@@ -1,6 +1,6 @@
 # PR Review Workflow
 
-This example demonstrates how to set up a GitHub Actions workflow for automated pull request reviews using the OpenHands agent SDK. When a PR is labeled with `review-this`, OpenHands will analyze the changes and provide detailed, constructive feedback.
+This example demonstrates how to set up a GitHub Actions workflow for automated pull request reviews using the OpenHands agent SDK. When a PR is labeled with `review-this` or when openhands-agent is added as a reviewer, OpenHands will analyze the changes and provide detailed, constructive feedback.
 
 ## Files
 
@@ -11,7 +11,9 @@ This example demonstrates how to set up a GitHub Actions workflow for automated
 
 ## Features
 
-- **Automatic Trigger**: Reviews are triggered when the `review-this` label is added to a PR
+- **Automatic Trigger**: Reviews are triggered when:
+  - The `review-this` label is added to a PR, OR
+  - openhands-agent is requested as a reviewer
 - **Comprehensive Analysis**: Analyzes code changes in context of the entire repository
 - **Detailed Feedback**: Provides structured review comments covering:
   - Overall assessment of changes
@@ -67,9 +69,21 @@ Create a `review-this` label in your repository:
 
 ### Triggering a Review
 
-To trigger an automated review of a pull request:
+There are two ways to trigger an automated review of a pull request:
+
+#### Option 1: Using Labels
 
 1. Open the pull request you want reviewed
 2. Add the `review-this` label to the PR
 3. The workflow will automatically start and analyze the changes
 4. Review comments will be posted to the PR when complete
+
+#### Option 2: Requesting a Reviewer (Recommended)
+
+1. Open the pull request you want reviewed
+2. Click on "Reviewers" in the right sidebar
+3. Search for and select "openhands-agent" as a reviewer
+4. The workflow will automatically start and analyze the changes
+5. Review comments will be posted to the PR when complete
+
+**Note**: Both methods require write access to the repository, ensuring only authorized users can trigger the AI review.

examples/03_github_workflows/02_pr_review/workflow.yml

@@ -3,13 +3,15 @@
 #  1. Copy this file to .github/workflows/pr-review.yml in your repository
 #  2. Add your LLM_API_KEY to the repository secrets
 #  3. Commit this file to your repository
-#  4. Add the "review-this" label to any PR to trigger the review
+#  4. Trigger the review by either:
+#     - Adding the "review-this" label to any PR, OR
+#     - Requesting openhands-agent as a reviewer
 name: PR Review by OpenHands
 
 on:
-    # Trigger when a label is added to a pull request
+    # Trigger when a label is added or a reviewer is requested
     pull_request:
-        types: [labeled]
+        types: [labeled, review_requested]
 
 permissions:
     contents: read
@@ -18,7 +20,10 @@ permissions:
 
 jobs:
     pr-review:
-        if: github.event.label.name == 'review-this'
+        # Run when review-this label is added OR openhands-agent is requested as reviewer
+        if: |
+            github.event.label.name == 'review-this' ||
+            github.event.requested_reviewer.login == 'openhands-agent'
         runs-on: ubuntu-latest
         env:
             # Configuration (modify these values as needed)