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

spec

/spec

Prowadzi interaktywne odkrywanie wymagań i zapisuje pliki specyfikacji, gdy użytkownik prosi o spisanie specyfikacji.

Repozytorium
agent-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.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
1
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.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 sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Prowadzi interaktywne odkrywanie wymagań i zapisuje pliki specyfikacji, gdy użytkownik prosi o spisanie specyfikacji.

Wyzwalacze z opisu

spec thiswrite specscreate specsrun the spec skill
Oryginalny opis (EN)

Drives interactive requirement discovery to produce spec files. Use when the user says "spec this", "write specs", "create specs", or "run the spec skill".

Jak działa

  1. Process
  2. OpenSpec format
Sekcje z nagłówków SKILL.md, w oryginale · 64 linii, 456 słów
Podgląd SKILL.md
---
name: spec
description: >
  Drives interactive requirement discovery to produce spec files.
  Use when the user says "spec this", "write specs", "create specs", or "run the spec skill".
---

# Spec

Turn the proposal's capabilities into testable behavioral requirements through collaborative
discovery. Specifications define observable behavior, not architecture or implementation.

Do not write a capability's spec until you have presented its proposed requirements and scenarios and
the user has approved them.

## Process

1. Read the proposal and related existing specifications. Use the proposal's capability names to
   determine the new or modified spec files. For modified capabilities, locate the current requirement
   blocks before drafting the delta.
2. Work through capabilities one at a time. Use `codagent:ask-questions` to resolve material behavior,
   boundaries, errors, and edge cases. Ask only questions that affect observable behavior or scope,
   recommend a default when useful, and do not use a generic approval question as discovery.
3. Present the complete proposed requirements and scenarios for that capability, including
   consequential assumptions or defaults inferred from context. When asking for approval of the
   first capability, also offer a shorter version; make the offer only once.
   - The shorter version gives one plain-language line per requirement and no scenarios, followed by
     the defaults you inferred and any decision that needs the user's call.
   - Once the user asks for it, use it for the remaining capabilities unless they ask for full detail.
   - Approving a shorter version approves the requirements it summarizes. Derive the written
     scenarios only from those lines and the listed defaults, adding no new behavior. If the user
     later asks for the full version, show it and revise the spec file to match their feedback.
4. After approval, write the spec file using the format below. Continue until each proposal capability
   has a corresponding spec.

If behavior depends on an unresolved architectural choice, specify as much as is currently knowable and
add `<!-- deferred-to-design: <reason> -->` to the affected scenario. The design phase will complete or
revise it. Do not ask architecture or implementation questions during specification.

Report the relative paths created. Do not invoke another lifecycle skill.

## OpenSpec format

- Use one file per capability: `specs/<capability>/spec.md`.
- Write normative requirements with SHALL or MUST.
- Use `### Requirement: <name>` and at least one `#### Scenario: <name>` per requirement.
- Scenarios describe observable WHEN/THEN behavior. Exactly four hashes on scenario headings are
  required by the parser.
- Avoid scenarios about file contents, configuration structure, or skill text unless those are the
  actual public contract.

Use delta sections as applicable:

- `## ADDED Requirements` for new behavior.
- `## MODIFIED Requirements` for changed behavior. Copy the entire existing requirement block and all
  scenarios before editing it.
- `## REMOVED Requirements` with **Reason** and **Migration**.
- `## RENAMED Requirements` with FROM and TO.

```markdown
## ADDED Requirements

### Requirement: <name>
<normative behavior>

#### Scenario: <name>
- **WHEN** <condition>
- **THEN** <observable result>
```

Wersje

RepozytoriumWynikLicencja
Ta strona · codagent-ai/agent-skills100MIT
renzrollon/interlock100MIT
CodaColaLight/nightmill100Apache-2.0
duronext/jig100MIT
optiflowic/keyturn100MIT
rjmurillo/ai-agents100MIT
rjmurillo/ai-agents100MIT
rjmurillo/ai-agents100MIT
flavien-ia/hypervibe-craft100Apache-2.0

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

  • 100verify-specs
    Weryfikuje zbudowany system względem specyfikacji i wydaje werdykt dla każdego identyfikatora wymagania.
  • 100write-spec
    Pisze specyfikacje techniczne i nietechniczne funkcji w Markdown, z diagramami Mermaid, oparte na kodzie.
  • 90spec-driven
    Prowadzi przez projekt lub funkcję, gdy wymagania są niejasne i zmiana obejmuje kilka modułów, zaczynając od specyfikacji.
  • 90spec-writer:specs-workflow
    Prowadzi przez odkrywanie wymagań, w którym historyjki wyłaniają się z rozumienia problemu, zamiast być z góry zapisane.
  • 90to-spec
    Zamienia bieżącą rozmowę w gotową do wdrożenia specyfikację lub zestaw specyfikacji, gdy użytkownik chce zapisać projekt jako SPEC.
  • 90status
    Pokazuje tablicę postępu specyfikacji z katalogu specs i wskazuje, co robić dalej, albo szczegółowy stan jednej specyfikacji.

Uwagi i zgłoszenia

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