pr-review

PR Review

Purpose

This command helps reviewers conduct comprehensive code reviews efficiently. It analyzes PR changes, generates review feedback, and can either output a markdown review file (silent mode) or post comments directly to the PR (interactive mode with plan approval).

Command Name

pr-review

Invocation Syntax

/pr-review <pr-number> [--silent-mode|-s] [--focus=<area>]
/pr-review <pr-url> [--silent-mode|-s] [--focus=<area>]
/pr-review [--silent-mode|-s] [--focus=<area>]

Examples:

# Silent mode (default) - generates markdown review file
/pr-review 1234
/pr-review 1234 --silent-mode
/pr-review 1234 -s

# Interactive mode - posts comments to PR after plan approval
/pr-review 1234 --silent-mode=false

# Focus on specific areas
/pr-review 1234 --focus=security
/pr-review 1234 --focus=performance
/pr-review 1234 --focus=testing

# Auto-detect current PR
/pr-review --silent-mode=false

Flags:

• --silent-mode / -s: Generate markdown review file only (default: true)
• --silent-mode=false: Interactive mode with plan approval and PR commenting
• --focus=<area>: Focus review on specific areas (security, performance, testing, architecture, etc.)

Workflow Overview

Execute this workflow when the command is invoked:

1. Parse Flags: Determine silent mode and focus areas
2. Fetch PR Information: Get PR details, diff, and context
3. Analyze Code Changes: Comprehensive code review analysis
4. Generate Review: Create structured review feedback
5. Output Mode: Either save markdown file (silent) or enter plan mode (interactive)

Phase 1: Flag Parsing and Setup

Step 1.1: Parse Command Flags

Default behavior: --silent-mode=true

// Parse user input for flags
const flags = {
  silentMode: true,  // Default to silent mode
  focus: null,       // No specific focus by default
  prNumber: null,
  prUrl: null
};

// Check for explicit flags in user input
if (input.includes('--silent-mode=false')) flags.silentMode = false;
if (input.includes('--focus=')) flags.focus = extractFocusArea(input);