review

Review code changes between a fixed point and HEAD for standards and spec compliance.

88|9|Updated Jul 16, 2020
One-click install
npx skills add https://github.com/docs-plus/docs.plus --skill review-docs-plus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/docs-plus/docs.plus/tree/main/.agents/skills/review
Command: npx skills add https://github.com/docs-plus/docs.plus --skill review-docs-plus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious, error-prone manual work of checking code changes for both adherence to your repo's documented coding standards and alignment with the original issue or PRD requirements, ensuring no critical gaps slip through during code review.

Core Features & Use Cases

  • Parallel dual-axis review: Runs standards compliance and spec alignment checks in separate sub-agents to avoid context cross-contamination, so findings for each axis remain independent and clear.
  • Automated spec source detection: Automatically locates the originating spec from commit message references, user-provided paths, or docs/specs directories, reducing manual lookup work.
  • Clear aggregated reporting: Presents standards and spec findings under separate headings so you can address convention gaps and requirement mismatches independently.
  • Use Case: When reviewing a PR for a new payment processing feature, this Skill will flag any code that violates your repo's error handling standards (standards axis) and any missing requirements from the original payment spec (spec axis) in a single, easy-to-navigate report.

Quick Start

Use the review skill to check all changes in your current feature branch against the main branch for standards and spec compliance.

Frequently Asked Questions about review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate code review for both standards compliance and spec alignment?

Automated code review for standards compliance and spec alignment works by running parallel checks against your repo's documented coding standards and originating issue or PRD content. This dual-axis approach generates separate findings for convention gaps and requirement mismatches without context cross-contamination.

How do I check a feature branch's git diff against the main branch for PRD alignment?

Checking a feature branch's git diff for PRD alignment requires comparing code changes between a fixed point and the current HEAD. The system automatically detects the originating spec from commit message references, user-provided paths, or docs/specs directories to flag missing requirements.

What's the best way to audit a pull request for coding standard violations?

Auditing a pull request for coding standard violations is best handled by a dedicated standards compliance check axis. It evaluates your git diff against documented standards files and reports convention gaps independently from feature spec mismatches.

Can I review post-merge code changes for spec gaps without missing requirement details?

Yes, you can review post-merge code changes for spec gaps by performing a change audit between a fixed point and HEAD. It automatically locates the originating spec and generates non-merged findings for standards adherence and spec alignment.

Do I need documented standards files and PRD content to perform a change audit?

Yes, performing a change audit requires access to the repository's git history, documented standards files, and originating issue or PRD content. These inputs are necessary to generate separate findings for standards adherence and spec alignment.

Why should I use separate sub-agents for standards compliance and spec alignment checks?

Using separate sub-agents for standards compliance and spec alignment checks prevents context cross-contamination. This ensures findings for each axis remain independent and clear, so you can address convention gaps and requirement mismatches separately.