Szablony promptów

Szablony promptów

Przestań wpisywać te same prompty wielokrotnie. Zbuduj systematyczną bibliotekę szablonów promptów wielokrotnego użytku, które zapewniają spójne, wysokiej jakości odpowiedzi AI oszczędzając godziny czasu wpisywania.

Dlaczego szablony promptów mają znaczenie

Bez szablonów developerzy często:

• Wpisują podobne prompty 10-20 razy dziennie
• Otrzymują niespójne odpowiedzi AI
• Zapominają o ważnym kontekście lub ograniczeniach
• Marnują energię mentalną na tworzenie promptów

Z szablonami:

• Oszczędzasz 20-30 minut dziennie na pisaniu promptów
• Otrzymujesz 40% lepsze odpowiedzi AI przez optymalizowane prompty
• Utrzymujesz spójność w całym zespole
• Skupiasz się na rozwiązywaniu problemów, nie na inżynierii promptów

Kategorie szablonów

Generowanie kodu

Szablony do tworzenia nowych komponentów kodu

Debugowanie

Systematyczne wzorce promptów debugowania

Refaktoryzacja

Spójne instrukcje refaktoryzacji

Dokumentacja

Szablony do różnych potrzeb dokumentacji

Testowanie

Prompty generowania i ulepszania testów

Recenzje

Szablony recenzji i analizy kodu

Podstawowe szablony promptów

1. Szablon implementacji funkcji

## Funkcja: [NAZWA_FUNKCJI]

### Kontekst
- Aktualny plik: [ŚCIEŻKA_PLIKU]
- Powiązane pliki: [POWIĄZANE_PLIKI]
- Referencja projektowa: [LINK_FIGMA/SPEC]

### Wymagania
1. [WYMAGANIE_1]
2. [WYMAGANIE_2]
3. [WYMAGANIE_3]

### Ograniczenia
- Musi zachować kompatybilność wsteczną
- Przestrzegaj istniejących wzorców w [PRZYKŁADOWY_PLIK]
- Dołącz odpowiednią obsługę błędów
- Dodaj wyczerpujące komentarze JSDoc

### Podejście implementacji
Proszę zaimplementuj tę funkcję używając [WZORZEC/ARCHITEKTURA]

Przykład użycia:

## Funkcja: Modal uwierzytelniania użytkownika

### Kontekst
- Aktualny plik: components/Layout.tsx
- Powiązane pliki: lib/auth.ts, components/Button.tsx
- Referencja projektowa: @figma authentication-flow

### Wymagania
1. Modal z polami email/hasło
2. Przyciski logowania społecznościowego (Google, GitHub)
3. Checkbox "Zapamiętaj mnie"
4. Link "Zapomniałem hasła"

### Ograniczenia
- Musi zachować kompatybilność wsteczną
- Przestrzegaj istniejących wzorców w components/Modal.tsx
- Dołącz odpowiednią obsługę błędów
- Dodaj wyczerpujące komentarze JSDoc

### Podejście implementacji
Proszę zaimplementuj tę funkcję używając naszego istniejącego wzorca komponentu Modal

2. Szablon badania debugowania

## Badanie błędu: [OPIS_PROBLEMU]

### Symptomy
- Komunikat błędu: [KOMUNIKAT_BŁĘDU]
- Kiedy występuje: [WARUNKI_WYWOŁANIA]
- Dotknięci użytkownicy: [SEGMENT_UŻYTKOWNIKÓW]

### Aktualne zachowanie
[OPISZ_AKTUALNE]

### Oczekiwane zachowanie
[OPISZ_OCZEKIWANE]

### Kroki badania
1. Dodaj strategiczne console.log do śledzenia przepływu wykonania
2. Sprawdź [CZĘSTA_PRZYCZYNA_1]
3. Zweryfikuj [ZAŁOŻENIE_1]
4. Uruchom testy i zgłoś ustalenia

### Pliki kontekstu
@file [ODPOWIEDNI_PLIK_1]
@file [ODPOWIEDNI_PLIK_2]

3. Szablon refaktoryzacji

## Refaktoryzacja: [NAZWA_KOMPONENTU/FUNKCJI]

### Cel
[KONKRETNY_CEL_REFAKTORYZACJI]

### Obecne problemy
1. [PROBLEM_1]
2. [PROBLEM_2]

### Docelowa architektura
- Wzorzec: [WZORZEC_PROJEKTOWY]
- Zależności: [NOWE_DEPS]
- Zmiany łamiące: [TAK/NIE]

### Wymagania zachowania
- Wszystkie istniejące testy muszą przechodzić
- Publiczne API pozostaje niezmienione
- Wydajność nie może się pogorszyć

### Podejście krok po kroku
1. [KROK_1]
2. [KROK_2]
3. Uruchom testy po każdym kroku

4. Szablon generowania testów

## Generuj testy: [KOMPONENT/FUNKCJA]

### Framework testowy
- Framework: [Jest/Vitest/etc]
- Styl: [bloki describe/it]
- Cel pokrycia: [80%+]

### Potrzebne kategorie testów
- [ ] Scenariusze szczęśliwych ścieżek
- [ ] Przypadki brzegowe
- [ ] Warunki błędów
- [ ] Granice wydajności
- [ ] Punkty integracji

### Konkretne scenariusze
1. [SCENARIUSZ_1]
2. [SCENARIUSZ_2]

### Wymagania mockowania
- Zewnętrzne API: [LISTA_API]
- Wywołania bazy danych: [OPERACJE_DB]
- Operacje zależne od czasu

Dołącz opisowe nazwy testów i wyczerpujące asercje

Zaawansowane wzorce szablonów

Szablony warunkowe

Użyj sekcji warunkowych opartych na kontekście:

## Implementuj: [FUNKCJA]

### Wymagania podstawowe
[ZAWSZE_DOŁĄCZ]

{{IF_FRONTEND}}
### Wymagania UI
- Responsywny projekt
- Dostępność (WCAG 2.1 AA)
- Status ładowania
- Status błędów
{{/IF_FRONTEND}}

{{IF_BACKEND}}
### Wymagania API
- Endpointy RESTful
- Walidacja danych wejściowych
- Ograniczanie szybkości
- Odpowiednie kody statusu
{{/IF_BACKEND}}

{{IF_DATABASE}}
### Uwagi dotyczące bazy danych
- Skrypt migracji
- Indeksy dla wydajności
- Ograniczenia integralności danych
{{/IF_DATABASE}}

Szablony łańcuchowe

Połącz szablony dla złożonych przepływów pracy:

## Przepływ pracy: Dodaj nową funkcję

### Krok 1: Planowanie
[Użyj SZABLON_PLANOWANIA]

### Krok 2: Implementacja
[Użyj SZABLON_FUNKCJI z kontekstem z Kroku 1]

### Krok 3: Testowanie
[Użyj SZABLON_TESTÓW z implementacją z Kroku 2]

### Krok 4: Dokumentacja
[Użyj SZABLON_DOKUMENTACJI ze wszystkim poprzednim kontekstem]

Szablony specyficzne dla technologii

React/Next.js

## Utwórz komponent React: [NAZWA_KOMPONENTU]

### Typ
- [ ] Komponent funkcyjny
- [ ] Komponent serwerowy (Next.js 13+)
- [ ] Komponent kliencki z 'use client'

### Funkcje
- [ ] Interfejs props TypeScript
- [ ] Optymalizacja Memo
- [ ] Granica błędów
- [ ] Stan ładowania
- [ ] Historia Storybook

### Potrzebne hooki
- [ ] useState dla: [OPIS_STANU]
- [ ] useEffect dla: [CEL_EFEKTU]
- [ ] Hooki niestandardowe: [NAZWY_HOOKÓW]

### Wydajność
- [ ] Implementuj React.memo jeśli czyste
- [ ] Użyj useCallback dla handlerów
- [ ] Ładuj leniwie jeśli ciężkie

Node.js/Express

## Utwórz endpoint API: [ŚCIEŻKA_ENDPOINTU]

### Metoda HTTP: [GET/POST/PUT/DELETE]

### Żądanie
- Nagłówki: [WYMAGANE_NAGŁÓWKI]
- Schemat body: [SCHEMAT_JSON]
- Parametry query: [LISTA_PARAM]

### Walidacja
- [ ] Sanityzacja danych wejściowych
- [ ] Sprawdzanie typów
- [ ] Walidacja reguł biznesowych

### Odpowiedź
- Sukces (200): [SCHEMAT_ODPOWIEDZI]
- Przypadki błędów: [SCENARIUSZE_BŁĘDÓW]

### Middleware
- [ ] Wymagane uwierzytelnianie
- [ ] Ograniczanie szybkości
- [ ] Logowanie żądań

Python

## Utwórz moduł Python: [NAZWA_MODUŁU]

### Cel
[OPIS_MODUŁU]

### Zależności
- Biblioteka standardowa: [IMPORTY]
- Pakiety zewnętrzne: [WYMAGANIA]

### Klasy/Funkcje
- Główna klasa: [NAZWA_KLASY]
- Metody publiczne: [LISTA_METOD]
- Podpowiedzi typów: Wymagane

### Testowanie
- [ ] Testy jednostkowe z pytest
- [ ] Sprawdzanie typów z mypy
- [ ] Docstringi (styl Google)

### Obsługa błędów
- Niestandardowe wyjątki: [NAZWY_WYJĄTKÓW]
- Poziom logowania: [INFO/DEBUG/ERROR]

Tworzenie niestandardowych szablonów

Krok 1: Identyfikuj wzorce

Śledź swoje prompty przez jeden tydzień:

• Co pytasz wielokrotnie?
• Jaki kontekst zawsze dołączasz?
• Jakie ograniczenia często zapominasz?

Krok 2: Wyciągnij strukturę szablonu

## Nazwa szablonu: [OPISOWA_NAZWA]

### Zawsze dołącz
- [STAŁY_ELEMENT_1]
- [STAŁY_ELEMENT_2]

### Zmienne
- [ZMIENNA_1]: [OPIS]
- [ZMIENNA_2]: [OPIS]

### Sekcje opcjonalne
- [WARUNEK]: [OPCJONALNA_TREŚĆ]

Krok 3: Testuj i udoskonalaj

1. Użyj szablonu 5 razy
2. Zanotuj brakujące elementy
3. Usuń niepotrzebne części
4. Dostosuj dla optymalnej odpowiedzi AI

Krok 4: Udostępnij zespołowi

Przechowuj szablony w:

• Katalogu .cursor/prompts/
• Wiki/dokumentacji zespołu
• Regułach Cursora do auto-dołączania

System zarządzania szablonami

Struktura katalogów

.cursor/
├── prompts/
│   ├── feature/
│   │   ├── component.md
│   │   ├── api-endpoint.md
│   │   └── database-migration.md
│   ├── debug/
│   │   ├── performance.md
│   │   ├── memory-leak.md
│   │   └── integration-failure.md
│   ├── refactor/
│   │   ├── extract-function.md
│   │   ├── design-pattern.md
│   │   └── performance-optimize.md
│   └── team/
│       ├── code-review.md
│       ├── onboarding.md
│       └── documentation.md

Metody szybkiego dostępu

1. Integracja z fragmentami kodu VS Code

{
  "Cursor Feature Template": {
    "prefix": "cursor-feature",
    "body": [
      "## Funkcja: ${1:NazwaFunkcji}",
      "",
      "### Kontekst",
      "- Aktualny plik: ${TM_FILEPATH}",
      "- Powiązane pliki: ${2:pliki}",
      "",
      "### Wymagania",
      "1. ${3:wymaganie}",
      "",
      "### Ograniczenia",
      "- ${4:ograniczenie}"
    ]
  }
}

2. Integracja z regułami Cursora

.cursor/rules/templates.md

Przy implementacji nowych funkcji zawsze strukturyzuj żądanie używając naszego formatu szablonu funkcji z sekcjami Kontekst, Wymagania i Ograniczenia.

Mierzenie skuteczności szablonów

Śledź te metryki:

Metryka	Przed szablonami	Z szablonami	Poprawa
Czas pisania promptu	5 min/prompt	30 sek/prompt	90% szybciej
Jakość odpowiedzi AI	Zmienna	Spójna	40% lepsza
Potrzebne przeróbki	Często	Rzadko	75% mniej
Spójność zespołu	Niska	Wysoka	3x lepsza

Częste błędy szablonów

Uwaga

Unikaj tych pułapek:

1. Nad-szablonowanie - Nie wszystko potrzebuje szablonu
2. Sztywne szablony - Pozwól na elastyczność dla unikalnych przypadków
3. Przestarzałe szablony - Regularnie przeglądaj i aktualizuj
4. Brak zmiennych - Szablony powinny być adaptowalne
5. Brakujący kontekst - Dołącz wystarczająco informacji tła

Wskazówki pro

1. Zacznij prosto - Rozpocznij z 3-5 podstawowymi szablonami
2. Iteruj często - Udoskonalaj na podstawie odpowiedzi AI
3. Kontrola wersji - Śledź zmiany szablonów w git
4. Warsztaty zespołowe - Buduj szablony razem
5. Automatyzuj użycie - Integruj ze skrótami/fragmentami

Następne kroki

Z ustanowioną biblioteką szablonów promptów:

• Eksploruj Wzorce kontekstu aby optymalizować informacje dostarczane AI
• Naucz się Przepływów debugowania które wykorzystują szablony
• Opanuj Wzorce testowania do wyczerpującego generowania testów

Pamiętaj: Świetne szablony to żywe dokumenty. Aktualizuj je w miarę uczenia się, co produkuje najlepsze odpowiedzi AI dla twoich konkretnych potrzeb.