devkit.github.review-pr

GitHub Pull Request Comprehensive Review

Overview

Perform comprehensive code review of a GitHub pull request including code quality, security, architecture, performance, and best practices analysis.

Overview

• Title: $PR_TITLE
• Author: $PR_AUTHOR
• Branch: $PR_HEAD → $PR_BASE
• Changes: +$PR_ADDITIONS -$PR_DELETIONS across $PR_CHANGED_FILES files
• Review Focus: $REVIEW_FOCUS

Usage

/devkit.github.review-pr $ARGUMENTS

Arguments

Argument	Description
$ARGUMENTS	Combined arguments passed to the command

Current Context

• Current Branch: !git branch --show-current
• Remote Repository: !git config --get remote.origin.url
• Git Status: !git status --porcelain

Execution Instructions

Agent Selection: To execute this GitHub task, use the following approach:

• Primary: Use general-purpose agent with GitHub CLI expertise and code analysis capabilities

Configuration

Arguments received: $ARGUMENTS

$1: PR number (required - e.g., 123) $2: Review focus (optional - defaults to full) $3: Output format (optional - defaults to summary)

Available review focuses:

• full - Complete comprehensive review (default)
• security - Security vulnerabilities and risks only
• performance - Performance bottlenecks and optimizations
• architecture - Design patterns and architectural decisions
• testing - Test coverage and quality
• style - Code style and conventions

Output formats:

• summary - Concise executive summary (default)
• detailed - Comprehensive detailed report
• checklist - Review checklist format
• issues - GitHub issues-ready format

Phase 1: PR Information Extraction

1.1 Fetch PR Details

# Validate PR number
if [ -z "$1" ]; then
    echo "Error: PR number is required"
    echo "Usage: /developer-kit:devkit.github.review-pr <pr-number> [review-focus] [output-format]"
    exit 1
fi

PR_NUMBER=$1
REVIEW_FOCUS=${2:-full}
OUTPUT_FORMAT=${3:-summary}

# Check GitHub CLI authentication
if ! gh auth status > /dev/null 2>&1; then
    echo "Error: GitHub CLI not authenticated. Run: gh auth login"
    exit 1
fi

# Fetch PR information
echo "Fetching PR #$PR_NUMBER details..."

PR_TITLE=$(gh pr view $PR_NUMBER --json title -q .title)
PR_AUTHOR=$(gh pr view $PR_NUMBER --json author -q .author.login)
PR_STATE=$(gh pr view $PR_NUMBER --json state -q .state)
PR_BASE=$(gh pr view $PR_NUMBER --json baseRefName -q .baseRefName)
PR_HEAD=$(gh pr view $PR_NUMBER --json headRefName -q .headRefName)
PR_URL=$(gh pr view $PR_NUMBER --json url -q .url)
PR_CREATED=$(gh pr view $PR_NUMBER --json createdAt -q .createdAt)
PR_ADDITIONS=$(gh pr view $PR_NUMBER --json additions -q .additions)
PR_DELETIONS=$(gh pr view $PR_NUMBER --json deletions -q .deletions)
PR_CHANGED_FILES=$(gh pr view $PR_NUMBER --json changedFiles -q .changedFiles)

echo "PR Title: $PR_TITLE"
echo "Author: $PR_AUTHOR"
echo "State: $PR_STATE"
echo "Branch: $PR_HEAD -> $PR_BASE"
echo "Changes: +$PR_ADDITIONS -$PR_DELETIONS across $PR_CHANGED_FILES files"