feat: improve PR review examples with context and tools (#504)

- Add PR repository and number to review prompts
- Note that PR branch is already checked out
- Update allowed tools to use inline comments and gh CLI
- Remove experimental review mode example in favor of standardized approach

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <noreply@anthropic.com>

.github/workflows/release.yml

@@ -122,35 +122,35 @@ jobs:
           token: ${{ secrets.CLAUDE_CODE_BASE_ACTION_PAT }}
           fetch-depth: 0
 
-      - name: Create and push tag
+      # - name: Create and push tag
-        run: |
+      #   run: |
-          next_version="${{ needs.create-release.outputs.next_version }}"
+      #     next_version="${{ needs.create-release.outputs.next_version }}"
 
-          git config user.name "github-actions[bot]"
+      #     git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
+      #     git config user.email "github-actions[bot]@users.noreply.github.com"
 
-          # Create the version tag
+      #     # Create the version tag
-          git tag -a "$next_version" -m "Release $next_version - synced from claude-code-action"
+      #     git tag -a "$next_version" -m "Release $next_version - synced from claude-code-action"
-          git push origin "$next_version"
+      #     git push origin "$next_version"
 
-          # Update the beta tag
+      #     # Update the beta tag
-          git tag -fa beta -m "Update beta tag to ${next_version}"
+      #     git tag -fa beta -m "Update beta tag to ${next_version}"
-          git push origin beta --force
+      #     git push origin beta --force
 
-      - name: Create GitHub release
+      # - name: Create GitHub release
-        env:
+      #   env:
-          GH_TOKEN: ${{ secrets.CLAUDE_CODE_BASE_ACTION_PAT }}
+      #     GH_TOKEN: ${{ secrets.CLAUDE_CODE_BASE_ACTION_PAT }}
-        run: |
+      #   run: |
-          next_version="${{ needs.create-release.outputs.next_version }}"
+      #     next_version="${{ needs.create-release.outputs.next_version }}"
 
-          # Create the release
+      #     # Create the release
-          gh release create "$next_version" \
+      #     gh release create "$next_version" \
-            --repo anthropics/claude-code-base-action \
+      #       --repo anthropics/claude-code-base-action \
-            --title "$next_version" \
+      #       --title "$next_version" \
-            --notes "Release $next_version - synced from anthropics/claude-code-action" \
+      #       --notes "Release $next_version - synced from anthropics/claude-code-action" \
-            --latest=false
+      #       --latest=false
 
-          # Update beta release to be latest
+      #     # Update beta release to be latest
-          gh release edit beta \
+      #     gh release edit beta \
-            --repo anthropics/claude-code-base-action \
+      #       --repo anthropics/claude-code-base-action \
-            --latest
+      #       --latest

.github/workflows/update-major-tag.yml

@@ -1,24 +0,0 @@
-name: Update Beta Tag
-
-on:
-  release:
-    types: [published]
-
-jobs:
-  update-beta-tag:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Update beta tag
-        run: |
-          # Get the current release version
-          VERSION=${GITHUB_REF#refs/tags/}
-
-          # Update the beta tag to point to this release
-          git config user.name github-actions[bot]
-          git config user.email github-actions[bot]@users.noreply.github.com
-          git tag -fa beta -m "Update beta tag to ${VERSION}"
-          git push origin beta --force

action.yml

@@ -157,7 +157,7 @@ runs:
         # Install Claude Code if no custom executable is provided
         if [ -z "${{ inputs.path_to_claude_code_executable }}" ]; then
           echo "Installing Claude Code..."
-          curl -fsSL https://claude.ai/install.sh | bash -s 1.0.92
+          curl -fsSL https://claude.ai/install.sh | bash -s 1.0.96
           echo "$HOME/.local/bin" >> "$GITHUB_PATH"
         else
           echo "Using custom Claude Code executable: ${{ inputs.path_to_claude_code_executable }}"

base-action/action.yml

@@ -99,7 +99,7 @@ runs:
       run: |
         if [ -z "${{ inputs.path_to_claude_code_executable }}" ]; then
           echo "Installing Claude Code..."
-          curl -fsSL https://claude.ai/install.sh | bash -s 1.0.92
+          curl -fsSL https://claude.ai/install.sh | bash -s 1.0.96
         else
           echo "Using custom Claude Code executable: ${{ inputs.path_to_claude_code_executable }}"
           # Add the directory containing the custom executable to PATH

examples/claude-auto-review.yml

@@ -22,7 +22,12 @@ jobs:
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
           prompt: |
-            Please review this pull request and provide comprehensive feedback.
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request.
+
+            Note: The PR branch is already checked out in the current working directory.
 
             Focus on:
             - Code quality and best practices
@@ -34,7 +39,10 @@ jobs:
             - Verify that README.md and docs are updated for any new features or config changes
 
             Provide constructive feedback with specific suggestions for improvement.
-            Use inline comments to highlight specific areas of concern.
+            Use `gh pr comment:*` for top-level comments.
+            Use `mcp__github_inline_comment__create_inline_comment` to highlight specific areas of concern.
+            Only your GitHub comments that you post will be seen, so don't submit your review as a normal message, just as comments.
+            If the PR has already been reviewed, or there are no noteworthy changes, don't post anything.
 
           claude_args: |
-            --allowedTools "mcp__github__create_pending_pull_request_review,mcp__github__add_comment_to_pending_review,mcp__github__submit_pending_pull_request_review,mcp__github__get_pull_request_diff"
+            --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*), Bash(gh pr diff:*), Bash(gh pr view:*)"

examples/claude-experimental-review-mode.yml

@@ -1,45 +0,0 @@
-name: Claude Experimental Review Mode
-
-on:
-  pull_request:
-    types: [opened, synchronize]
-  issue_comment:
-    types: [created]
-
-jobs:
-  code-review:
-    # Run on PR events, or when someone comments "@claude review" on a PR
-    if: |
-      github.event_name == 'pull_request' ||
-      (github.event_name == 'issue_comment' && 
-       github.event.issue.pull_request && 
-       contains(github.event.comment.body, '@claude review'))
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: write
-      issues: write
-      id-token: write
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0 # Full history for better diff analysis
-
-      - name: Code Review with Claude
-        uses: anthropics/claude-code-action@v1-dev
-        with:
-          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          # github_token not needed - uses default GITHUB_TOKEN for GitHub operations
-          prompt: |
-            Review this pull request comprehensively.
-
-            Focus on:
-            - Code quality and maintainability
-            - Security vulnerabilities
-            - Performance issues
-            - Best practices and design patterns
-            - Test coverage gaps
-
-            Be constructive and provide specific suggestions for improvements.
-            Use GitHub's suggestion format when proposing code changes.

examples/claude-pr-path-specific.yml

@@ -28,7 +28,13 @@ jobs:
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
           prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
             Please review this pull request focusing on the changed files.
+
+            Note: The PR branch is already checked out in the current working directory.
+
             Provide feedback on:
             - Code quality and adherence to best practices
             - Potential bugs or edge cases
@@ -38,3 +44,6 @@ jobs:
 
             Since this PR touches critical source code paths, please be thorough
             in your review and provide inline comments where appropriate.
+
+          claude_args: |
+            --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*), Bash(gh pr diff:*), Bash(gh pr view:*)"

examples/claude-review-from-author.yml

@@ -27,8 +27,13 @@ jobs:
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
           prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
             Please provide a thorough review of this pull request.
 
+            Note: The PR branch is already checked out in the current working directory.
+
             Since this is from a specific author that requires careful review,
             please pay extra attention to:
             - Adherence to project coding standards
@@ -38,3 +43,6 @@ jobs:
             - Documentation
 
             Provide detailed feedback and suggestions for improvement.
+
+          claude_args: |
+            --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*), Bash(gh pr diff:*), Bash(gh pr view:*)"

test/mockContext.ts

@@ -72,7 +72,7 @@ export const createMockAutomationContext = (
 
   const mergedInputs = overrides.inputs
     ? { ...defaultInputs, ...overrides.inputs }
-    : defaultInputs;
+    : { ...defaultInputs };
 
   return { ...baseContext, ...overrides, inputs: mergedInputs };
 };