Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

dev-review

/dev-review

Przegląda diff, gałąź lub pull request przed scaleniem pod kątem poprawności, standardów i zgodności ze specyfikacją.

Repozytorium
dev-kit ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Przegląda diff, gałąź lub pull request przed scaleniem pod kątem poprawności, standardów i zgodności ze specyfikacją.

Oryginalny opis (EN)

Use when a diff, branch or PR needs review before merge, on correctness, standards and the spec.

Jak działa

  1. When to Use
  2. Checklist
  3. Rationalizations
  4. Red Flags
  5. Verification
Sekcje z nagłówków SKILL.md, w oryginale · 50 linii, 590 słów
Podgląd SKILL.md
---
name: dev-review
description: Use when a diff, branch or PR needs review before merge, on correctness, standards and the spec.
disable-model-invocation: true
---
# dev-review

Paths: the `bin/` tools and the `library/` folder live in `~/.agents/dev-kit/`; run tools by that path.

Task: no `DEVKIT_TASK` set? Run `~/.agents/dev-kit/bin/ledger start <slug>` first (it prints your id) and prefix dev-kit commands with `DEVKIT_TASK=<id>`. `<task>` below is `.devkit/tasks/<id>` at the repo root; never write run files anywhere else. Also read `.devkit/memory.md` if it exists.

Open the host todo list (todowrite, TodoWrite or TaskCreate, whichever exists; else a checklist in <task>/state.md) with this checklist verbatim, and tick items as steps finish. A skipped step stays listed with a reason. Run `bin/ledger` after every step (phase=review).

## When to Use
- Before merging or committing a non-trivial diff, after a ship worker returns, or when reviewing a branch or PR.
- Tiny diff: self-review with the same axes and ledger that you did.

**You own:** findings on two axes (Standards and Spec) with a recorded disposition for each.

**Reads:** always library/principles (step 0), library/simplify, library/doubt, library/state, library/deep/blast-radius. If the diff touches security: library/security. If it touches performance: library/performance. If it touches a runtime path: library/observability.

## Checklist
- [ ] 0. Skim library/principles (about 700 tokens); open a deep file only when its trigger matches.
- [ ] 1. Pin the base: `B=$(git merge-base HEAD <base>)`. The diff is `git diff $B` (tracked changes, staged or not) plus untracked files from `git status -s`. Confirm it is non-empty before spawning.
- [ ] 2. Find the spec (issue, `<task>/spec.md`, docs) and the standards (CONTRIBUTING, lint config, AGENTS.md).
- [ ] 3. Brief two scouts, each with the diff command and only its own sources:
  - Standards: repo conventions, then smells (duplication, mystery names, speculative generality, feature envy, shotgun changes). Repo rules override smells. Skip what tooling enforces. Also library/simplify, and library/security or library/performance when the diff touches those.
  - Spec: per requirement, met / partly / missing / extra, with file:line.
- [ ] 4. Run both via dev-spawn (scout shape) in parallel and wait for both reports.
- [ ] 5. Blast radius: follow library/deep/blast-radius for each changed contract.
- [ ] 6. Merge: dedupe, order by severity (bug, regression, standards, nit), drop anything without file:line.
- [ ] 6a. Runtime path touched? a changed or added signal has a test asserting it (library/observability).
- [ ] 7. Risky change? library/doubt on your merged conclusion.
- [ ] 8. Each blocker is fixed or accepted with a recorded reason. Re-check the diff after fixes. Closeout: follow library/state. Then close the ledger: `bin/ledger done "<summary>"`, or a `next` row with the first runnable step if work remains.

**Hand off to:** the calling route if any, else the user, to fix blockers; there is no next playbook.

**Reply:** findings ordered by severity, each with file:line; the one safe-because fact with its level; each disposition.

## Rationalizations
| Excuse | Rebuttal |
|---|---|
| "One reviewer is cheaper" | Mixed axes hide spec gaps behind style notes. |
| "Tests passed" | Tests do not catch scope creep or missing requirements. |
| "Nits are noise" | Label them nit and do not block on them. |

## Red Flags
- Findings with no file:line; style opinions presented as bugs.
- Reviewer saw the author's reasoning and agrees with it.
- Reviewing an empty or wrong diff; reviewing only the changed lines, not callers.

## Verification
- Both scout reports exist and cite file:line; every finding has a disposition in the ledger.
- Close the ledger: `bin/ledger done "<summary>"`, or a `next` row with the first runnable step if work remains.

Wersje

RepozytoriumWynikLicencja
Ta strona · nchandar/dev-kit100MIT
pdl-openair/OpenAIR100Apache-2.0
lflish/devflow100MIT
codeaholicguy/ai-devkit90Apache-2.0
HarunRRayhan/RayStack90MIT

Migawka bazy z 13.11.2026 · wersja paczki f8b53ffdc7d8 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90dev-pr-review
    Przegląda gałąź, pull request lub lokalny diff przed scaleniem i sprawdza zgodność opisu PR ze zmianami.
  • 90review
    Przegląda gałąź, diff lub pull request w repozytorium przed scaleniem pod kątem poprawności, zgodności wstecznej, bezpieczeństwa, testów, dokumentacji i changesetów.
  • 90code-review
    Sprawdza gałąź, pull request albo roboczy diff pod kątem błędów, regresji i zgodności ze specyfikacją.
  • 100code-review
    Przegląda zmiany (pull request, gałąź, zakres commitów lub bieżący diff) pod kątem poprawności, bezpieczeństwa i łatwości utrzymania przed merge'em.
  • 100review
    Przegląda pull request w ClickHouse pod kątem poprawności, bezpieczeństwa, wydajności i zgodności.
  • 90review-pr
    Wykonuje pełny przegląd pull requesta pod kątem poprawności, bezpieczeństwa, wydajności, pokrycia testami i standardów kodowania przed scaleniem.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.