PR Doctor Skill

Diagnose and fix pull request issues with parameterized checks.

Parameters

| Parameter | Type | Description | |-----------|------|-------------| | pr | optional | Pull request number/URL (auto-detects current if not provided) | | checks | optional | build|reviews|sonar|all (default: all) | | auto-fix | optional | Auto-apply fixes without prompting (default: false) | | wait | optional | Wait for CI/Sonar to complete (default: true) | | handoff | optional | Handoff structure from previous phase (JSON) |

Prerequisites

Load required skills:

Skill: pm-workflow:workflow-integration-ci
Skill: pm-workflow:workflow-integration-sonar

Workflow

Step 0: Process Handoff Input

If handoff parameter provided: Parse JSON, extract artifacts/decisions/constraints.

Step 1: Get PR Information

Auto-detect if not provided:

gh pr view --json number,title,state

Validate: PR must be numeric or valid GitHub URL.

Step 2: Wait for Checks (If Requested)

If wait=true:

gh pr checks {pr} --json name,status,conclusion

Poll every 30 seconds. Timeout after 30 minutes with prompt: "[C]ontinue / [S]kip / [A]bort"

Step 3: Diagnose Issues

Based on checks parameter:

Build: gh pr checks → BUILD_FAILURE if failed

Reviews: workflow-integration-ci (Fetch Comments) → REVIEW_COMMENTS ({count})

Sonar: workflow-integration-sonar (Fetch Issues) → SONAR_QUALITY ({count}/{severity})

Step 4: Generate Diagnostic Report

═══════════════════════════════════════════════
PR Diagnostic Report: #{pr}
═══════════════════════════════════════════════

Build Status: {PASS|FAIL}
Review Comments: {count} unresolved
Sonar Issues: {count} ({severity breakdown})

Issues Found:
{per-category breakdown}

Recommended Actions:
{action list}

Step 5: Fix Issues

Based on checks parameter:

BUILD_FAILURE: Run build fix workflow

REVIEW_COMMENTS: Use workflow-integration-ci (Handle Review). For each: triage → fix/explain/acknowledge.

SONAR_QUALITY: Use workflow-integration-sonar (Fix Issues). For each: triage → fix/suppress (with approval if not auto-fix).

Step 6: Verify and Commit

After fixes: Verify build, commit via git workflow, push to PR branch.

Step 7: Generate Summary

Display: ✓ {fixed} fixed, ⚠ {remaining} remaining, → {next_action}

Usage Examples

Fix all PR issues:

/pr-doctor pr=123

Fix only Sonar issues:

/pr-doctor pr=456 checks=sonar

Auto-fix without prompts:

/pr-doctor checks=all auto-fix

Skip CI wait, fix current PR:

/pr-doctor wait=false

Architecture

Delegates to skills:

/pr-doctor (orchestrator)
  ├─> workflow-integration-ci skill (Fetch Comments, Handle Review)
  ├─> workflow-integration-sonar skill (Fetch Issues, Fix Issues)
  └─> workflow-integration-git skill (Commit workflow)

Continuous Improvement

If you discover issues or improvements during execution, record them:

Activate skill: Skill: plan-marshall:manage-lessons
Record lesson with component: {type: "skill", name: "pr-doctor", bundle: "pm-workflow"}

| Skill | Purpose | |-------|---------| | pm-workflow:workflow-integration-ci | PR review comment handling | | pm-workflow:workflow-integration-sonar | Sonar quality issue handling | | pm-workflow:workflow-integration-git | Git commit workflow | | pm-workflow:task-implement | Implement tasks before PR |