# 🎯 Эксперт по промпт-инжинирингу — полный пакет

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

**Полноценный навык Claude** для промпт-инжиниринга, в который входят:

### 📦 Содержимое полного пакета
- **7 основных файлов документации**.
- **3 специальных руководства**: лучшие практики, техники, устранение неполадок.
- **10 примеров из реальной практики** со сравнением до и после.
- **Несколько путеводителей** для удобной навигации.
- **Контрольные списки и шаблоны** для применения на практике.

### 📍 Расположение
```
~/Documents/prompt-engineering-expert/
```

---

## 📋 Состав файлов

### Основные файлы навыка (4 файла)
| Файл | Назначение | Размер |
|------|------------|--------|
| **SKILL.md** | Метаданные и обзор навыка | ~1 КБ |
| **CLAUDE.md** | Основные инструкции навыка | ~3 КБ |
| **README.md** | Руководство пользователя и первый запуск | ~4 КБ |
| **GETTING_STARTED.md** | Загрузка и использование | ~3 КБ |

### Документация (3 файла)
| Файл | Назначение | Содержание |
|------|------------|------------|
| **docs/BEST_PRACTICES.md** | Полное руководство по лучшим практикам | Основные принципы, продвинутые методы, оценка, антипаттерны |
| **docs/TECHNIQUES.md** | Руководство по продвинутым методам | 8 основных приёмов с примерами |
| **docs/TROUBLESHOOTING.md** | Решение проблем | 8 частых проблем и порядок отладки |

### Примеры и навигация (3 файла)
| Файл | Назначение | Содержание |
|------|------------|------------|
| **examples/EXAMPLES.md** | Примеры из практики | 10 практических примеров с шаблонами |
| **INDEX.md** | Полная навигация | Быстрые ссылки, маршруты обучения, точки интеграции |
| **SUMMARY.md** | Что создано | Обзор всех компонентов |

---

## 🎓 Охваченные области знаний

### 7 основных областей
1. ✅ **Лучшие практики написания промптов** — ясность, структура, конкретность.
2. ✅ **Продвинутые методы** — CoT, few-shot, XML, роли, предзаполнение, цепочки.
3. ✅ **Пользовательские инструкции** — системные промпты, правила поведения, границы.
4. ✅ **Оптимизация** — анализ результатов, итеративное улучшение, экономия токенов.
5. ✅ **Антипаттерны** — расплывчатость, противоречия, выдумки, обход ограничений.
6. ✅ **Оценка** — критерии успеха, тестовые случаи, анализ неудач.
7. ✅ **Мультимодальность** — изображения, файлы, эмбеддинги, расширенное размышление.

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

---

## 🚀 Как пользоваться

### Шаг 1. Загрузить навык
```
Перейди на Claude.com → нажми «+» → «Загрузить навык» → выбери папку
```

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

### Шаг 3. Получить экспертную рекомендацию
Claude проанализирует запрос с помощью знаний навыка и даст советы.

---

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

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

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

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

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

---

## 💡 Основные особенности

### ✨ Полный охват
- Все основные стороны промпт-инжиниринга.
- От основ до продвинутых методов.
- Примеры и шаблоны из практики.

### 🎯 Практичность
- Рекомендации, по которым можно действовать.
- Пошаговые инструкции.
- Готовые шаблоны.

### 📖 Удобная структура
- Понятная структура с постепенным раскрытием деталей.
- Несколько путеводителей.
- Справочные таблицы.

### 🔍 Подробность
- 8 частых проблем с решениями.
- 10 примеров из практики.
- Несколько контрольных списков.

### 🚀 Готовность к использованию
- Можно загрузить сразу.
- Дополнительная настройка не нужна.
- Работает с Claude.com и API.

---

## 📊 Статистика

| Показатель | Значение |
|------------|----------|
| Всего файлов | 10 |
| Всего документации | ~40 КБ |
| Основных областей знаний | 7 |
| Ключевых возможностей | 8 |
| Сценариев использования | 9 |
| Охваченных частых проблем | 8 |
| Примеров из практики | 10 |
| Продвинутых методов | 8 |
| Лучших практик | 50+ |
| Антипаттернов | 10+ |

---

## 🎯 Сценарии использования

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

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

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

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

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

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

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

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

### 9. Создание шаблонов промптов
Делай повторно используемые шаблоны для рабочих процессов.

---

## ✅ Контрольный список качества

- ✅ Основано на официальной документации Anthropic.
- ✅ Промпт-инжиниринг освещён всесторонне.
- ✅ Есть примеры и шаблоны из практики.
- ✅ Структура ясная и упорядоченная.
- ✅ Подробности раскрываются постепенно.
- ✅ Есть несколько путеводителей.
- ✅ Советы применимы на практике.
- ✅ Есть помощь с устранением неполадок и отладкой.
- ✅ Рассмотрены лучшие практики и антипаттерны.
- ✅ Готово к загрузке и использованию.

---

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

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

---

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

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

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

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

---

## 🎁 Что получишь

### Польза сразу
- Экспертные рекомендации по промпт-инжинирингу.
- Примеры и шаблоны из практики.
- Помощь в решении проблем.
- Справочник лучших практик.
- Распознавание антипаттернов.

### Долгосрочная польза
- Более качественные промпты.
- Быстрые циклы доработки.
- Более стабильные результаты.
- Меньше затраченных токенов.
- Более эффективное взаимодействие с ИИ.

---

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

1. **Перейди в папку**
   ```
   ~/Documents/prompt-engineering-expert/
   ```

2. **Загрузи навык** на Claude.com
   - Нажми «+» → «Загрузить навык» → выбери папку.

3. **Начни использовать**
   - Попроси Claude проверить промпты.
   - Запроси пользовательские инструкции.
   - Получи помощь с проблемами.

4. **Изучи документацию**
   - Начни с README.md.
   - Изучи примеры.
   - Освой продвинутые методы.

5. **Поделись с командой**
   - Совместно работайте над промптами.
   - Создавайте более качественные запросы.
   - Улучшайте взаимодействие с ИИ.

---

## 📞 Справочные ресурсы

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

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

---

## 🎉 Всё готово!

Твой **навык эксперта по промпт-инжинирингу** закончен и готов к использованию.

### Быстрый старт
1. Открой `~/Documents/prompt-engineering-expert/`.
2. Прочитай `GETTING_STARTED.md` с инструкциями по загрузке.
3. Загрузи навык на Claude.com.
4. Начни улучшать свои промпты.