# Największa biblioteka promptów systemowych: przegląd repozytorium i instrukcja użytkowania > Pełny przegląd repozytorium claude-code-system-prompts: analiza ponad 500 instrukcji systemowych Claude Code, omówienie kategorii oraz personalizacja za pomocą tweakcc. Analiza wewnętrznych instrukcji współczesnych autonomicznych agentów to jeden z najskuteczniejszych sposobów na zrozumienie, jak zespoły inżynieryjne wiodących laboratoriów AI projektują niezawodne systemy. Otwarte repozytorium [claude-code-system-prompts](https://github.com/piebald-ai/claude-code-system-prompts) od zespołu Piebald stanowi najbardziej kompletną publiczną kolekcję aktualnych promptów systemowych Claude Code. Dokumentuje ono setki instrukcji wraz z dokładnym liczeniem tokenów oraz szczegółową historią zmian między wydaniami. --- ## 1. Czym jest repozytorium claude-code-system-prompts Repozytorium zawiera wyczerpujący rejestr wszystkich wewnętrznych dyrektyw oficjalnego agenta CLI Claude Code firmy Anthropic. ### 1.1. Pochodzenie i przeznaczenie repozytorium Piebald Projekt powstał w celu przejrzystej analizy ewolucji architektury Claude Code. W wersji Claude Code v2.1.234 baza liczy ponad 500 odrębnych promptów. Poza źródłowym tekstem instrukcji, repozytorium zawiera plik `CHANGELOG.md`, w którym skrupulatnie udokumentowano zmiany promptów w trakcie ponad 250 kolejnych wydań, począwszy od wersji v2.0.14. ### 1.2. Historia aktualizacji i pokrycie wersjonalne Skrypty synchronizacji uruchamiane są automatycznie w ciągu kilku minut po każdym opublikowaniu nowego pakietu npm Claude Code. Dzięki temu deweloperzy mają dostęp do aktualnych instrukcji w czasie rzeczywistym, zamiast polegać na przestarzałej dokumentacji czy zewnętrznych założeniach. Ostatnie znaczące rozszerzenie zwiększyło katalog promptów z 350 do 515 wpisów, zapewniając stuprocentowe pokrycie bazy kodu agenta. --- ## 2. Dlaczego Claude Code nie ma jednego promptu systemowego, a setki Powszechnym błędem początkujących jest wyobrażanie sobie interakcji z modelem językowym jako pojedynczego statycznego bloku instrukcji systemowych. ### 2.1. Modularna architektura zamiast monolitycznego promptu systemowego W rzeczywistym systemie produkcyjnym klasy Claude Code zachowanie agenta składa się z dynamicznej kompozycji wielu modułów: - **Warunkowe bloki środowiska:** instrukcje ładowane tylko przy obecności określonych ustawień konfiguracji lub systemu operacyjnego. - **Opisy narzędzi (Tool Descriptions):** głębokie specyfikacje funkcji (`Write`, `Bash`, `TodoWrite`), niektóre z nich zajmujące kilka tysięcy tokenów. - **Specjalizowane subagenty:** autonomiczne dyrektywy systemowe dla procesów pomocniczych, takich jak `Explore` czy `Plan`. ### 2.2. Warunkowe ładowanie i dynamiczna interpolacja System zawiera również dziesiątki usługowych funkcji AI: mechanizmy kompaktowania kontekstu (Context Compaction), generowanie plików `CLAUDE.md`, formułowanie nagłówków sesji oraz kontrolę granic bezpieczeństwa. Łącznie to setki linii kodu rozmieszczonych wewnątrz zoptymalizowanego bundla. --- ## 3. Jak zbudowane są prompty: struktura i kategorie Wszystkie wydobyte materiały zostały usystematyzowane według sześciu głównych kierunków zgodnie z ich rolą funkcjonalną. ### 3.1. Podział na 6 głównych kategorii Poniżej przedstawiono ilościowy rozkład promptów według kategorii w repozytorium: ![Ilościowy rozkład kategorii promptów w repozytorium — ilustracja 1](/api/guides-media/prompts/system-prompts-library-repo-overview/images/system-prompts-library-repo-overview-extra-01.webp) | Kategoria instrukcji | Liczba promptów | Przeznaczenie funkcjonalne | | :--- | :--- | :--- | | **Agent Prompts** | 67 | Specyfikacje subagentów, poleceń slash oraz autonomicznych monitorów działań | | **Data** | 121 | Dokumentacja referencyjna, katalogi modeli Claude oraz szablony artefaktów | | **System Prompt** | 143 | Podstawowe zasady zachowania, styl komunikacji i koordynacja sesji | | **System Reminders** | 81 | Sytuacyjne przypomnienia o aktywnych trybach i granicach zaufania | | **Builtin Tool Descriptions** | 176 | Instrukcje techniczne dotyczące wywoływania i parametrów wbudowanych narzędzi | | **Skills** | 87 | Kompleksowe wieloetapowe protokoły dla złożonych zadań inżynierskich | --- ## 4. Przegląd kluczowych kategorii: od agentów po przypomnienia systemowe Każda kategoria wykonuje ściśle określoną rolę w ogólnej ekosystemie agenta. ### 4.1. Agent Prompts — subagenci, polecenia slash i monitoring Kategoria obejmuje cztery grupy: autonomiczne subagenty, asystenci pracy z systemem plików, interaktywne polecenia slash oraz narzędzia usługowe. - **Agent Prompt: Explore (871 tks):** wyspecjalizowany prompt systemowy do nawigacji i szybkiego badania struktury nieznanych baz kodu. - **Agent Prompt: /security-review (2 521 tks):** kompleksowa instrukcja audytu zmian kodu z naciskiem na podatności możliwe do wykorzystania. - **Agent Prompt: Security monitor (25 798 tks):** największy prompt sekcji, definiujący reguły weryfikacji i blokowania potencjalnie niebezpiecznych operacji. ### 4.2. Data — dokumentacja referencyjna, katalogi modeli i szablony Zawiera statyczne informacje wbudowane w narzędzie, umożliwiające autonomiczną pracę bez stałych zapytań do zewnętrznych API: - **Claude model catalog (4 965 tks):** aktualny wykaz modeli Anthropic z ID, limitami kontekstowymi i cennikiem. - **Managed Agents core concepts (10 959 tks):** przewodnik po architekturze środowisk agentowych, sesjach i izolowanych kontenerach. - **Workshop artifact HTML template (49 202 tks):** pełnoprawny autonomiczny szablon HTML do renderowania interaktywnych artefaktów. ### 4.3. System Prompt — podstawowe instrukcje i orkiestracja koordynacji Fragmenty, z których składany jest pierwotny kontekst komunikacji modelu: - **Emoji avoidance (31 tks):** zwięzła instrukcja zakazująca używania emoji bez bezpośredniej prośby użytkownika. - **Harness instructions (329 tks):** definicja podstawowej tożsamości agenta, zasad wyjścia do terminala i uprawnień dostępu. - **Coordinator mode orchestration (5 757 tks):** reguły podziału zadań między kilkoma równoległymi agentami worker. ### 4.4. System Reminders — kontekstowe przypomnienia i granice bezpieczeństwa Dynamiczne wstawki dodawane do kontekstu podczas wykonywania specyficznych akcji: - **Plan mode is active (147 tks):** przypomnienie o zakazie edycji plików podczas aktywnego trybu planowania. - **External source trust boundary (108 tks):** ostrzeżenie, że dane z zewnętrznych pluginów mają zerowy poziom zaufania i wymagają sanitizacji. ### 4.5. Built-in Tool Descriptions — specyfikacje wbudowanych narzędzi Opisy wywołań narzędzi, które model interpretuje jako standardowe sygnatury tool: - **Tool Description: TodoWrite (2 037 tks):** instrukcja prowadzenia ustrukturyzowanych list zadań. - **Tool Description: Workflow (7 034 tks):** protokół deterministycznych scenariuszy orkiestracji. - **Tool Description: Bash (Git & PR guidelines) (2 450 tks):** standardy tworzenia atomowych commitów git i opisów pull request. --- ## 5. Wbudowane skills i specjalizowane workflow Skills stanowią zamknięte scenariusze eksperckie, zoptymalizowane pod kątem konkretnych zadań dewelopera. ### 5.1. Katalog wbudowanych skills Wśród najciekawszych przykładów: - **Skill: Design (20 955 tks):** zasady projektowania responsywnych artboardów Claude Design z edytowalnymi siatkami UI. - **Skill: Verify skill (4 354 tks):** sformalizowana checklista obowiązkowego testowania kodu przed ogłoszeniem zadania zakończonym. ### 5.2. Największe prompty pod względem liczby tokenów Absolutnym rekordzistą repozytorium jest **Skill: Model migration guide (64 306 tks)**. Ten gigantyczny poradnik krok po kroku zawiera pełne szablony refaktoryzacji przestarzałych wywołań API na nowe standardy rodziny Claude 3.5 i Claude 3.7. --- ## 6. Jak gwarantowana jest precyzja: ekstrakcja z kodu źródłowego Wiarygodność bazy promptów zapewniana jest przez pełną automatyzację procesów analitycznych. ### 6.1. Zautomatyzowana ekstrakcja z pakietu npm Wszystkie instrukcje są wydobywane przez skrypt dekompilacji bezpośrednio z dystrybucji npm (`@anthropic-ai/claude-code`). Eliminuje to czynnik ludzki lub subiektywne interpretacje — w repozytorium znajdują się dokładnie te linie kodu, które silnik wykonuje podczas Twojej sesji. ### 6.2. Błąd tokenizacji i zmienne dynamiczne Należy pamiętać, że niektóre prompty zawierają interpolowane zmienne szablonowe (nazwy zainstalowanych rozszerzeń, zmienne środowiskowe, dostępne ścieżki). Przez to faktyczna liczba tokenów w lokalnej sesji może różnić się w zakresie ±20 tokenów od wartości nominalnej. --- ## 7. Praktyczna personalizacja promptów za pomocą tweakcc Dla deweloperów chcących modyfikować domyślne zachowanie agenta, stworzono narzędzie `tweakcc`. ### 7.1. Możliwości i zasady działania tweakcc Narzędzie oferuje trzy kluczowe korzyści: 1. Pozwala opisywać własne modyfikacje promptów systemowych w postaci czytelnych plików Markdown. 2. Automatycznie patchuje binarne instalacje lub instalacje npm Claude Code na Twoim systemie. 3. Zawiera wbudowane narzędzia rozwiązywania konfliktów, gdy aktualizacja od Anthropic dotyka fragmentu, który samodzielnie edytowałeś. ### 7.2. Bezpieczne zarządzanie patchingiem i synchronizacja z wydaniami Anthropic Ponieważ `tweakcc` korzysta z tej samej mapy instrukcji co repozytorium `claude-code-system-prompts`, proces modyfikacji pozostaje w pełni deterministyczny i odwracalny po kolejnej aktualizacji CLI. --- ## 8. Najczęściej zadawane pytania (FAQ) ### 8.1. Odpowiedzi na typowe pytania dotyczące promptów systemowych > [!NOTE] > **Czy można używać promptów z repozytorium do własnych agentów?** > Tak. Struktura instrukcji dla subagentów, zasad bezpieczeństwa i opisów narzędzi (szczególnie dla `Bash` i `TodoWrite`) stanowi wzorcowy przykład do budowy własnych systemów agentowych opartych na LLM. > [!TIP] > **Jak znaleźć odpowiedni prompt w repozytorium?** > Skorzystaj z globalnego wyszukiwania po nazwie polecenia slash, narzędzia systemowego lub odwołaj się do tabeli kategorii w pliku `README`.