alexbruno/dev-skills

code-review

Perform structured, multi-dimensional code reviews aligned with the spec-driven-workflow (workflow/SPEC.md, workflow/PLAN.md, workflow/REVIEW.md).

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/alexbruno/dev-skills --skill code-review

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Code Review

Review code changes against both engineering quality and specification intent, recording every actionable finding in workflow/REVIEW.md.

Review Philosophy

  • Net improvement over perfection: Approve changes that clearly improve overall code health and satisfy workflow/SPEC.md, even if minor stylistic preferences differ.
  • Evidence over opinion: Ground every finding in a concrete file path, line range or symbol, and explain why it matters.
  • Zero silent passes: Do not approve or finish work while any blocker or major finding remains open.

1. Load Workflow Context First

Before inspecting the diff, read the active workflow/ artifacts (or workflow/<change-slug>/ for scoped parallel work):

  1. `workflow/SPEC.md` — Verify goals, non-goals, constraints, and acceptance criteria.
  2. `workflow/PLAN.md` (and `workflow/TASKS.md`, if present) — Understand the intended technical approach and module scope.
  3. `workflow/REVIEW.md` — Check prior review rounds so resolved items are not re-reported and open items are re-verified.

If workflow/REVIEW.md does not exist yet, create it (using the spec-driven-workflow REVIEW.md template if installed).

2. Five-Axis Review Framework

Evaluate the diff (e.g., git diff, staged changes, or target PR) across all five dimensions:

  1. Correctness & Spec Alignment
  • Does the implementation satisfy every acceptance criterion in workflow/SPEC.md?
  • Does it stay within scope (no unintended changes outside SPEC.md / PLAN.md)?
  • Are edge cases (null/empty values, boundaries, concurrency) and error paths handled?
  • Do tests verify the new behavior and guard against regressions?
  1. Readability & Simplicity
  • Are names clear and consistent with the codebase?
  • Is control flow shallow and easy to follow without dead code or over-engineering?
  1. Architecture & Maintainability
  • Does the change follow existing codebase patterns and respect module boundaries?
  • Does it avoid duplicated logic or unnecessary coupling?
  1. Security
  • Is untrusted input validated and sanitized at system boundaries?
  • Are secrets, tokens, and sensitive data kept out of code, configs, and logs?
  • Are queries parameterized and auth/authorization checks enforced?
  1. Performance
  • Are there obvious N+1 queries, unbounded loops/fetches, memory leaks, or blocking I/O on hot paths?

3. Record Findings in workflow/REVIEW.md

Log every finding in workflow/REVIEW.md using consistent severity tiers and resolution statuses:

  • Severities:
  • blocker: Must be fixed before completion (broken spec requirement, security flaw, data-loss risk, failing build/tests).
  • major: Must be addressed before completion (edge-case bug, weak error handling, architectural violation, missing test coverage).
  • minor: Optional improvement or nit (naming, minor readability cleanup); never blocks approval.
  • question: Clarification needed from the author or implementing agent.
  • Statuses: open | resolved | wontfix (with brief rationale).

Each finding entry must include:

  • A unique ID (e.g., [R1], [Q1]), exact file path and line/symbol reference, severity, status, Issue, and Action.

4. Verification & Sign-Off

  1. Run the project's verification commands (test, lint, typecheck, build as applicable) rather than relying on inspection alone.
  2. Update workflow/REVIEW.md status (Open | Changes Requested | Approved):
  • Approved: All SPEC.md acceptance criteria are met, checks pass, and zero blocker or major items remain open.
  • Changes Requested: One or more blocker or major items remain open.
  1. Follow the spec-driven-workflow cleanup rule: never delete workflow/REVIEW.md; only clear/reset its contents after the user confirms everything is ready.
같은 저장소의 Skills

더 많은 Skills

모든 Skills
alexbruno
커뮤니티

architect-worker

Role-based multi-agent software engineering pattern separating high-level architecture, specification, planning, and code review (Architect) from focused code implementation and verification (Worker). Use this skill whenever assigned the Architect or Worker role (in any language), or when coordinating work between planning/review agents and implementation agents via workflow/.

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 13일
alexbruno
커뮤니티

changelog-management

Maintain and update a standardized root CHANGELOG.md following Keep a Changelog and Semantic Versioning. Use this skill to initialize or update changelog entries, categorize changes, prepare release cuts, and proactively prompt the user when notable changes warrant updating the changelog.

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 13일
alexbruno
커뮤니티

code-simplification

Simplify code for human readability, clarity, and directness without changing behavior. Use this skill after implementing a feature, during refactoring, or when addressing code review feedback—especially when code feels over-engineered, deeply nested, or takes unnecessary detours to do simple things.

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 13일
alexbruno
커뮤니티

codebase-indexing

Index, synchronize, and query a project's codebase using CodeGraph and Repomix. Use this skill when exploring an unfamiliar repository, maintaining up-to-date code intelligence after edits, or setting up project indexing with .codegraph/ and Markdown-formatted Repomix snapshots.

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 13일