Największa biblioteka promptów systemowych: przegląd repozytorium i instrukcja użytkowania

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 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 ЗбільшитиIlościowy rozkład kategorii promptów w repozytorium — ilustracja 1

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