source-command-pr-shepherd

source-command-pr-shepherd

Use this skill when the user asks to run the migrated source command pr-shepherd.

Command Template

PR Shepherd

Monitor a PR from creation through merge, handling CI failures, review comments, and thread resolution automatically.

Usage

/pr-shepherd [pr-number]

If no PR number is provided, uses the PR associated with the current branch.

What This Does

1. Monitors CI/CD - Polls every 60 seconds for status changes
2. Monitors Reviews - Watches for new comments and unresolved threads
3. Auto-fixes simple issues - Lint, prettier, type errors
4. Asks before complex fixes - Presents options with pros/cons for approval
5. Handles review comments - Delegates to handling-pr-comments skill
6. Checkpoints at 4 hours - Asks if you want to continue or handoff

Steps

1. Get PR information:

   PR_NUMBER=${1:-$(gh pr view --json number -q .number 2>/dev/null)}
   if [ -z "$PR_NUMBER" ]; then
     echo "No PR found. Provide PR number: /pr-shepherd 123"
     exit 1
   fi
   

2. Activate the pr-shepherd skill: Load and follow the pr-shepherd skill definition.

3. Begin monitoring loop (background, every 60s):

   • Check CI status
   • Check for new review comments
   • Check unresolved thread count
   • Take action based on state machine

4. Handle issues as they arise:

   • Simple CI failures -> auto-fix with TDD
   • Complex failures -> present options, wait for approval

Example

Notes