Review Spd
Findings-first code review workflow for AI coding agents.
Install
npx skills add zhu1090093659/spec_driven_develop --skill review-spd -g -a claude-code -y- Repository
- zhu1090093659/spec_driven_develop993
- Category
- Testing
- Updated
- 3mo ago
- License
- MIT
- Context cost
- Lightabout 1,431 tokens
- Runs scripts
- Yes, review before use
What it does
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.
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:
- Uncommitted mode (default)
- Commit-range mode, no explicit range → last 3 days
- 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:
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
