Найбільша бібліотека системних промптів: огляд репозиторію та як ним користуватися

Дослідження внутрішніх інструкцій сучасних автономних агентів — один із найефективніших способів зрозуміти, як інженерні команди провідних AI-лабораторій проектують надійні системи.

Відкритий репозиторій claude-code-system-prompts від команди Piebald є найповнішою публічною колекцією актуальних системних промптів Claude Code. У ньому задокументовано сотні інструкцій із точним підрахунком токенів та детальною історією змін між релізами.

1. Що таке репозиторій claude-code-system-prompts

Репозиторій містить вичерпний реєстр усіх внутрішніх директив офіційного CLI-агента Claude Code від Anthropic.

1.1. Походження та призначення репозиторію Piebald

Проєкт створено для прозорого аналізу еволюції архітектури Claude Code. Станом на версію Claude Code v2.1.234 база нараховує понад 500 окремих промптів.

Окрім вихідного тексту інструкцій, репозиторій містить файл CHANGELOG.md, у якому скрупульозно зафіксовано зміни промптів протягом більш ніж 250 послідовних релізів, починаючи з версії v2.0.14.

1.2. Історія оновлень та версійне покриття

Скрипти синхронізації запускаються автоматично протягом кількох хвилин після кожної публікації нового npm-пакета Claude Code. Завдяки цьому розробники отримують доступ до актуальних інструкцій у режимі реального часу, а не спираються на застарілу документацію чи сторонні припущення.

Останнє масштабне розширення збільшило каталог промптів із 350 до 515 записів, забезпечивши стовідсоткове покриття кодової бази агента.

2. Чому у Claude Code не один системний промпт, а сотні

Поширена помилка початківців — уявляти взаємодію з мовною моделлю як єдиний статичний блок системних інструкцій.

2.1. Модульна архітектура замість монолітного системного промпту

У реальній виробничій системі рівня Claude Code поведінка агента складається з динамічної композиції багатьох модулів:

• Умовні блоки середовища: інструкції, які підключаються лише за наявності певних налаштувань конфігурації або операційної системи.
• Описи інструментів (Tool Descriptions): глибокі специфікації функцій (Write, Bash, TodoWrite), деякі з яких займають кілька тисяч токенів.
• Спеціалізовані субагенти: автономні системні директиви для допоміжних процесів на кшталт Explore або Plan.

2.2. Умовне підключення та динамічна інтерполяція

Також система містить десятки службових AI-функцій: механізми стиснення контексту (Context Compaction), генерацію файлів CLAUDE.md, формулювання заголовків сесій та контроль меж безпеки. Загалом це сотні рядків коду, розподілених усередині оптимізованого бандла.

3. Як влаштовані промпти: структура та категорії

Усі витягнуті матеріали систематизовано за шістьма основними напрямами відповідно до їхньої функціональної ролі.

3.1. Розподіл за 6 основними категоріями

Нижче наведено кількісний розподіл промптів за категоріями в репозиторії:

Кількісний розподіл категорій промптів у репозиторії — ілюстрація 1 ЗбільшитиКількісний розподіл категорій промптів у репозиторії — ілюстрація 1

4. Огляд ключових категорій: від агентів до системних нагадувань

Кожна категорія виконує суворо окреслене завдання в загальній екосистемі агента.

4.1. Agent Prompts — субагенти, слеш-команди та моніторинг

Категорія охоплює чотири групи: автономні субагенти, помічники роботи з файловою системою, інтерактивні слеш-команди та службові утиліти.

• Agent Prompt: Explore (871 tks): спеціалізований системний промпт для навігації та швидкого дослідження структури незнайомих кодових баз.
• Agent Prompt: /security-review (2 521 tks): комплексна інструкція для аудиту змін коду з акцентом на вразливості, що піддаються експлуатації.
• Agent Prompt: Security monitor (25 798 tks): наймасштабніший промпт розділу, що задає правила верифікації та блокування потенційно небезпечних операцій.

4.2. Data — довідкова документація, каталоги моделей та шаблони

Містить статичну інформацію, зашиту в інструмент для автономної роботи без постійних запитів до зовнішніх API:

• Claude model catalog (4 965 tks): актуальний перелік моделей Anthropic з ID, контекстними лімітами та тарифікацією.
• Managed Agents core concepts (10 959 tks): посібник з архітектури агентних середовищ, сесій та ізольованих контейнерів.
• Workshop artifact HTML template (49 202 tks): повноцінний автономний HTML-шаблон для рендерингу інтерактивних артефактів.

4.3. System Prompt — базові інструкції та орхестрація координування

Фрагменти, з яких збирається первинний контекст спілкування моделі:

• Emoji avoidance (31 tks): лаконічна інструкція, яка забороняє використання емодзі без прямого прохання користувача.
• Harness instructions (329 tks): визначення базової ідентичності агента, правил виводу в термінал та прав доступу.
• Coordinator mode orchestration (5 757 tks): правила розподілу завдань між кількома паралельними воркер-агентами.

4.4. System Reminders — контекстні нагадування та межі безпеки

Динамічні вставки, які додаються в контекст під час виконання специфічних дій:

• Plan mode is active (147 tks): нагадування про заборону редагування файлів під час активного режиму планування.
• External source trust boundary (108 tks): попередження про те, що дані зі сторонніх плагінів мають нульовий рівень довіри й потребують санітизації.

4.5. Built-in Tool Descriptions — специфікації вбудованих інструментів

Описи виклику утиліт, які модель сприймає як стандартні сигнатури інструментів:

• Tool Description: TodoWrite (2 037 tks): інструкція з ведення структурованих списків завдань.
• Tool Description: Workflow (7 034 tks): протокол детермінованих оркестраційних сценаріїв.
• Tool Description: Bash (Git & PR guidelines) (2 450 tks): стандарти створення атомарних git-комітів та опису pull request.

5. Вбудовані скіли та спеціалізовані воркфлоу

Скіли (Skills) представляють собою закінчені експертні сценарії, оптимізовані під конкретні завдання розробника.

5.1. Каталог вбудованих скілів (Skills)

Серед найцікавіших прикладів:

• Skill: Design (20 955 tks): правила проектування адаптивних артбордів Claude Design із редагованими інтерфейсними сітками.
• Skill: Verify skill (4 354 tks): формалізований чеклист для обов'язкового тестування коду перед оголошенням завдання виконаним.

5.2. Найбільші промпти за обсягом токенів

Абсолютним рекордсменом репозиторію є Skill: Model migration guide (64 306 tks). Цей гігантський покроковий посібник містить повні шаблони рефакторингу застарілих викликів API на нові стандарти сімейства Claude 3.5 та Claude 3.7.

6. Як гарантується точність: витяг із вихідного коду

Достовірність бази промптів забезпечується повною автоматизацією процесів аналізу.

6.1. Автоматизований витяг з npm-пакета

Усі інструкції витягуються скриптом декомпіляції безпосередньо з дистрибутиву npm (@anthropic-ai/claude-code). Це унеможливлює людський фактор або суб'єктивні трактування — в репозиторії розміщено саме ті рядки коду, які виконує рушій під час вашої сесії.

6.2. Похибка токенізації та динамічні змінні

Слід враховувати, що деякі промпти містять інтерпольовані шаблонні змінні (назви встановлених розширень, змінні оточення, доступні шляхи). Через це фактична кількість токенів у вашій локальній сесії може варіюватися в діапазоні ±20 токенів від паспортного значення.

7. Практична кастомізація промптів за допомогою tweakcc

Для розробників, які бажають модифікувати стандартну поведінку агента, створено утиліту tweakcc.

7.1. Можливості та принципи роботи tweakcc

Утиліта надає три ключові переваги:

1. Дозволяє описувати власні модифікації системних промптів у вигляді зрозумілих Markdown-файлів.
2. Автоматично патчить бінарні або npm-установки Claude Code на вашій системі.
3. Містить вбудовані інструменти розв'язання конфліктів, коли оновлення від Anthropic зачіпає відредагований вами фрагмент.

7.2. Безпечне патчинг-керування та синхронізація з релізами Anthropic

Оскільки tweakcc використовує ту саму карту інструкцій, що й репозиторій claude-code-system-prompts, процес модифікації залишається повністю детермінованим і відновлюваним після чергового апдейту CLI.

8. Поширені запитання (FAQ)

8.1. Відповіді на типові питання щодо системних промптів