Крупнейшая библиотека системных промптов: обзор репозитория и как им пользоваться

Изучение внутренних инструкций современных автономных агентов — один из лучших способов понять, как ведущие 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. Модульная архитектура вместо монолитного системного промпта

В промышленной агентной системе поведение складывается из динамической композиции множества модулей:

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

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

Система также содержит десятки служебных микро-промптов: алгоритмы сжатия контекста (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 — справочная документация, каталоги моделей и шаблоны

Статическая информация, внедренная непосредственно в CLI для автономной работы:

• 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). Это масштабное пошаговое руководство по адаптации кодовой базы к новым возможностям моделей Claude 3.5 и 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. Содержит встроенные средства разрешения конфликтов при выходе официальных обновлений.

7.2. Безопасное применение патчей и синхронизация с релизами Anthropic

Благодаря использованию единой карты инструкций из claude-code-system-prompts, процесс кастомизации остается стабильным и легко воспроизводимым после каждого апдейта CLI.

8. Часто задаваемые вопросы (FAQ)

8.1. Практические ответы на ключевые вопросы