write-review
/write-review
Recenzuje specyfikację SpecForge jako agent recenzent, zapisuje werdykt i uwagi uporządkowane wagą oraz dodaje recenzję jako dokument podrzędny.
- Autor
- NitinJ ↗
- Repozytorium
- specforge ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 23.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 23.09.2026, bez odwołań do wycofanych modeli i API.
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
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
- The cadence
- 1. Read the spec you are reviewing
- 2. Create the review
- 3. Write the four sections
- 4. Pass the gate
- 5. Hand off
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.