github-pr-manager

# Github Pr Manager

## Overview

Manage the complete pull request lifecycle with swarm coordination. This skill handles PR creation, multi-reviewer coordination, automated testing integration, conflict resolution, and intelligent merge strategies.

## Quick Start

```bash
# Check GitHub CLI authentication
gh auth status

# Create a PR with description
gh pr create --title "Feature: New API endpoint" --body "Implementation details..." --base main

# Review PR status
gh pr status

# List open PRs
gh pr list --state open
```

## When to Use

- Creating and managing pull requests
- Coordinating multi-reviewer workflows
- Resolving merge conflicts
- Automating PR testing and validation
- Managing branch synchronization
- Batch PR operations across repositories

## Core Capabilities

| Capability | Description |
|------------|-------------|
| Multi-reviewer coordination | Swarm agents for parallel code review |
| Automated conflict resolution | Intelligent merge strategies |
| Comprehensive testing | Integration with CI/CD validation |
| Real-time progress tracking | GitHub issue coordination |
| Branch management | Synchronization and cleanup |

## Usage Examples

### 1. Create PR with Swarm Coordination

```javascript
// Initialize review swarm

// Orchestrate review process
  task: "Complete PR review with testing and validation",
  strategy: "parallel",
  priority: "high"
})
```
### 2. Create and Manage PR with gh CLI

```bash
# Create PR
gh pr create \
  --repo owner/repo \
  --title "feat: Integration between packages" \
  --head feature-branch \
  --base main \
  --body "## Summary
- Added new integration
- Updated dependencies

*See sub-skills for full details.*
### 3. Review and Approve PR

```bash
# Get PR diff
gh pr diff 54

# Approve PR
gh pr review 54 --approve --body "LGTM! All checks pass."

# Request changes
gh pr review 54 --request-changes --body "Please address the following..."

# Comment on PR
gh pr comment 54 --body "Consider refactoring this section."
```
### 4. Merge PR with Validation

```bash
# Check merge readiness
gh pr status

# Merge with squash
gh pr merge 54 --squash --delete-branch \
  --subject "feat: Complete integration" \
  --body "Comprehensive integration with swarm coordination"

# Merge with rebase
gh pr merge 54 --rebase --delete-branch
```
### 5. Batch PR Operations

```javascript
[Single Message - Complete PR Management]:
  // Initialize coordination

  // Create and manage PR
  Bash("gh pr create --repo owner/repo --title '...' --head '...' --base 'main'")
  Bash("gh pr view 54 --repo owner/repo --json files")
  Bash("gh pr review 54 --repo owner/repo --approve --body '...'")

  // Execute tests and validation

*See sub-skills for full details.*

## MCP Tool Integration

### Swarm Initialization

```javascript
    topology: "mesh",  // mesh, hierarchical, star, ring
    maxAgents: 4,
    strategy: "balanced"
})
```
### Agent Spawning

```javascript
    type: "reviewer",
    name: "PR Reviewer",
    capabilities: ["code-review", "security-audit", "performance-check"]
})
```
### Memory Coordination

```javascript
// Store PR state
    action: "store",
    key: "pr/54/status",
    value: JSON.stringify({
        timestamp: Date.now(),
        status: "approved",
        reviewers: ["user1", "user2"]
    })
})

*See sub-skills for full details.*

## Integration with Other Skills

| Skill | Integration |
|-------|-------------|
| `github-issue-tracker` | Link PRs to issues |
| `github-release-manager` | Coordinate release PRs |
| `github-code-review` | Detailed code analysis |
| `sparc-workflow` | SPARC development methodology |

## Hooks

### Pre-Task Hooks

```bash
gh auth status || (echo 'GitHub CLI not authenticated' && exit 1)
git status --porcelain
gh pr list --state open --limit 1 >/dev/null || echo 'No open PRs'
npm test --silent || echo 'Tests may need attention'
```
### Post-Task Hooks

```bash
gh pr status || echo 'No active PR in current branch'
git branch --show-current
gh pr checks || echo 'No PR checks available'
git log --oneline -3
```

---

## Version History

- **1.0.0** (2025-01-02): Initial release - converted from pr-manager agent

## Sub-Skills

- [Best Practices](best-practices/SKILL.md)
- [Error Handling](error-handling/SKILL.md)