opencodehub: Skill for Claude Code

codehub-pr-description

Generates a Markdown PR body from graph primitives. Linear (no subagents). Sonnet. Refuses on a clean tree.

Preconditions

1. Resolve --base (default main) and --head (default HEAD) via git rev-parse.
2. git diff --name-only <base>..<head> must return ≥ 1 path. If empty, emit No diff detected — resolve base/head or stage changes. and stop. (Spec 001 AC-5-4.)

Arguments

• --base <rev> — base revision. Default: main.
• --head <rev> — head revision. Default: HEAD.
• --out <path> — output path. Default: .codehub/pr/PR-<branch>.md.

Process

1. Run the preconditions. On clean tree, refuse and stop.
2. mcp__codehub__detect_changes({base, head}) — map the diff to affected symbols + processes.
3. mcp__codehub__verdict({base, head}) — 5-tier merge recommendation with reasons.
4. mcp__codehub__owners({paths: <changed-files>}) — required reviewers per path.
5. mcp__codehub__list_findings_delta({base, head}) — new/resolved scanner findings in the diff range.
6. For any symbol flagged as tier ≥ 3 by verdict: mcp__codehub__impact({symbol, direction: "downstream", depth: 2}) — spell out who breaks.
7. For public API changes: mcp__codehub__api_impact({route}) when the diff touches a handler.
8. Assemble the Markdown body using the template below.
9. Write to <out>.

Output template

# <branch-name or commit subject>

## Summary

2–3 sentences describing what this PR changes and why. Grounded in the
commit messages + the highest-impact change detected.

## Verdict

**Tier <N> — <label>** per `mcp__codehub__verdict`.

Reasons:
- ... (from verdict.reasons[])

## Affected surface

| Category | Count | Details |
|---|---|---|
| Files changed | N | `git diff --stat` summary |
| Symbols added | N | from `detect_changes` |
| Symbols removed | N | from `detect_changes` |
| Processes touched | N | from `detect_changes.processes[]` |

### Top touched files

| File | Change | Top owner |
|---|---|---|
| `packages/foo/src/bar.ts` | +40 / -12 | alice@ |
| ... | ... | ... |

## Blast radius

(Only when verdict tier ≥ 3.)

- Downstream consumers of `<symbol>`: <count>. See `impact` output.
- Affected routes: (if `api_impact` returned non-empty)

## Findings delta

| Change | Severity | File |
|---|---|---|
| new | error | `packages/foo/src/bar.ts:42` |
| resolved | warn | `packages/other.ts:88` |

(Or: "No new findings. 2 findings resolved." as a terse summary.)

## Required reviewers

- `packages/foo/` — alice@, bob@
- `packages/other/` — charlie@

## Test plan

- [ ] ...
- [ ] ...

(Extract TODO-shaped lines from `git log <base>..<head>` or leave a blank checklist for the author to fill in.)