Skip to content

Commit 7812f5f

Browse files
authored
Merge pull request #1 from yury-procoders/feat/pr-review-skill
feat(skills): add pr-review skill + /v:pr-review command
2 parents 4b10906 + 53e607c commit 7812f5f

9 files changed

Lines changed: 769 additions & 2 deletions

File tree

.claude-plugin/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
{
1010
"name": "superpowers-v",
1111
"description": "Compound V for Superpowers: triple parallel pre-flight (code archaeology + domain-expert + Context7 library validator), disjoint partitioning, manifest-driven multi-backend dispatch (Claude + Codex + Antigravity + Cursor), git-diff scope enforcement, crash-resumable runs, adaptive tier-based routing, epic mode, V-memory local-first semantic+lexical recall over docs/superpowers (opt-in pure-python embeddings + a deterministic recall→action bridge), and batched parallel dispatch (Opus default, narrow Sonnet exception)",
12-
"version": "2.5.5",
12+
"version": "2.6.0",
1313
"source": "./",
1414
"author": {
1515
"name": "Oleg",

.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "superpowers-v",
33
"description": "Compound V for Superpowers: triple parallel pre-flight (code archaeology + domain-expert advisor + library/doc validator via Context7), disjoint file partitioning, manifest-driven multi-backend dispatch (Claude + headless Codex + Antigravity + Cursor workers), git-diff scope enforcement, crash-resumable runs, adaptive tier-based routing, epic mode for multi-feature builds, V-memory local-first semantic+lexical recall over docs/superpowers (opt-in pure-python embeddings + a deterministic recall\u2192action bridge), and batched parallel dispatch (Opus default, Sonnet for narrow junior-task carve-out), plus /v:onboard — a project-onboarding command that builds a citation-verified knowledge base + AGENTS.md/CLAUDE.md bridge behind a human gate. Auto-intercepts brainstorming \u2192 writing-plans \u2192 execution transitions.",
4-
"version": "2.5.5",
4+
"version": "2.6.0",
55
"author": {
66
"name": "Oleg",
77
"email": "copeus@gmail.com"

CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,14 @@ All notable changes to **superpowers-v (Compound V)** are documented here.
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project uses semantic versioning.
66

7+
## [2.6.0] — 2026-07-06
8+
9+
### Added — `pr-review` skill + `/v:pr-review` command
10+
11+
- **`pr-review` skill** — a two-axis, stack-agnostic **deep code-review** skill for a pull/merge request or a local diff. It first builds shared understanding of the change's intent, then hunts bugs and edge cases along **two deliberately separate axes** run as context-isolated sub-agents so neither pollutes the other: **Standards** (does the code follow *this repo's* documented conventions, discovered in a Phase-0 sweep?) ⊥ **Spec** (does it faithfully implement the originating spec/issue/PRD?). Findings are reported **side by side, never merged across axes**; genuine author-intent unknowns are promoted to Open Questions; every finding carries a **verdict + confidence**. **Review-only — it never edits, commits, pushes, or merges code.** Ships `SKILL.md` + four `references/` (exploration checklist, review domains, findings format, comment-posting).
12+
- **`/v:pr-review` command** — a thin entry point in the `/v:*` family that runs the skill. Argument = PR/MR URL or number; empty = current branch vs. its base. Auto-detects the host: GitHub (`gh`), GitLab (`glab`), or a hostless local diff.
13+
- **Self-contained** — no new runtime deps, hooks, or scripts; frontmatter within the linter's limits and all intra-plugin `.md` cross-refs resolve.
14+
715
## [2.5.5] — 2026-07-05
816

917
### Performance

commands/v-pr-review.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
description: Deep, two-axis, stack-agnostic code review of a pull/merge request or a local diff — review-only, never edits code. Runs the pr-review skill. Works on GitHub (gh), GitLab (glab), or a hostless local branch. Argument = PR/MR URL or number; empty = current branch vs base.
3+
---
4+
5+
You are running a **deep PR/MR code review** on `{{args}}` — a pull/merge request URL or number, or, if empty, the current branch against its base.
6+
7+
Invoke the [`pr-review`](../skills/pr-review/SKILL.md) skill and follow it exactly. The skill is **review-only**: it never edits, commits, pushes, or merges code.
8+
9+
## Steps
10+
11+
1. **Resolve the target.** Use `{{args}}` as the PR/MR URL or number. If empty, review the current branch against its base. The skill auto-detects the host — GitHub (`gh`), GitLab (`glab`), or a hostless local diff.
12+
2. **Run the pr-review skill** end-to-end: build shared understanding of the change's intent, then hunt bugs and edge cases along the two deliberately separate axes — **Standards** (does the code follow *this repo's* documented conventions?) ⊥ **Spec** (does it faithfully implement the originating spec/issue?) — run as context-isolated sub-agents. Promote real unknowns to Open Questions for the author. Every finding gets a verdict + confidence.
13+
3. **Hand back** the triaged findings table. Never modify the reviewed code — if the user asks for a fix mid-review, stop and confirm they want to leave the review first.
14+
15+
## Notes
16+
17+
- Review-only — no edits, commits, pushes, or merges (skill Prime Directive 1).
18+
- Full behavior — exploration checklist, review domains, findings format, and comment-posting — lives in [`skills/pr-review/SKILL.md`](../skills/pr-review/SKILL.md) and its `references/`.

0 commit comments

Comments
 (0)