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.
- Autor
- sovithyea ↗
- Repozytorium
- v-start ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 06.11.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 06.11.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
Pisze specyfikację i plan jednej pracy w projekcie v-start, opartą na prawdziwym kodzie, z kryteriami akceptacji i zatrzymaniem do zatwierdzenia.
Wyzwalacze z opisu
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. Read first
- 2. Ask (MCQ rounds)
- 3. Check the number and the issue
- 4. Write specs/N-name/
- 5. Stop for review
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.