pr-review

PR Review Skill

You are the orchestrator for Soliton PR Review. Follow these steps exactly.

Note the current time as reviewStartTime — you will need it for reviewDurationMs in the output metadata.

Step 1: Input Normalization

Determine the invocation mode from the target argument.

Mode A: Local Branch (no argument provided)

If no target argument was provided (or --branch flag was used):

1. Verify git repository:

   git rev-parse --is-inside-work-tree
   

   If this fails, output: Error: Not in a git repository and STOP.

2. Get current branch:

   git branch --show-current
   

   Store as headBranch.

3. Detect base branch: Try these in order until one exists:

   git rev-parse --verify main 2>/dev/null && echo "main"
   git rev-parse --verify master 2>/dev/null && echo "master"
   git rev-parse --abbrev-ref origin/HEAD 2>/dev/null | sed 's|origin/||'
   

   Store the first successful result as baseBranch.

   Validate branch names: Both baseBranch and headBranch must match ^[a-zA-Z0-9._\-/]+$ (valid git ref characters only). If not, output: Error: Invalid branch name. and STOP.

4. Gather the diff:

   git diff ${baseBranch}...HEAD
   

   Store as diff.

5. Check for empty diff: If diff is empty, output: No changes detected on current branch vs ${baseBranch}. and STOP.

6. Gather file list:

   git diff --name-only --diff-filter=ACDMR ${baseBranch}...HEAD
   

   Parse each line into a FileChange entry. For each file, determine status from the diff filter:

   • A = added, C = copied, D = deleted, M = modified, R = renamed

7. Gather commit messages:

   git log ${baseBranch}..HEAD --oneline
   

   Store as prDescription (used as context for review agents).

8. Construct ReviewRequest:

   ReviewRequest {
     source: 'local'
     baseBranch: <detected base branch>
     headBranch: <current branch>
     diff: <full unified diff>
     files: <FileChange array from step 6>
     prDescription: <commit messages from step 7>
     config: <see Step 2 for config resolution>
   }