Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Przegląd i audyt

write-review

/write-review

Recenzuje specyfikację SpecForge jako agent recenzent, zapisuje werdykt i uwagi uporządkowane wagą oraz dodaje recenzję jako dokument podrzędny.

Repozytorium
specforge ↗
Licencja
MIT
Ostatnia zmiana repozytorium
23.09.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 23.09.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

Recenzuje specyfikację SpecForge jako agent recenzent, zapisuje werdykt i uwagi uporządkowane wagą oraz dodaje recenzję jako dokument podrzędny.

Wyzwalacze z opisu

review spec <id>critique this specgive a second opinion on <spec>
Oryginalny opis (EN)

Review a SpecForge spec as a reviewer agent, and file the review as a child spec of the spec being reviewed. Use when asked to "review spec <id>", "critique this spec", "give a second opinion on <spec>", or when a workflow hands you a spec to review. Creates the review with `specforge review`, writes a verdict and severity-ranked findings, credits you as a reviewer of the reviewed spec, and passes the verify gate. Not for answering comments on a spec you own: that is review-spec.

Jak działa

  1. The cadence
  2. 1. Read the spec you are reviewing
  3. 2. Create the review
  4. 3. Write the four sections
  5. 4. Pass the gate
  6. 5. Hand off
Sekcje z nagłówków SKILL.md, w oryginale · 78 linii, 471 słów
Podgląd SKILL.md
---
name: write-review
user-invocable: false
description: |
  Review a SpecForge spec as a reviewer agent, and file the review as a child
  spec of the spec being reviewed. Use when asked to "review spec <id>",
  "critique this spec", "give a second opinion on <spec>", or when a workflow
  hands you a spec to review. Creates the review with `specforge review`, writes
  a verdict and severity-ranked findings, credits you as a reviewer of the
  reviewed spec, and passes the verify gate. Not for answering comments on a
  spec you own: that is review-spec.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep
---

# write-review

A review is a spec of its own, filed under the spec it reviews. It gets its own
URL, status and comment threads, and the reviewed spec's **Child specs** drawer
lists every review it has had. The reviewed spec shows you as a reviewer on the
home page and in its header.

`${CLAUDE_PLUGIN_ROOT}` below denotes the installed plugin directory. Claude and
Pi export it; Codex provides the exact value in SpecForge SessionStart context.
Substitute that value in every path and shell command.

## The cadence

- **One review is one child spec.** Reviewing again after the author changed
  the spec is a new review, never an edit of the old one, so the history stays.
- **Never edit the reviewed spec**, and do not leave comments on it. The review
  is the channel. The author decides what changes.
- **Say so if you are its author.** The home page and header show who wrote it.
  A self-review is allowed when asked, and its scope section says it is one.

## 1. Read the spec you are reviewing

Resolve what you were given to a spec id first. A store id is 10 hex
characters; anything else, look up with:

```
node "${CLAUDE_PLUGIN_ROOT}/lib/specforge-cli.mjs" listall
```

Then read it by map and section rather than as one file:

```
node "${CLAUDE_PLUGIN_ROOT}/lib/spec-nav-cli.mjs" map --spec ~/.specforge/specs/<id>/spec.html
node "${CLAUDE_PLUGIN_ROOT}/lib/spec-nav-cli.mjs" section <sectionId> --spec ~/.specforge/specs/<id>/spec.html
```

Check its claims against whatever it rests on: the code, the sibling specs it
links, the request it answers. A review that only read the spec says so.

## 2. Create the review

```
node "${CLAUDE_PLUGIN_ROOT}/lib/specforge-cli.mjs" review <id> --model <your model id>
```

`--model` is your own model id, exactly as your harness names it (for example
`claude-opus-5`, `gpt-6-astra`, `glm-5.3-flash`). The harness is detected. The
command creates the child spec, credits you as its author, and credits you as a
reviewer of `<id>`.

It prints what `create` prints: `{ id, htmlPath, url, skeleton, prompts,
language, author, reviewOf, reviewers }`. Author into `htmlPath`, section by
section, as the `create-spec` skill describes. **`language` is the writing
contract in force; follow it.** **Read `prompts` before writing each section.**

## 3. Write the four sections

Verdict, what you reviewed, findings, questions for the author. The prompts
carry the rules. Keep the whole review short: five blocking and major findings
are worth more than twenty minor ones. Link each finding to the section it is
about, as `/spec/<reviewed id>#<section id>`.

## 4. Pass the gate

```
node "${CLAUDE_PLUGIN_ROOT}/lib/specforge-cli.mjs" verify <reviewId> --json
```

The same loop as `create-spec` step 4: fix what fails, judge the ask rules,
three rounds at most.

## 5. Hand off

Print the review's URL and its verdict in one line. The review is attached to
your session, so comments on it reach you; arm delivery the way `create-spec`
step 5 describes.

Wersje

W bazie nie ma innych skilli o nazwie write-review.

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

  • 90specforge-project
    Kieruje prośby o zaplanowanie aplikacji, API lub produktu programistycznego przez narzędzie SpecForge przed implementacją.
  • 100convert-spec
    Konwertuje istniejący plik projektu lub specyfikacji na specyfikację SpecForge w magazynie: wczytuje gotowy HTML SpecForge albo przepisuje Markdown lub dowolny dokument w stylu domowym i uruchamia lint.
  • 100create-spec
    Pisze nową specyfikację w stylu domowym w SpecForge: wybiera typ pasujący do potrzeby (dokument projektowy, PRD, UX, plan testów, plan wdrożenia, przegląd bezpieczeństwa) i uzupełnia jego sekcje.
  • 100agent-spec
    Pisze specyfikację agenta AI z perspektywy produktu: zakres pracy, autonomia, przekazanie człowiekowi, koszty i sposób oceny.
  • 100spec
    Pisze specyfikację gotowej historyjki jako osobny pull request i zatrzymuje się na przeglądzie specyfikacji.
  • 85pm-product-spec
    Pisze dokument wymagań produktu (PRD) lub specyfikację opartą na zwalidowanym problemie, z mierzalnymi wymaganiami i ryzykami, albo recenzuje istniejący.

Uwagi i zgłoszenia

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