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

## 📋 Быстрая навигация

### Первый запуск
- **[README.md](README.md)** — начни здесь: обзор, использование и быстрый старт.
- **[SUMMARY.md](SUMMARY.md)** — что создано и как этим пользоваться.

### Основные файлы навыка
- **[SKILL.md](SKILL.md)** — метаданные и обзор возможностей.
- **[CLAUDE.md](CLAUDE.md)** — основные инструкции и области экспертизы.

### Документация
- **[docs/BEST_PRACTICES.md](docs/BEST_PRACTICES.md)** — полное руководство по лучшим практикам.
- **[docs/TECHNIQUES.md](docs/TECHNIQUES.md)** — продвинутые методы промпт-инжиниринга.
- **[docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)** — частые проблемы и решения.

### Примеры и шаблоны
- **[examples/EXAMPLES.md](examples/EXAMPLES.md)** — 10 примеров и шаблонов из практики.

---

## 📚 Что входит

### Области знаний (7 основных)
1. Лучшие практики написания промптов.
2. Продвинутые приёмы промпт-инжиниринга.
3. Пользовательские инструкции и системные промпты.
4. Оптимизация и доработка промптов.
5. Антипаттерны и частые ошибки.
6. Оценка и тестирование.
7. Мультимодальные и продвинутые запросы.

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

### Сценарии использования (9)
1. Уточнение расплывчатых или неэффективных промптов.
2. Создание специализированных системных промптов.
3. Разработка пользовательских инструкций агентам.
4. Повышение стабильности и надёжности.
5. Обучение лучшим практикам промпт-инжиниринга.
6. Отладка проблем с результатами промптов.
7. Создание шаблонов для рабочих процессов.
8. Повышение эффективности и снижение расхода токенов.
9. Разработка подходов к оценке.

---

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

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

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

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

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

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

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

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

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

---

## 📖 Структура документации

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

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

### TROUBLESHOOTING.md (решение проблем)
- 8 частых проблем с решениями.
- Порядок отладки.
- Справочная таблица.
- Контрольный список тестирования.

### EXAMPLES.md (примеры из практики)
- 10 практических примеров.
- Сравнение до и после.
- Шаблоны и подходы.
- Контрольные списки оптимизации.

---

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

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

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

---

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

### Шаг 1. Прочитай обзор
Начни с **README.md**, чтобы понять, что даёт навык.

### Шаг 2. Изучи лучшие практики
Прочитай **docs/BEST_PRACTICES.md** для основы.

### Шаг 3. Посмотри примеры
В **examples/EXAMPLES.md** есть реальные задачи.

### Шаг 4. Попробуй
Поделись промптом или опиши задачу.

### Шаг 5. Реши проблемы
При затруднениях используй **docs/TROUBLESHOOTING.md**.

---

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

### Промпты с пошаговым рассуждением
Побуждай модель рассуждать последовательно в сложных задачах.
→ См.: TECHNIQUES.md, раздел 1.

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

### Структурированный вывод
Используй теги XML для ясности и разбора.
→ См.: TECHNIQUES.md, раздел 3.

### Промпты с ролью
Назначай область экспертизы, направляющую ответ.
→ См.: TECHNIQUES.md, раздел 4.

### Цепочки промптов
Разбивай сложные задачи на последовательные запросы.
→ См.: TECHNIQUES.md, раздел 6.

### Работа с контекстом
Оптимизируй расход токенов и ясность.
→ См.: TECHNIQUES.md, раздел 7.

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

---

## 📊 Структура файлов

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

---

## 🎓 Маршрут обучения

### Начинающий
1. Прочитай README.md.
2. Прочитай BEST_PRACTICES.md (основные принципы).
3. Изучи EXAMPLES.md (примеры 1–3).
4. Попробуй создать простой промпт.

### Средний уровень
1. Прочитай TECHNIQUES.md (разделы 1–4).
2. Изучи EXAMPLES.md (примеры 4–7).
3. Прочитай TROUBLESHOOTING.md.
4. Попробуй улучшить существующий промпт.

### Продвинутый уровень
1. Прочитай TECHNIQUES.md (разделы 5–8).
2. Изучи EXAMPLES.md (примеры 8–10).
3. Прочитай BEST_PRACTICES.md (продвинутые разделы).
4. Попробуй объединить несколько приёмов.

---

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

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

---

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

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

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

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

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

---

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

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

---

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

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

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

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

### 4. Повышение стабильности
Улучшай надёжность и уменьшай разброс ответов.
→ См.: BEST_PRACTICES.md, раздел о структуре навыка.

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

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

### 7. Построение подхода к оценке
Разрабатывай тестовые случаи и критерии успеха.
→ См.: BEST_PRACTICES.md, раздел об оценке и тестировании.

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

---

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

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

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

---

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

1. **Изучи документацию** — начни с README.md.
2. **Посмотри примеры** — открой examples/EXAMPLES.md.
3. **Попробуй** — поделись промптом или опиши задачу.
4. **Дорабатывай** — используй обратную связь для улучшения.
5. **Поделись** — помоги другим с их промптами.