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

write-spec

/write-spec

Pisze specyfikację docs/SPEC.md na podstawie plików odkryć lub wywiadu z właścicielem i zapisuje decyzję o budowie jako ADR.

Repozytorium
spec-harness ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

82/ 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ść17 / 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 27.10.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ę docs/SPEC.md na podstawie plików odkryć lub wywiadu z właścicielem i zapisuje decyzję o budowie jako ADR.

Oryginalny opis (EN)

Write docs/SPEC.md from the discovery files in docs/discovery/, or by interviewing the owner when there are none, and record the build decision as an ADR. Use when the owner asks to write or draft the spec. No code, no plan.

Jak działa

SKILL.md bez nagłówków drugiego poziomu · 18 linii, 244 słów

Podgląd SKILL.md
---
name: write-spec
description: Write docs/SPEC.md from the discovery files in docs/discovery/, or by interviewing the owner when there are none, and record the build decision as an ADR. Use when the owner asks to write or draft the spec. No code, no plan.
---

Write `docs/SPEC.md` as `docs/PROCESS.md` describes ("Spec").

1. Read `AGENTS.md`, `docs/PROCESS.md`, and the current `docs/SPEC.md`, including the prompts in its comments.
2. If `docs/discovery/` exists, read `OUTCOMES.md`, every brief in `research/`, and `DECISION.md`.
   - If `DECISION.md` is not **Accepted**, or its deliverable is not `app`, stop and say why. The spec waits for an accepted decision to build an app.
   - Otherwise copy the decision into `docs/decisions/` as the next numbered ADR (usually `0002-<short-title>.md`), in the format of `0000-template.md`, with status Accepted and the decision's date. Link the research briefs from its Context.
3. If there is no `docs/discovery/`, interview the owner one question at a time until every section of the spec can be filled in.
4. Fill every section of `docs/SPEC.md`:
   - Problem, Users and Success measures from the outcomes.
   - What they need to do as numbered goals.
   - Acceptance criteria in EARS form, numbered AC-1 onward, each one testable and each one a behavior, not a design choice.
   - The first build kept narrow: the smallest slice that is useful on its own. Everything else goes under Non-goals as a later feature.
   - Anything undecided under Open questions.
   Keep it to one to three pages. Remove the prompt comments.
5. Ask the owner about anything ambiguous, missing or contradictory, one question at a time, and record each answer in the spec.
6. Stop. Tell the owner to review and commit the spec, then run `/plan-build`. Write no code and no plan.

Wersje

RepozytoriumWynikLicencja
Ta strona · happyotter1971/spec-harness82MIT
anhle9x/ai-worker100MIT
PranamRDoshi/dotclaude100MIT
allemaar/open-skills100Apache-2.0
dzhng/skills100MIT
zanderadam/engy100MIT
tojim00d/Orbit-skills100MIT
trihuynh-agilityio/workez100MIT
me2resh/apexyard100MIT

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

  • 100spec
    Przeprowadza wywiad o funkcji lub projekcie, a potem pisze specyfikację, którą można zbudować.
  • 95spec
    Tworzy specyfikację z wymaganiami, scenariuszami i uzasadnieniem projektu, także przy przekształcaniu ADR w specyfikację.
  • 95feature-spec-creator
    Pisze specyfikację funkcji dla istniejącego kodu w formie wywiadu, gdy trzeba ją zaplanować lub zakresować.
  • 86adr
    Zapisuje decyzję architektoniczną jako krótki ADR w docs/adr i dodaje ją do indeksu architektury.
  • 90spec
    Zapisuje specyfikację w folderze specs z ustaleń z sesji, bez nowego wywiadu: najpierw problem, potem testowalne kryteria.
  • 100to-spec
    Zamienia bieżącą rozmowę w specyfikację i publikuje ją w trackerze zgłoszeń projektu, bez wywiadu.

Uwagi i zgłoszenia

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