spec
/spec
Prowadzi interaktywne odkrywanie wymagań i zapisuje pliki specyfikacji, gdy użytkownik prosi o spisanie specyfikacji.
- Autor
- codagent-ai ↗
- Repozytorium
- agent-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 1
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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
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
- Process
- OpenSpec format
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · codagent-ai/agent-skills | 100 | MIT |
| renzrollon/interlock | 100 | MIT |
| CodaColaLight/nightmill | 100 | Apache-2.0 |
| duronext/jig | 100 | MIT |
| optiflowic/keyturn | 100 | MIT |
| rjmurillo/ai-agents | 100 | MIT |
| rjmurillo/ai-agents | 100 | MIT |
| rjmurillo/ai-agents | 100 | MIT |
| flavien-ia/hypervibe-craft | 100 | Apache-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.