About code-review
Code Review is a repository skill for assessing code changes against tests, project terminology, and applicable design documents. It emphasizes evidence for regressions and distinguishes justified design changes from unexplained deviations.
Key features
- 01Check tests for changes and regressions
- 02Verify repository-consistent wording
- 03Consult relevant design documents
- 04Compare changes with design requirements
- 05Assess rationale for design changes
Use cases
- 01Reviewing a bug-fix pull request
- 02Checking CLI or integration changes
- 03Evaluating architectural consistency
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ github/ spec-kit --skill code-reviewAfter installing, type/code-reviewin Claude Code to confirm it loaded.
Details
From the project READMECode Review
- Ensure each code change has test cases that verify what the code should do and what it should prevent.
- Ensure bug-fix pull requests include a regression test that demonstrates the bug was reproducible before the change and is fixed afterward; if the reviewer cannot run the comparison, use available evidence and state that limitation.
- Ensure wording changes use repository-consistent terms; exclude community-authored catalog content and its generated documentation from this check.
- Identify the affected domains and read the applicable documents in
design/before evaluating architectural consistency. For CLI command changes, usedesign/cli.md; for agent integrations, usedesign/integration.md; for workflow step types, usedesign/workflow-step.md. Read other design documents when relevant, not every document for every PR. - Check the changes against the applicable design requirements, including implementation boundaries, ownership, lifecycle, and delivery requirements. Reference the documents rather than duplicating their rules in this skill. Cite the document and section for each reported mismatch.
- Distinguish an unexplained design violation from an intentional design change. Evaluate the rationale and evidence for an intentional change; updating the design document alone does not establish that the implementation is justified.
Comments
Markdown supported