Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Planowanie

v-spec

/v-spec

Pisze specyfikację i plan jednej pracy w projekcie v-start, opartą na prawdziwym kodzie, z kryteriami akceptacji i zatrzymaniem do zatwierdzenia.

Repozytorium
v-start ↗
Licencja
MIT
Ostatnia zmiana repozytorium
06.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 06.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

Pisze specyfikację i plan jednej pracy w projekcie v-start, opartą na prawdziwym kodzie, z kryteriami akceptacji i zatrzymaniem do zatwierdzenia.

Wyzwalacze z opisu

write a specspec thisplan this feature
Oryginalny opis (EN)

Write the spec and plan for one piece of work in a v-start project (specs/N-name/spec.md and plan.md), grounded in the real source, with a belief, a pass mark and numbered acceptance criteria, then stop for approval. Use when the user says "/v-spec", "write a spec", "spec this", "plan this feature", or asks to build something whose spec doesn't exist yet.

Jak działa

  1. 1. Read first
  2. 2. Ask (MCQ rounds)
  3. 3. Check the number and the issue
  4. 4. Write specs/N-name/
  5. 5. Stop for review
Sekcje z nagłówków SKILL.md, w oryginale · 40 linii, 505 słów
Podgląd SKILL.md
---
name: v-spec
description: Write the spec and plan for one piece of work in a v-start project (specs/N-name/spec.md and plan.md), grounded in the real source, with a belief, a pass mark and numbered acceptance criteria, then stop for approval. Use when the user says "/v-spec", "write a spec", "spec this", "plan this feature", or asks to build something whose spec doesn't exist yet.
---

# v-spec

Turn one piece of work into a `spec.md` and a `plan.md` that the approver can say yes to. **No application code in this command** (hard rule 1). This is Opus work (hard rule 14).

**Ask every choice as AskUserQuestion multiple choice**, in as many rounds as needed, with the recommended option first. Keep the prose short. **Never write a question in a reply**: if it needs an answer, it's an MCQ. **Get everything before you choose**: ask until you have every answer a choice needs. If AskUserQuestion isn't available or returns an error, put the questions in the spec's Open questions table instead of listing them.

## 1. Read first

`CLAUDE.md`, `docs/PROFILE.md` and `CLAUDE.local.md` (adapt to them: the experience level sets how much you explain, the priority sets the trade-offs, and the platforms set where things get checked), `docs/PROGRESS.md`, `docs/DECISIONS.md`, `docs/VERIFIED.md`, `docs/RISKS.md`, `specs/README.md`, and any existing spec this one depends on.

## 2. Ask (MCQ rounds)

1. **Which piece of work?** Offer what PROGRESS, the PRD and discovery suggest, plus "I'll describe it".
2. **Who is it for, and what belief does it test?** Offer 2–3 drafts of "we believe X will Y for Z".
3. **The pass mark:** offer measurable numbers, using the baseline from VERIFIED where there is one.
4. **Scope:** what's in, and what's explicitly out (multiSelect).
5. **Any open question** a spec can't settle → ask the owner now, or list it under Open questions. Never pick the answer yourself.

## 3. Check the number and the issue

- Next spec number: `ls specs/`, **and** open PRs (`gh pr list`), because other sessions claim numbers in unmerged branches.
- Find or write the issue (Why / Done when / Blocked by / Refs) and put it on the board (CLAUDE.md, "Before you start a task"). Ask before creating anything on GitHub.

## 4. Write `specs/N-name/`

Start from `specs/0-example/`.

- **spec.md:** context; belief and pass mark; **current state**, read from the source and cited as `path:line` at a named commit (nothing from memory); what changes; numbered acceptance criteria a reviewer can observe; open questions. Keep it to 1–3 pages. If it needs more, split it into two specs and say so.
- **plan.md:** prerequisites; where (worktree and branch); checkbox steps, each ending in a commit line; a test per criterion that fails before the change; a spike step first when something unproven blocks the rest (hard rule 1's exception).
- Add a row to `specs/README.md`.

## 5. Stop for review

- Commit on a `docs/spec-N-<name>` branch, staging files by name: `docs(spec): N. <name> spec and plan`.
- Open a PR only on the user's yes.
- PROGRESS: "spec N drafted, waiting on the approver".
- When this spec later merges, the check-in in `CLAUDE.md` (Personalisation) runs.
- Report in a short table: the belief, the pass mark and the criteria count. Ask each open question as an MCQ. Any that stay open go in the spec's Open questions table, not in the reply. **Then stop.** Building starts only after approval.

Wersje

W bazie nie ma innych skilli o nazwie v-spec.

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

  • 90write-spec
    Pisze specyfikację funkcji z ponumerowanymi kryteriami akceptacji, zanim powstanie plan albo kod.
  • 100spec
    Przeprowadza wywiad o funkcji lub projekcie, a potem pisze specyfikację, którą można zbudować.
  • 90Spec
    Pisze ugruntowaną specyfikację: przypomina wcześniejsze decyzje, bada kod i formułuje testowalne kryteria akceptacji.
  • 100trove-spec
    Pisze strukturalną specyfikację produktu z historyjkami użytkownika, kryteriami akceptacji i uwagami technicznymi.
  • 100create-specs
    Prowadzi przez specyfikację z bramkami akceptacji dla nowej funkcji analitycznej i tworzy spec.md, plan.md, tasks.md oraz status.md.
  • 95memstack-product-feature-spec
    Pisze specyfikację jednej funkcji: przepływy użytkownika, przypadki brzegowe, API i kryteria akceptacji.

Uwagi i zgłoszenia

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