What happens if a checklist comment already exists on my PR?

The skill is designed to be idempotent; it will identify the existing checklist comment and update it rather than creating duplicate comments on the same pull request.

Can I use this without a pre-defined plan file?

Yes, if no plan is detected or provided, the skill will skip the acceptance criteria section and focus on ADR compliance and general quality checks.

How does it identify which ADRs are relevant to my PR?

The skill analyzes the specific files changed in your pull request and cross-references them with your project's Architectural Decision Records (ADRs) to ensure technical decisions are followed.

Where are the review checklists stored?

Following a dual-storage pattern (ADR-012), the checklist is both posted as a comment on the GitHub PR for the team to see and saved locally in a `.review/` directory for persistence.

Does this skill require the GitHub CLI?

Yes, the skill utilizes the official GitHub CLI (gh) to fetch pull request metadata and post comments. You must have it installed and authenticated on your local machine.

Spec-Driven PR Review Checklist

Name: Spec-Driven PR Review Checklist
Author: alexnodeland

byalexnodeland

•

协作工具

Generates comprehensive, specification-driven pull request review checklists by automating the extraction of acceptance criteria and ADR compliance.

This skill automates the creation of high-quality PR review checklists by synchronizing your code reviews with project specifications. It analyzes GitHub pull requests to extract acceptance criteria from DDD plans and identifies relevant Architectural Decision Records (ADRs) based on modified files, ensuring that every code change aligns with established project standards and functional requirements. It facilitates a dual-storage approach by posting checklists directly to GitHub as comments while maintaining local records, making it indispensable for teams practicing rigorous, specification-led development.

主要功能

01Maintains local persistence of checklists for auditability and ADR-012 compliance

023 GitHub stars

03Detects plan references automatically from PR descriptions and branch names

04Identifies relevant Architectural Decision Records (ADRs) based on affected files

05Automates GitHub PR commenting with a structured, interactive checklist

06Extracts acceptance criteria directly from DDD plan files and specific task IDs

使用场景

01Ensuring architectural compliance in complex codebases with many active ADRs

02Validating that all functional requirements in a feature plan are met before merging

03Standardizing code review quality across a distributed engineering team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled review-checklist

For use in Claude.ai and ChatGPT

Download Skill