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

review-changes

/review-changes

Przegląda gotową zmianę świeżymi recenzentami i potwierdza każde ustalenie, zanim wdroży poprawki.

Repozytorium
todoist-cli ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
2
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 gotową zmianę świeżymi recenzentami i potwierdza każde ustalenie, zanim wdroży poprawki.

Wyzwalacze z opisu

ready for a PRready to mergea review
Oryginalny opis (EN)

Reviews a finished change with fresh reviewers (a task review, a blast-radius review for shared code, and Doistbot or per-check subagents), then confirms each finding before acting on it. Use when the owner says a change is "ready for a PR", "ready to merge" or ready for a release, or asks for "a review".

Jak działa

  1. 1. Prepare
  2. 2. Run the reviews in parallel
  3. 3. Doistbot locally
  4. 4. Confirm each finding
  5. 5. Fix, verify, re-review
Sekcje z nagłówków SKILL.md, w oryginale · 44 linii, 579 słów
Podgląd SKILL.md
---
name: review-changes
description: Reviews a finished change with fresh reviewers (a task review, a blast-radius review for shared code, and Doistbot or per-check subagents), then confirms each finding before acting on it. Use when the owner says a change is "ready for a PR", "ready to merge" or ready for a release, or asks for "a review".
---

# Review a change

Reviews cost several agent runs. Run them when the owner says the change is ready, or asks. During work, `npm run verify` is the check.

## 1. Prepare

1. `npm run verify` passes.
2. List the untracked files (`git ls-files --others --exclude-standard`): they reach the reviewers and Doistbot's model providers. Gitignored files (`.env`, `.tmp/`) are not listed, and `npm run review:worktree` never copies them. Check every listed file for credentials, tokens and personal data; send none that holds them, and ask the owner about any file that does or that doesn't belong to the change. Never `git add -A` to tidy up.
3. Write the brief from [references/reviewer-brief.md](references/reviewer-brief.md): the task in the owner's words, what done means, the decisions made. Never your own opinion of the change, or your reasoning.

Done when the brief is written and the tree holds only the change, with no secrets or personal data in it.

## 2. Run the reviews in parallel

- **Task review**, always: a fresh subagent with the brief and the diff. It looks for missing pieces, unrequested changes, unhandled cases, tests that would pass with the feature broken, and, in a refactor, any changed test input or assertion. Doistbot can't do this: it never sees the task.
- **Blast-radius review**, when the change alters code others rely on: `src/lib/`, command registration, global flags or argv handling in `src/index.ts`, the `@todoist/cli-core` or `@todoist/sdk` version, other `package.json` dependencies, build or CI config. It names the one fact that makes the change safe and proves it by running code. It looks where text search stops: library versions in `package-lock.json`, the shape of API responses, scripts and installed skills reading `--json` output, extensions receiving `TD_*` variables.
- **Code review**: Doistbot if it is set up (below). Otherwise one subagent per relevant check in `.agents/checks/`, each with the brief and that check.

Every brief says: **the shared working tree is read-only.** A reviewer that needs to run or break code makes its own copy with `npm run review:worktree -- <dir>`, then `npm ci` in it, and removes it after.

## 3. Doistbot locally

Use it when `doistbot --version` prints 1.0.12 or newer and `doistbot doctor` succeeds. Otherwise use the per-check subagents and tell the owner Doistbot was skipped.

- Off the default branch: `doistbot review --json`. In a stack: `doistbot review --base <branch below> --json`. Both cover commits, staged and unstaged edits, and untracked files. Nothing needs staging.
- Not `doistbot review staged`: it skips the branch's commits and still reports `verified`.
- Read `status`, `verified` and `providerFailures` first. An unverified review, or one with a failed provider, is partial: say so, and cover that gap with a subagent.
- It runs before the Doistbot review on the pull request, not instead of it.

## 4. Confirm each finding

Reviewers rate findings on the `verify` ladder. Take each to the rung its claim needs: the cited line for what the diff shows, a failing test or command for a behaviour claim. Then:

- **fix** it,
- **dismiss** it with evidence at that rung (the line, the test output), never an argument, or
- **leave it open** for the owner, saying what would settle it.

Look again when new evidence appears. Done when every finding has one of the three.

## 5. Fix, verify, re-review

Fix, then `npm run verify`. A large fix gets its own task review. Report the findings with what happened to each, in the `verify` report format.
Pliki w paczce (2)
  • SKILL.md 4 KB
  • references/reviewer-brief.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · doist/todoist-cli90MIT
grixu/cc-toolkit100MIT
joshgons/agent-skills100MIT
rimega92/Engineering-Skills100MIT
eldrego/claude-dev-workflow100MIT
ncosentino/needlr100MIT
jerelvelarde/chalk-skills100MIT
Pluneto/skills90MIT
marliechorgan/claude-setup90MIT

Migawka bazy z 13.11.2026 · wersja paczki 6acba11867d2 (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

  • 100review-code
    Przegląda diff, gałąź lub PR pod kątem realnych defektów i sprawdza każde ustalenie, zanim je zgłosi.
  • 90reviews
    Przegląda zmianę w kodzie lub pull request pod kątem kondycji kodu, np. na prośbę o code review.
  • 100code-review
    Przegląda zmianę świeżymi agentami recenzentów pod kątem defektów, luk w specyfikacji i zbędnego kodu.
  • 100comprehensive-review
    Przegląda zmiany w kodzie i weryfikuje jakość implementacji oraz gotowość do PR lub wdrożenia, uruchamiając wszystkie recenzje.
  • 90pr-review-agent
    Prowadzi pełny przegląd PR jako orkiestrator: sprawdza zasięg zmian i dryf na zmienionych plikach, a potem przekazuje do pr-review segregację komentarzy i poprawki.
  • 90bmad-code-review
    Przegląda zmiany w kodzie kilkoma niezależnymi recenzentami równolegle, a potem sortuje i przedstawia ustalenia.

Uwagi i zgłoszenia

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