pr-summary

PR Summary

List open PRs, filter automation PRs (dependabot/snyk), group by ticket ID, output formatted summary.

When NOT to Use

| Scenario | Use Instead | |----------|-------------| | Create a new PR | /create-pr | | Review PR code | /codex-review | | View single PR details | gh pr view <N> | | Pre-merge analysis | /merge-prep |

Input

/pr-summary [--author <user>] [--label <label>]

| Argument | Description | Default | |----------|-------------|---------| | --author <user> | Filter by author | All | | --label <label> | Filter by label | All |

Workflow

1. Run Script

bash skills/pr-summary/scripts/pr-summary.sh [--author <user>] [--label <label>]

The script automatically:

| Step | Action | |------|--------| | Fetch | gh pr list --json to get open PRs (max 200) | | Filter | Exclude dependabot/ and snyk- | | Group | Group by ticket ID ({TICKET_PATTERN} or [A-Z]+-\d+) | | Detect | Identify stacked PRs (base is not main/master/develop) | | Output | Write formatted text to /tmp/pr-summary.md |

2. Display Results

Read /tmp/pr-summary.md and display to user.

3. Provide Copy Instructions

Content written to /tmp/pr-summary.md
Copy: cat /tmp/pr-summary.md | pbcopy

Output Format

Markdown (default)

**PROJ-520**

https://github.com/user/repo/pull/123
> fix: Add Redis cache for contract codes

https://github.com/user/repo/pull/124
> fix: Tune server timeouts (stacked on fix/PROJ-520)

**PROJ-123**

https://github.com/user/repo/pull/99
> feat: Add DeFi portfolio tracking

Grouping Rules

| Condition | Strategy | |-----------|----------| | Same ticket ID | Same group | | Stacked PR (base is feature branch) | Same group, annotate (stacked on <base>) | | No ticket / unrelated | Standalone entry |

Filter Rules

| PR Source | Action | |-----------|--------| | dependabot/ | Exclude | | snyk- | Exclude | | Others | Keep |

References

| File | Purpose | |------|---------| | [pr-summary.sh](scripts/pr-summary.sh) | PR fetch, filter, group, format script |

Verification

• [ ] Lists all open PRs (excluding dependabot/snyk)
• [ ] PRs grouped by ticket ID
• [ ] Stacked PRs annotated with dependency
• [ ] Output format is valid Markdown
• [ ] /tmp/pr-summary.md written