Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

technical-spec

/technical-spec

Pisze dokumenty projektowe i RFC, które uzgadniają zespół przed kodem: TL;DR, cele i jawne nie-cele, wymagania, projekt end-to-end z trybami awarii, alternatywy, plan wdrożenia i otwarte pytania.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.10.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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 13.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 dokumenty projektowe i RFC, które uzgadniają zespół przed kodem: TL;DR, cele i jawne nie-cele, wymagania, projekt end-to-end z trybami awarii, alternatywy, plan wdrożenia i otwarte pytania.

Wyzwalacze z opisu

write a design doc for this featureturn my approach into an RFCreviewers keep asking why didn
Oryginalny opis (EN)

Writes engineering design docs and RFCs that align a team before code - TL;DR, background, goals and explicit non-goals, quantified requirements, a concrete end-to-end design with failure modes, alternatives considered, rollout plan, and open questions surfaced at the top for reviewers. Use when an engineer asks "write a design doc for this feature", "turn my approach into an RFC", "reviewers keep asking why didn't you just X", or a project needs alignment before implementation. Do NOT use for designing the API contract itself - use api-design instead; for user-facing product documentation, us

Jak działa

  1. Process
  2. Standard structure
  3. Writing rules
  4. Design section quality bar
  5. Non-goals discipline
  6. Anti-patterns
  7. Output
Sekcje z nagłówków SKILL.md, w oryginale · 56 linii, 460 słów
Podgląd SKILL.md
---
name: technical-spec
description: Writes engineering design docs and RFCs that align a team before code - TL;DR, background, goals and explicit non-goals, quantified requirements, a concrete end-to-end design with failure modes, alternatives considered, rollout plan, and open questions surfaced at the top for reviewers. Use when an engineer asks "write a design doc for this feature", "turn my approach into an RFC", "reviewers keep asking why didn't you just X", or a project needs alignment before implementation. Do NOT use for designing the API contract itself - use api-design instead; for user-facing product documentation, use help-documentation.
metadata:
  title: "Technical Spec Writer"
---

# Technical Spec Writer

You write engineering design documents (specs / RFCs) that align a team before code is written. A good spec surfaces disagreement early and makes the eventual implementation boring.

## Process

1. Gather: the problem, who's affected, constraints, the proposed approach, and what's explicitly out of scope.
2. Draft top-down: context first, then design.
3. Make the open questions prominent - a spec's value is often the questions it raises.

## Standard structure

1. **Title, author, status, date, reviewers.**
2. **Summary / TL;DR** - 3-5 sentences. What and why, readable by a non-expert.
3. **Background / context** - what exists today, why it's a problem, relevant history and links. Assume the reader hasn't been in your head.
4. **Goals** - what success looks like, ideally measurable.
5. **Non-goals** - what you are explicitly NOT solving. This section prevents scope creep and is the most-skipped, most-valuable part.
6. **Requirements / constraints** - functional and non-functional (latency, scale, security, compliance).
7. **Proposed design** - the meat. Data models, APIs, components, sequence of operations. Use diagrams (describe them if you can't draw). Explain how it works end to end.
8. **Alternatives considered** - other approaches and why you rejected them. Shows rigor and preempts "why didn't you just...".
9. **Trade-offs and risks** - what this design costs and what could go wrong.
10. **Rollout / migration plan** - how it ships, feature flags, backfills, rollback.
11. **Open questions** - unresolved decisions, flagged for reviewers.
12. **Appendix** - detailed schemas, benchmarks, references.

## Writing rules

- Lead with the decision, support with detail. Reviewers skim.
- Be concrete: real field names, real endpoints, real numbers. Vague specs hide the hard parts.
- State assumptions explicitly. Hidden assumptions cause the worst arguments.
- Prefer prose for reasoning, tables for comparisons, code blocks for interfaces.
- Quantify non-functional requirements: "p99 under 200ms at 10k RPS," not "fast."

## Design section quality bar

- A new engineer should be able to implement from it without a meeting.
- Every component's responsibility and interface is clear.
- Failure modes addressed: what happens on timeout, partial failure, retry, bad input.
- Backwards compatibility and data migration covered.

## Non-goals discipline

List 3-6 things readers might assume you're doing but aren't. Each prevents a future "but what about..." derailment.

## Anti-patterns

- Jumping to the solution with no problem statement.
- No alternatives - looks like you didn't think.
- Burying open questions at the bottom where reviewers miss them.
- Over-specifying trivial parts while hand-waving the risky core.

## Output

Deliver the spec with all sections. Where a diagram is needed, describe it precisely enough that someone could draw it. Surface the open questions at the top of your reply so reviewers engage with them first.

Wersje

RepozytoriumWynikLicencja
Ta strona · SkillMedev/skills90MIT
majiayu000/spellbook100MIT
shinpr/ai-coding-project-boilerplate100MIT
zph/dotfiles100MIT
shinpr/ai-coding-project-boilerplate86MIT
shinpr/ai-coding-project-boilerplate82MIT

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

  • 100design-docs
    Pisze i przegląda dokumenty projektowe RFC oraz ADR z celami, alternatywami, ryzykiem, bezpieczeństwem, wdrożeniem i obserwowalnością.
  • 90write-design-docs
    Pisze, poprawia i recenzuje dokumenty projektowe oprogramowania według zasad Malte Ubl z Design Docs at Google: kontekst, cele, nie-cele, kompromisy, alternatywy i kwestie przekrojowe.
  • 100rfc-writer
    Pisze dokumenty projektowe dla inżynierów: RFC, ADR, specyfikacje techniczne i design docy z kontekstem, problemem, propozycją, alternatywami, konsekwencjami i słowami kluczowymi RFC 2119.
  • 100writing-rfc
    Pisze RFC lub dokument projektowy z podsumowaniem na początku, celami, poza zakresem, alternatywami i otwartymi pytaniami.
  • 100technical-blueprint
    Pisze Technical Design Document (SDD) opisujący budowę funkcji lub komponentu: problem, projekt, model danych, kontrakty API, alternatywy, analiza zagrożeń, plan testów i rollbacku.
  • 100arch-design
    Prowadzi myślenie projektowe o systemie przed dokumentem lub kodem: cele i nie-cele, szacunki rzędu wielkości, komponenty i kontrakty, tryby awarii, operacyjność, bezpieczeństwo i kompromisy.

Uwagi i zgłoszenia

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