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

## Что создано

Полный навык Claude для **промпт-инжиниринга** с глубокими знаниями о:
- лучших практиках написания промптов;
- проектировании пользовательских инструкций;
- оптимизации и доработке промптов;
- продвинутых методах (CoT, few-shot, теги XML и другие);
- подходах к оценке и тестированию;
- распознавании антипаттернов;
- мультимодальных запросах.

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

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

## Основные файлы

### 1. **SKILL.md** (обзор)
- Описание в общих чертах.
- Ключевые возможности.
- Сценарии использования.
- Ограничения.

### 2. **CLAUDE.md** (основные инструкции)
- Основные области знаний (7 областей).
- Ключевые возможности (8).
- Сценарии использования (9).
- Ограничения навыка.
- Замечания по интеграции.

### 3. **README.md** (руководство пользователя)
- Обзор и состав навыка.
- Как им пользоваться.
- Структура навыка.
- Ключевые понятия.
- Частые сценарии.
- Краткая сводка лучших практик.
- Руководство для первого запуска.

### 4. **docs/BEST_PRACTICES.md** (лучшие практики)
- Основные принципы: ясность, краткость, степень свободы.
- Продвинутые методы: CoT, few-shot, XML, роли, предзаполнение, цепочки.
- Проектирование пользовательских инструкций.
- Лучшие практики структуры навыка.
- Оценка и тестирование.
- Антипаттерны, которых следует избегать.
- Рабочие процессы и циклы обратной связи.
- Правила содержания.
- Мультимодальные промпты.
- Процесс разработки.
- Полный контрольный список.

### 5. **docs/TECHNIQUES.md** (продвинутые методы)
- Промпты с пошаговым рассуждением и примеры.
- Обучение на нескольких примерах: один, два и больше.
- Структурированный вывод с тегами XML.
- Промпты с ролью.
- Предзаполнение ответов.
- Цепочки промптов.
- Управление контекстом.
- Мультимодальные запросы.
- Сочетание методов.
- Антипаттерны.

### 6. **docs/TROUBLESHOOTING.md** (решение проблем)
- 8 частых проблем с решениями:
  1. Нестабильные результаты.
  2. Выдуманные сведения.
  3. Расплывчатые ответы.
  4. Неподходящая длина.
  5. Неверный формат.
  6. Отказ отвечать.
  7. Слишком длинный промпт.
  8. Плохое обобщение на новые задачи.
- Порядок отладки.
- Справочная таблица.
- Контрольный список тестирования.

### 7. **examples/EXAMPLES.md** (примеры из практики)
- 10 практических примеров:
  1. Уточнение расплывчатых промптов.
  2. Пользовательские инструкции агентам.
  3. Классификация по нескольким примерам.
  4. Анализ с пошаговым рассуждением.
  5. Промпты, структурированные XML.
  6. Итеративная доработка.
  7. Распознавание антипаттернов.
  8. Система тестирования.
  9. Шаблон метаданных навыка.
  10. Контрольный список оптимизации.

## Основные области экспертизы

1. **Лучшие практики написания промптов**
   - Ясность и прямота.
   - Структура и оформление.
   - Конкретность.
   - Работа с контекстом.
   - Тон и стиль.

2. **Продвинутые приёмы промпт-инжиниринга**
   - Промпты с пошаговым рассуждением (CoT).
   - Промпты с несколькими примерами (few-shot).
   - Теги XML.
   - Промпты с ролью.
   - Предзаполнение.
   - Цепочки промптов.

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

4. **Оптимизация и доработка промптов**
   - Анализ эффективности.
   - Итеративное улучшение.
   - A/B-тестирование.
   - Повышение стабильности.
   - Оптимизация токенов.

5. **Антипаттерны и частые ошибки**
   - Расплывчатость.
   - Противоречия.
   - Чрезмерная детализация.
   - Риск выдумок.
   - Утечка контекста.
   - Уязвимость к обходу инструкций.

6. **Оценка и тестирование**
   - Определение критериев успеха.
   - Разработка тестовых случаев.
   - Анализ неудач.
   - Регрессионное тестирование.
   - Обработка пограничных случаев.

7. **Мультимодальные и продвинутые запросы**
   - Промпты для зрения.
   - Промпты с файлами.
   - Интеграция эмбеддингов.
   - Промпты для инструментов.
   - Расширенное размышление.

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

1. **Анализ промптов** — проверка и улучшение существующих запросов.
2. **Создание промптов** — написание новых запросов с нуля.
3. **Доработка промптов** — последовательные улучшения.
4. **Проектирование пользовательских инструкций** — специальные инструкции.
5. **Советы по лучшим практикам** — обучение принципам промпт-инжиниринга.
6. **Распознавание антипаттернов** — поиск и исправление ошибок.
7. **Стратегия тестирования** — подходы к оценке.
8. **Документация** — ясные инструкции по использованию.

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

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

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

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

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

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

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

## Включённые лучшие практики

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

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

## Качество документации

- **Полнота:** охвачены все основные стороны промпт-инжиниринга.
- **Практичность:** примеры и шаблоны из реальной работы.
- **Удобная структура:** ясная организация с постепенным раскрытием деталей.
- **Применимость:** конкретные советы с пошаговыми инструкциями.
- **Проверенность:** основано на официальной документации Anthropic.
- **Повторное использование:** шаблоны и списки для частых задач.

## Точки интеграции

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

## Следующие шаги

1. **Загрузи навык** в Claude через Skills API или Claude Code.
2. **Проверь на примерах промптов**, что он работает.
3. **Доработай по обратной связи**.
4. **Поделись с командой** для совместной работы над промптами.
5. **Расширяй по необходимости** примерами из своей области.