# README — навык эксперта по промпт-инжинирингу

## Обзор

Навык **Эксперт по промпт-инжинирингу** даёт Claude глубокие знания о промптах, проектировании пользовательских инструкций и их оптимизации. Это подробное руководство по созданию действенных промптов для ИИ, инструкций агентам и последовательному улучшению результатов.

## Что даёт навык

### Основные области знаний
- **Лучшие практики написания промптов:** ясные и прямые запросы с правильной структурой.
- **Продвинутые методы:** пошаговое рассуждение, few-shot, теги XML, промпты с ролью.
- **Пользовательские инструкции:** проектирование системных промптов и инструкций агентам.
- **Оптимизация:** анализ и доработка существующих запросов.
- **Оценка:** подходы к тестированию и критерии успеха.
- **Антипаттерны:** обнаружение и исправление частых ошибок.
- **Мультимодальность:** изображения, эмбеддинги и промпты с файлами.

### Ключевые возможности

1. **Анализ промптов**
   - Проверять существующие промпты.
   - Находить возможности для улучшения.
   - Замечать антипаттерны и проблемы.
   - Предлагать конкретные доработки.

2. **Создание промптов**
   - Писать новые промпты с нуля.
   - Проектировать их под конкретные задачи.
   - Обеспечивать ясность и действенность.
   - Повышать стабильность результатов.

3. **Пользовательские инструкции**
   - Проектировать системные промпты.
   - Создавать инструкции агентам.
   - Определять правила поведения.
   - Устанавливать уместные ограничения.

4. **Советы по лучшим практикам**
   - Объяснять принципы промпт-инжиниринга.
   - Обучать продвинутым методам.
   - Делиться примерами из практики.
   - Помогать внедрять подходы.

5. **Тестирование и проверка**
   - Разрабатывать тестовые случаи.
   - Определять критерии успеха.
   - Оценивать результаты промптов.
   - Находить пограничные случаи.

## Как пользоваться навыком

### Для анализа промпта
```
«Проверь этот промпт и предложи улучшения:
[ВАШ ПРОМПТ]

Обрати внимание на ясность, конкретность, формат и стабильность».
```

### Для создания промпта
```
«Создай промпт, который:
- [Требование 1]
- [Требование 2]
- [Требование 3]

Он должен обрабатывать [сценарии использования]».
```

### Для пользовательских инструкций
```
«Разработай пользовательские инструкции для агента:
- [Роль и экспертиза]
- [Основные обязанности]
- [Правила поведения]».
```

### Для устранения проблем
```
«Этот промпт работает плохо:
[ПРОМПТ]

Проблемы: [ОПИШИТЕ ПРОБЛЕМЫ]

Как его исправить?»
```

## Структура навыка

```
prompt-engineering-expert/
├── SKILL.md                 # Метаданные навыка
├── CLAUDE.md               # Основные инструкции
├── README.md               # Этот файл
├── docs/
│   ├── BEST_PRACTICES.md   # Руководство по лучшим практикам
│   ├── TECHNIQUES.md       # Продвинутые методы
│   └── TROUBLESHOOTING.md  # Частые проблемы и решения
└── examples/
    └── EXAMPLES.md         # Примеры из практики
```

## Ключевые понятия

### Ясность
- Явные цели.
- Точные формулировки.
- Конкретные примеры.
- Логичная структура.

### Краткость
- Текст по делу.
- Без повторов.
- Постепенное раскрытие деталей.
- Разумное использование токенов.

### Стабильность
- Определённые ограничения.
- Заданный формат.
- Понятные правила.
- Воспроизводимые результаты.

### Полнота
- Достаточный контекст.
- Обработка пограничных случаев.
- Критерии успеха.
- Обработка ошибок.

## Частые сценарии

### 1. Уточнение расплывчатых промптов
Преобразуй неясные запросы в конкретные, применимые инструкции.

### 2. Создание специальных промптов
Проектируй запросы под определённые области и задачи.

### 3. Разработка инструкций агентам
Создавай пользовательские инструкции для ИИ-агентов и навыков.

### 4. Повышение стабильности
Улучшай надёжность и уменьшай разброс ответов.

### 5. Отладка промптов
Находи и исправляй проблемы существующих запросов.

### 6. Обучение лучшим практикам
Изучай принципы и методы промпт-инжиниринга.

### 7. Построение подхода к оценке
Разрабатывай тестовые случаи и критерии успеха.

### 8. Мультимодальные промпты
Создавай запросы для изображений, эмбеддингов и файлов.

## Лучшие практики вкратце

### Делай ✅
- Формулируй ясно и конкретно.
- Давай примеры.
- Задавай формат.
- Определяй ограничения.
- Тщательно проверяй.
- Документируй допущения.
- Раскрывай детали постепенно.
- Обрабатывай пограничные случаи.

### Не делай ❌
- Не выражайся расплывчато или двусмысленно.
- Не считай, что тебя уже поняли.
- Не пропускай требования к формату.
- Не игнорируй пограничные случаи.
- Не перегружай ограничения.
- Не употребляй жаргон без объяснения.
- Не зашивай значения в код.
- Не игнорируй обработку ошибок.

## Продвинутые темы

### Промпты с пошаговым рассуждением
Побуждай модель рассуждать последовательно при сложных задачах.

### Обучение на нескольких примерах
Направляй поведение примерами без явных инструкций.

### Структурированный вывод
Используй теги XML для ясности и разбора.

### Промпты с ролью
Назначай область экспертизы, которая направляет ответ.

### Цепочки промптов
Разбивай сложную задачу на последовательные запросы.

### Работа с контекстом
Оптимизируй расход токенов и ясность.

### Мультимодальная интеграция
Работай с изображениями, файлами и эмбеддингами.

## Ограничения

- **Только анализ:** навык не выполняет код и не запускает промпты.
- **Нет данных в реальном времени:** он не обращается к внешним API или текущим данным.
- **Основа — лучшие практики:** рекомендации опираются на известные паттерны.
- **Нужна проверка:** советы надо проверять на реальных задачах.
- **Нужно человеческое суждение:** в критических задачах навык не заменяет специалиста.

## Интеграция с другими навыками

Хорошо сочетается с:
- **Claude Code:** для тестирования и доработки промптов;
- **Agent SDK:** для реализации пользовательских инструкций;
- **Files API:** для анализа документации промптов;
- **Vision:** для мультимодальных промптов;
- **Extended Thinking:** для сложных рассуждений.

## Первый запуск

### Быстрый старт
1. Поделись промптом или опиши задачу.
2. Получи анализ и рекомендации.
3. Внеси предложенные улучшения.
4. Проверь результат.
5. Повтори при необходимости.

### Для начинающих
- Начни с `BEST_PRACTICES.md`.
- Посмотри примеры в `EXAMPLES.md`.
- Сначала попробуй простые промпты.
- Постепенно повышай сложность.

### Для опытных
- Изучи продвинутые методы в `TECHNIQUES.md`.
- Проверь пограничные случаи в `TROUBLESHOOTING.md`.
- Сочетай несколько методов.
- Разрабатывай собственные подходы.

## Документация

### Основные документы
- **BEST_PRACTICES.md:** полное руководство по лучшим практикам.
- **TECHNIQUES.md:** продвинутые методы промпт-инжиниринга.
- **TROUBLESHOOTING.md:** частые проблемы и решения.
- **EXAMPLES.md:** примеры и шаблоны из практики.

### Быстрые справки
- Правила именования.
- Структура файлов.
- Frontmatter YAML.
- Бюджеты токенов.
- Контрольные списки.

## Помощь и ресурсы

### Внутри навыка
- Подробная документация.
- Примеры из практики.
- Руководства по решению проблем.
- Контрольные списки лучших практик.
- Справочные таблицы.

### Внешние ресурсы
- Документация Claude: https://docs.claude.com
- Блог Anthropic: https://www.anthropic.com/blog
- Claude Cookbooks: https://github.com/anthropics/claude-cookbooks
- Руководство по промпт-инжинирингу: https://www.promptingguide.ai

## История версий

### v1.0 (текущая)
- Первый выпуск.
- Основные области знаний.
- Документация лучших практик.
- Руководство по продвинутым методам.
- Руководство по устранению проблем.
- Примеры из практики.

## Участие в разработке

Навык будет развиваться. Отзывы и предложения по улучшению приветствуются.

## Лицензия

Навык предоставляется как часть экосистемы Claude.

---

## Быстрые ссылки

- [Руководство по лучшим практикам](docs/BEST_PRACTICES.md)
- [Продвинутые методы](docs/TECHNIQUES.md)
- [Руководство по устранению проблем](docs/TROUBLESHOOTING.md)
- [Примеры и шаблоны](examples/EXAMPLES.md)

---

**Готов улучшить свои промпты?** Поделись текущим запросом или опиши, в чём нужна помощь.