# Review Spd

Findings-first code review workflow for AI coding agents.

- Repository: https://github.com/zhu1090093659/spec_driven_develop (993 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-07-26
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add zhu1090093659/spec_driven_develop --skill review-spd -g -a claude-code -y`
Codex: `npx skills add zhu1090093659/spec_driven_develop --skill review-spd -g -a codex -y`
Cursor: `npx skills add zhu1090093659/spec_driven_develop --skill review-spd -g -a cursor -y`
Gemini CLI: `npx skills add zhu1090093659/spec_driven_develop --skill review-spd -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add zhu1090093659/spec_driven_develop`

## Description

Findings-first code review workflow for AI coding agents. Use when the user asks to review uncommitted changes, commits in a date range, or a branch compared to the main branch / PR-style diff. Focuses on bugs, regressions, correctness risks, missing tests, security/data-safety issues, and other behavior-changing defects.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Review SPD

You are executing the **Review SPD** workflow: a findings-first review of changed code. Identify bugs, regressions, and behavior risks introduced by the changes. Do not turn this into a style review or a broad summary.

## Configuration

| Item | Default | Purpose |
|:-----|:--------|:--------|
| Context script | `scripts/review-context.py` relative to this Review SPD skill directory | Collect stable git context |
| Default target | Uncommitted changes | Working tree + staged changes |
| Commit range default | Last 3 days | Only when the user requests commit/date review without dates |
| PR base | Auto-detect `origin/main`, `origin/master`, then remote default branch | Base for branch-vs-main review |
| Output style | Findings first | Findings by severity before summaries |

References: reviewer sub-agent template `references/reviewer-template.md`; final output format `references/output-format.md`.

## Target Modes

Three mutually exclusive targets:

1. **Uncommitted mode** (default)
2. **Commit-range mode**, no explicit range → last 3 days
3. **Branch / PR mode**, branch vs. main or explicit `base`

Conflict priority: `branch` specified → branch mode; else `since`/`until` → commit-range mode; else uncommitted. `base` applies only to branch mode. Vague requests ("review this") → uncommitted mode; "recent commits" without dates → `--since "3 days ago"`.

## Phase 1: Target Resolution

Resolve the context script from the installed Review SPD skill directory, not from the repository being reviewed:

```bash
python <review-spd-skill-dir>/scripts/review-context.py
python <review-spd-skill-dir>/scripts/review-context.py --since "3 days ago"
python <review-spd-skill-dir>/scripts/review-context.py --since 2026-06-28 --until 2026-07-01
python <review-spd-skill-dir>/scripts/review-context.py --branch feature/foo
python <review-spd-skill-dir>/scripts/review-context.py --branch feature/foo --base origin/main
```

The rest: https://github.com/zhu1090093659/spec_driven_develop/blob/HEAD/plugins/spec-driven-develop/skills/review-spd/SKILL.md