spec-review

Orchestrate automated spec-compliance reviews with subagents against provided specifications.

Updated Dec 15, 2019
One-click install
npx skills add https://github.com/matsuyoshi30/dotfiles --skill spec-review-matsuyoshi30
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/matsuyoshi30/dotfiles/tree/main/.agents/skills/spec-review
Command: npx skills add https://github.com/matsuyoshi30/dotfiles --skill spec-review-matsuyoshi30

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the spec-compliance review process by orchestrating subagents to verify that implementations align with provided specifications, identify gaps, and apply fixes until compliance or the iteration limit is reached.

Core Features & Use Cases

  • Orchestrates a persistent review loop against a formal spec using a dedicated spec-review subagent and a fix subagent.
  • Accepts specs from GitHub issue URLs, design documents, or inline text, and targets file paths or diffs to scope the review.
  • Supports iterative compliance verification, stopping when all issues are resolved or the maximum number of iterations is reached.

Quick Start

Provide the spec source (URL, file path, or inline text) and an optional target to start the automated spec-compliance loop.

Frequently Asked Questions about spec-review

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

FAQPage Schema
How do I automate spec-compliance review for my code implementation?

Automate spec-compliance review by spawning subagents to compare your implementation against provided specifications. The loop iteratively identifies gaps and applies fixes until compliance or the iteration limit is reached.

Can I use a GitHub issue URL as a spec source for automated code review?

Yes, you can use a GitHub issue URL as a spec source for automated code review. The review loop also accepts design documents or inline text, and targets specific file paths or diffs to scope the verification.

How does the iteration loop work when verifying code against a design document?

The iteration loop verifies code against a design document by using a dedicated spec-review subagent to find gaps and a fix subagent to resolve them. It repeats until all issues are resolved or a maximum iteration count is hit.

What is the best way to scope an automated spec review to a specific code diff?

The best way to scope an automated spec review to a specific code diff is to provide the diff as the target alongside your spec source. This focuses the subagents' comparison and compliance verification strictly on the changed files.

What happens when the maximum iteration limit is reached during spec compliance verification?

When the maximum iteration limit is reached during spec compliance verification, the loop stops and generates a final compliant report. This bounded loop ensures the process terminates with explicit exit criteria.

Do I need to provide explicit exit criteria for an automated spec-compliance loop?

No, you do not need to provide explicit exit criteria manually. The automated spec-compliance loop enforces bounded iterations internally, stopping when all issues are resolved or the maximum number of iterations is reached.