Review a bounded implementation change for defects, regressions, unsafe assumptions, and maintainability risks, then report prioritized evidence-backed findings. Use for code review, diff review, pre-merge review, or independent assessment of a completed change; not for running only automated checks, auditing broad technical debt, or implementing fixes.
Resources
1Install
npx skillscat add tvproductions/gz-skills/gzs-change-review Install via the SkillsCat registry.
GovZero Change Review
Review one bounded change as an independent reader. Find defects that can affect
users, operators, data, security, compatibility, or future changes; do not turn
the review into an approval ceremony, style rewrite, or implementation pass.
Precedence and scope
- Read applicable repository instructions and any active project-owned review
workflow first. Supply the review discipline below without replacing its
reviewer roles, independence rules, gates, receipts, or verdicts. - Resolve the comparison base and exact changed-file set from the request,
pull-request metadata, upstream branch, or merge base. State the chosen base
and include relevant uncommitted changes when they are part of the requested
review. Stop if different reasonable bases would materially change the scope. - Locate the change's stated intent when available, but keep this review
defect-focused. Usegzs-intent-auditinstead when the primary question is
whether delivered behavior completely fulfills an authoritative plan or
specification. - Review is read-only. Do not edit code, publish comments, approve, merge, or
create issues unless separately authorized.
Discovery and fallback
Prefer, in order:
- An active project-owned review workflow, whose reviewer roles, gates, and
verdicts stay in control. - Repository review tooling or pull-request metadata that resolves the
comparison base. - The diff against the resolved base, read directly from version control.
The third rung is the floor and is always available: the diff is the review's
actual subject, and every other rung only organizes how it is read. This skill
therefore needs no project surface to function, only a base it can name.
Review workflow
Read the complete diff, then inspect changed code in context: immediate
callers and consumers, relevant public contracts, nearby tests, error paths,
persistence boundaries, and a working analogue where one exists.Trace affected behavior through inputs, state transitions, outputs, and
failure handling. Check correctness, edge cases, compatibility, security and
trust boundaries, concurrency, resource ownership, observability, and
maintainability in proportion to the change's actual risk.Use focused tests, analyzers, or history as evidence when they can confirm or
refute a suspected defect. Do not duplicate the repository's complete
quality gate merely to make the review look comprehensive.Retain a finding only when it has a reachable scenario, violated invariant,
failing check, or precise code path. Cite the narrowest useful file and line,
explain the consequence, and give a fix direction without writing the patch.Remove findings that are taste-only, speculative, unrelated pre-existing
debt, or already enforced by tooling without a demonstrated escape. State
uncertainty and the missing observation instead of overstating confidence.Rank retained findings by consequence and urgency:
- Critical: immediate security, safety, irreversible-data, or published-
contract failure that should block use or release. - High: likely user-visible regression or major operational failure that
should block merging the change. - Medium: bounded correctness or maintainability defect with a concrete
future cost or narrower trigger. - Low: real but limited risk whose remediation can safely follow later.
- Critical: immediate security, safety, irreversible-data, or published-
Output
Present findings first, ordered by severity. For each finding provide a concise
title, location, triggering scenario, consequence, evidence, and fix direction.
Then state the reviewed base and scope, checks used, assumptions, and residual
risk. If no findings survive, say so explicitly; do not imply that review alone
proves the change correct or that the containing workflow is complete.