Эксперт по промпт-инжинирингу

---
name: prompt-engineering-expert
description: Навык даёт Claude глубокие знания о промпт-инжиниринге, проектировании пользовательских инструкций и оптимизации промптов. Он подробно объясняет, как создавать действенные промпты для ИИ, составлять инструкции агентам и последовательно улучшать результат.
---

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

### 1. Лучшие практики написания промптов
- **Ясность и прямота:** формулировать понятные, однозначные промпты без места для неверного толкования.
- **Структура и формат:** организовывать промпты с правильной иерархией, разделами и наглядным оформлением.
- **Конкретность:** давать точные инструкции с примерами и ожидаемым результатом.
- **Работа с контекстом:** давать необходимый контекст, не перегружая модель.
- **Тон и стиль:** выбирать тон промпта под требования задачи.

### 2. Продвинутые приёмы промпт-инжиниринга
- **Рассуждение по шагам (Chain-of-Thought, CoT):** побуждать к последовательному анализу сложных задач.
- **Обучение на нескольких примерах (few-shot):** направлять поведение модели примерами (одним, двумя или несколькими).
- **Теги XML:** использовать структурированное оформление XML для ясности и разбора.
- **Промпты с ролью:** назначать Claude конкретный образ или область экспертизы.
- **Предзаполнение ответа:** начинать ответ Claude, чтобы задать формат результата.
- **Цепочки промптов:** разбивать сложную задачу на последовательные запросы.

### 3. Пользовательские инструкции и системные промпты
- **Проектирование системных промптов:** создавать эффективные промпты для специальных областей.
- **Пользовательские инструкции:** проектировать инструкции для ИИ-агентов и навыков.
- **Правила поведения:** устанавливать подходящие ограничения и ориентиры.
- **Характер и голос:** задавать последовательный тон и стиль общения.
- **Границы задачи:** ясно определять, что агенту следует и не следует делать.

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

### 5. Антипаттерны и частые ошибки
- **Расплывчатость:** находить и уточнять неясные инструкции.
- **Противоречия:** выявлять конфликтующие требования.
- **Чрезмерная детализация:** замечать, когда промпт слишком жёстко ограничивает ответ.
- **Риск выдумок:** находить промпты, провоцирующие ложные сведения.
- **Утечка контекста:** предотвращать непреднамеренное раскрытие информации.
- **Уязвимость к обходу инструкций:** распознавать и снижать риск внедрения вредоносных промптов.

### 6. Оценка и тестирование
- **Определение критериев успеха:** устанавливать понятные показатели результата.
- **Разработка тестовых случаев:** создавать достаточное покрытие.
- **Анализ неудач:** понимать, почему промпты не сработали.
- **Регрессионное тестирование:** проверять, что улучшения не ломают существующее поведение.
- **Пограничные случаи:** проверять необычные входные данные и границы условий.

### 7. Мультимодальные и продвинутые промпты
- **Промпты для зрения:** составлять запросы для анализа и понимания изображений.
- **Промпты с файлами:** работать с документами, PDF и структурированными данными.
- **Интеграция эмбеддингов:** применять векторные представления для смыслового поиска и извлечения.
- **Промпты для инструментов:** проектировать запросы, эффективно использующие инструменты и API.
- **Расширенное размышление:** применять его для сложных рассуждений.

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

- **Анализ промптов:** проверять существующие промпты и находить точки улучшения.
- **Создание промптов:** писать новые промпты под конкретные сценарии с нуля.
- **Доработка промптов:** улучшать их по результатам последовательных итераций.
- **Разработка пользовательских инструкций:** создавать специальные инструкции для агентов и навыков.
- **Объяснение лучших практик:** давать экспертные советы по принципам промпт-инжиниринга.
- **Распознавание антипаттернов:** находить и исправлять типичные ошибки.
- **Стратегия тестирования:** разрабатывать подходы к оценке и проверке промптов.
- **Документация:** ясно описывать использование и сопровождение промптов.

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

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

## Ограничения навыка

- Не выполняет код и не запускает промпты: только анализирует.
- Не имеет доступа к данным в реальном времени или внешним API.
- Даёт советы на основе лучших практик, а не гарантирует результат.
- Рекомендации нужно проверять на реальных задачах.
- Не заменяет человеческое суждение в критически важных приложениях.

## Замечания по интеграции

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

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

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

**Полноценный навык 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. Начни улучшать свои промпты.

# 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)

---

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

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

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

Полный навык 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. **Расширяй по необходимости** примерами из своей области.

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

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

### Первый запуск
- **[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. **Поделись** — помоги другим с их промптами.

# Эксперт по промпт-инжинирингу — лучшие практики

Этот документ сводит лучшие практики из официальной документации Anthropic и Claude Cookbooks для полноценного навыка промпт-инжиниринга.

## Основные принципы

### 1. Ясность и прямота
- **Формулируй прямо:** точно указывай, что Claude должен сделать.
- **Избегай двусмысленности:** используй формулировки, которые трудно истолковать неверно.
- **Давай конкретные примеры:** показывай, а не только рассказывай.
- **Выстраивай логично:** организуй информацию по иерархии.

### 2. Краткость
- **Помни об окне контекста:** оставляй в промпте то, что относится к делу.
- **Убирай повторы:** исключай ненужное дублирование.
- **Раскрывай детали постепенно:** давай их, когда они понадобятся.
- **Экономь токены:** учитывай и качество, и стоимость.

### 3. Уместная степень свободы
- **Определяй ограничения:** ясно указывай, что Claude должен и не должен делать.
- **Задавай формат:** прямо описывай желаемый вид ответа.
- **Очерчивай объём:** показывай, что входит в задачу и что вне её.
- **Сохраняй гибкость:** оставляй пространство для рассуждений Claude, удерживая нужный контроль.

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

### Промпты с пошаговым рассуждением (CoT)
Побуждай к последовательному анализу сложных задач:
```
«Давай разберём это по шагам:
1. Сначала определи...
2. Затем проанализируй...
3. Наконец, сделай вывод...»
```

### Промпты с несколькими примерами
Направляй поведение примерами:
- **Один пример:** для простых задач.
- **Два примера:** для задач умеренной сложности.
- **Несколько примеров:** для сложных паттернов.

### Теги XML для структуры
Используй теги XML, чтобы текст был понятным и пригодным для разбора:
```xml
<task>
  <objective>Что нужно сделать</objective>
  <constraints>Ограничения и правила</constraints>
  <format>Ожидаемый формат ответа</format>
</task>
```

### Промпты с ролью
Назначай Claude область экспертизы:
```
«Ты эксперт по промпт-инжинирингу с глубокими знаниями о...
Твоя задача — ...»
```

### Предзаполнение
Начинай ответ Claude, чтобы направить формат:
```
«Вот мой анализ:

Основные выводы:»
```

### Цепочки промптов
Разбивай сложные задачи на последовательные запросы:
1. Промпт 1: проанализировать входные данные.
2. Промпт 2: обработать результат анализа.
3. Промпт 3: сформировать ответ.

## Пользовательские инструкции и системные промпты

### Проектирование системных промптов
- **Определи роль:** какой экспертизой должен обладать Claude?
- **Задай тон:** какой стиль общения подходит?
- **Установи ограничения:** чего Claude следует избегать?
- **Проясни объём:** какова область экспертизы?

### Правила поведения
- **Делай:** какие конкретные действия поощряются.
- **Не делай:** каких действий следует избегать.
- **Пограничные случаи:** как поступать в необычных ситуациях.
- **Эскалация:** когда просить уточнение.

## Лучшие практики структуры навыка

### Именование
- Используй **форму герундия** (глагол + -ing): `analyzing-financial-statements`.
- Пиши **строчными буквами через дефис:** `prompt-engineering-expert`.
- Название должно **объяснять назначение** навыка.
- Избегай **общих названий:** указывай конкретную область.

### Хорошие описания
- **Первая строка:** ясная и краткая сводка (не более 1024 символов).
- **Конкретность:** перечисли точные возможности.
- **Сценарии:** назови основные способы применения.
- **Без расплывчатости:** не ограничивайся словами «помогает с» или «содействует».

### Постепенное раскрытие деталей

**Шаблон 1: обзор со ссылками**
- Начни с общего описания.
- Дай ссылки на подробные разделы.
- Расположи материал по сложности.

**Шаблон 2: организация по предметным областям**
- Группируй по сценариям.
- Разделяй разные задачи.
- Сделай навигацию ясной.

**Шаблон 3: подробности по условию**
- Показывай детали с учётом контекста.
- Приводи примеры для каждого пути.
- Не перегружай вариантами.

### Структура файлов
```
skill-name/
├── SKILL.md (обязательные метаданные)
├── CLAUDE.md (основные инструкции)
├── reference-guide.md (подробные сведения)
├── examples.md (сценарии использования)
└── troubleshooting.md (частые проблемы)
```

## Оценка и тестирование

### Критерии успеха
- **Измеримость:** опиши, как выглядит успех.
- **Конкретность:** избегай расплывчатых показателей.
- **Проверяемость:** результат можно оценить объективно.
- **Реалистичность:** цель достижима с данным промптом.

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

### Анализ неудач
- **Почему не получилось?** Ищи первопричину.
- **Распознавание паттернов:** находи систематические проблемы.
- **Доработка:** меняй промпт в соответствии с выводами.

## Антипаттерны

### Частые ошибки
- **Расплывчатость:** «Помоги мне с этой задачей» — слишком широко.
- **Противоречия:** конфликтующие требования.
- **Чрезмерная детализация:** слишком много ограничений.
- **Риск выдумок:** промпты, побуждающие к ложным сведениям.
- **Утечка контекста:** непреднамеренное раскрытие информации.
- **Уязвимость к обходу инструкций:** промпты, которыми легко манипулировать.

### Пути в стиле Windows
- ❌ Используй: `C:\Users\Documents\file.txt`
- ✅ Используй: `/Users/Documents/file.txt` или `~/Documents/file.txt`

### Слишком много вариантов
- Не предлагай 10 и больше вариантов.
- Ограничься 3–5 ясными альтернативами.
- Для сложного выбора раскрывай детали постепенно.

## Рабочие процессы и циклы обратной связи

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

### Замкни цикл обратной связи
- Проси уточнение при необходимости.
- Проверяй промежуточный результат.
- Корректируй работу по обратной связи.
- Подтверждай понимание.

## Правила содержания

### Избегай быстро устаревающих сведений
- Не зашивай даты.
- Используй относительные указания, например «текущий год».
- Предусмотри способ обновления.
- Отмечай дату актуальности сведений.

### Соблюдай единообразие терминов
- Один раз определи ключевые термины.
- Используй их последовательно.
- Не называй одно понятие разными синонимами.
- Для сложной области создай глоссарий.

## Мультимодальные и продвинутые запросы

### Промпты для анализа изображений
- Опиши, что Claude должен анализировать.
- Укажи формат ответа.
- Дай контекст изображения.
- Запроси конкретные детали.

### Промпты с файлами
- Укажи допустимые типы файлов.
- Опиши ожидаемую структуру.
- Дай правила разбора.
- Обрабатывай ошибки понятно.

### Расширенное размышление
- Используй для сложных рассуждений.
- Оставляй больше времени на обработку.
- Проси подробные объяснения.
- Применяй к новым задачам.

## Процесс разработки навыка

### Сначала разработай проверки
1. Определи критерии успеха.
2. Создай тестовые случаи.
3. Зафиксируй исходный уровень.
4. Измерь улучшение.

### Дорабатывай вместе с Claude
1. Начни с простой версии.
2. Проверь и собери обратную связь.
3. Исправь по результатам.
4. Повторяй до удовлетворительного результата.

### Наблюдай за тем, как Claude использует навыки
- Смотри, как Claude находит содержание.
- Отмечай, к каким разделам обращается.
- Находи непонятные места.
- Оптимизируй по фактическому использованию.

## Требования к frontmatter YAML

```yaml
---
name: skill-name
description: Ясное, краткое описание (не более 1024 символов)
---
```

## Расход токенов

- **Метаданные навыка:** ~100–200 токенов.
- **Основные инструкции:** ~500–1000 токенов.
- **Справочные файлы:** ~1000–5000 токенов каждый.
- **Примеры:** ~500–1000 токенов каждый.
- **Общий бюджет:** зависит от задачи.

## Контрольный список хорошего навыка

### Основное качество
- [ ] Ясное, конкретное имя (форма герундия).
- [ ] Краткое описание (1–2 предложения).
- [ ] Удобная структура.
- [ ] Постепенное раскрытие деталей.
- [ ] Единообразная терминология.
- [ ] Нет быстро устаревающих сведений.

### Содержание
- [ ] Определены ясные сценарии использования.
- [ ] Приведены примеры.
- [ ] Описаны пограничные случаи.
- [ ] Указаны ограничения.
- [ ] Есть руководство по устранению неполадок.

### Тестирование
- [ ] Созданы тестовые случаи.
- [ ] Определены критерии успеха.
- [ ] Проверены пограничные случаи.
- [ ] Проверена обработка ошибок.
- [ ] Проверено несколько моделей.

### Документация
- [ ] README или обзор.
- [ ] Примеры использования.
- [ ] Замечания об API и интеграции.
- [ ] Раздел устранения проблем.
- [ ] Описан механизм обновления.

# Продвинутые приёмы промпт-инжиниринга

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

## 1. Промпты с пошаговым рассуждением (CoT)

### Что это
Побуждение Claude разложить сложное рассуждение на явные шаги до окончательного ответа.

### Когда использовать
- Сложные задачи на рассуждение.
- Многошаговые проблемы.
- Задачи, требующие обоснования.
- Ситуации, где важна стабильность результата.

### Основная структура
```
Давай разберём это по шагам:

Шаг 1: [Первый логический шаг]
Шаг 2: [Второй логический шаг]
Шаг 3: [Третий логический шаг]

Итак: [Вывод]
```

### Пример
```
Задача: магазин продаёт яблоки по 2 доллара, а апельсины по 3 доллара за штуку.
Сколько я потрачу на 5 яблок и 3 апельсина?

Разберём по шагам:

Шаг 1: Рассчитать стоимость яблок.
- 5 яблок × 2 доллара = 10 долларов.

Шаг 2: Рассчитать стоимость апельсинов.
- 3 апельсина × 3 доллара = 9 долларов.

Шаг 3: Рассчитать итог.
- 10 + 9 = 19 долларов.

Итак: всего ты потратишь 19 долларов.
```

### Преимущества
- Более точное рассуждение.
- Легче найти ошибки.
- Лучше подходит для сложных задач.
- Логика виднее читателю.

## 2. Обучение на нескольких примерах

### Что это
Примеры, которые направляют поведение Claude без явных инструкций.

### Типы

#### Один пример
Лучше всего для простых, прямых задач:
```
Пример: «Счастлив» → Положительно
Теперь классифицируй: «Ужасно» →
```

#### Два примера
Лучше всего для умеренной сложности:
```
Пример 1: «Отличный продукт!» → Положительно
Пример 2: «Плохо работает» → Отрицательно
Теперь классифицируй: «Нормально» →
```

#### Несколько примеров
Лучше всего для сложных паттернов и пограничных случаев:
```
Пример 1: «Обожаю!» → Положительно
Пример 2: «Ненавижу» → Отрицательно
Пример 3: «Всё нормально» → Нейтрально
Пример 4: «Могло быть лучше» → Нейтрально
Пример 5: «Потрясающе!» → Положительно
Теперь классифицируй: «Неплохо» →
```

### Лучшие практики
- Используй разнообразные примеры.
- Добавляй пограничные случаи.
- Показывай правильный формат.
- Располагай по сложности.
- Примеры должны быть реалистичными.

## 3. Структурированный вывод с тегами XML

### Что это
Использование тегов XML для структуры промпта и формата ответа.

### Преимущества
- Понятная структура.
- Лёгкий разбор.
- Меньше двусмысленности.
- Лучше организованный текст.

### Частые шаблоны

#### Определение задачи
```xml
<task>
  <objective>Что нужно сделать</objective>
  <constraints>Ограничения и правила</constraints>
  <format>Ожидаемый формат ответа</format>
</task>
```

#### Структура анализа
```xml
<analysis>
  <problem>Определи проблему</problem>
  <context>Нужные исходные сведения</context>
  <solution>Предлагаемое решение</solution>
  <justification>Почему это решение</justification>
</analysis>
```

#### Условная логика
```xml
<instructions>
  <if condition="input_type == 'question'">
    <then>Дай подробный ответ</then>
  </if>
  <if condition="input_type == 'request'">
    <then>Выполни запрос</then>
  </if>
</instructions>
```

## 4. Промпты с ролью

### Что это
Назначение Claude конкретной роли или области экспертизы, направляющей поведение.

### Структура
```
Ты [РОЛЬ] со знаниями в области [ОБЛАСТЬ].

Твои обязанности:
- [Обязанность 1]
- [Обязанность 2]
- [Обязанность 3]

В ответе:
- [Правило 1]
- [Правило 2]
- [Правило 3]

Твоя задача: [Конкретная задача]
```

### Примеры

#### Опытный консультант
```
Ты старший консультант по управлению с 20-летним опытом
в бизнес-стратегии и организационных преобразованиях.

Твоя задача: проанализируй трудности компании и предложи решения.
```

#### Технический архитектор
```
Ты архитектор облачной инфраструктуры, специализирующийся на масштабируемых системах.

Твоя задача: спроектируй архитектуру системы для [требования].
```

#### Креативный директор
```
Ты креативный директор, разбирающийся в истории брендов и визуальной коммуникации.

Твоя задача: разработай историю бренда для [продукт/компания].
```

## 5. Предзаполнение ответов

### Что это
Начало ответа Claude, задающее формат и тон.

### Преимущества
- Помогает соблюдать формат.
- Задаёт тон и стиль.
- Направляет рассуждение.
- Повышает стабильность.

### Примеры

#### Структурированный анализ
```
Промпт: Проанализируй эту рыночную возможность.

Ответ Claude должен начинаться так:
«Вот мой анализ этой рыночной возможности:

Размер рынка: [Анализ]
Потенциал роста: [Анализ]
Конкурентная среда: [Анализ]»
```

#### Пошаговое рассуждение
```
Промпт: Реши эту задачу.

Ответ Claude должен начинаться так:
«Я разберу её последовательно:

1. Сначала определю ключевые переменные...
2. Затем изучу связи между ними...
3. Наконец, выведу решение...»
```

#### Ответ в заданном формате
```
Промпт: Создай план проекта.

Ответ Claude должен начинаться так:
«Вот план проекта:

Этап 1: Планирование
- Задача 1.1: [Описание]
- Задача 1.2: [Описание]

Этап 2: Выполнение
- Задача 2.1: [Описание]»
```

## 6. Цепочки промптов

### Что это
Разделение сложной задачи на последовательные запросы, где результат одного становится входом следующего.

### Структура
```
Промпт 1: Анализ и извлечение
↓
Результат 1: Структурированные данные
↓
Промпт 2: Обработка и преобразование
↓
Результат 2: Обработанные данные
↓
Промпт 3: Создание и обобщение
↓
Итоговый ответ: Результат
```

### Пример: анализ документа по этапам

**Промпт 1: Извлечь сведения**
```
Извлеки ключевые сведения из документа:
- Главная тема.
- Основные пункты (списком).
- Важные даты.
- Связанные лица и организации.

Выведи JSON.
```

**Промпт 2: Проанализировать извлечённые данные**
```
Проанализируй эти сведения:
[JSON из промпта 1]

Определи:
- Связи между лицами и организациями.
- Временные закономерности.
- Значение каждого пункта.
```

**Промпт 3: Составить сводку**
```
На основе анализа:
[Анализ из промпта 2]

Составь краткую сводку для руководителя, которая:
- объясняет основные выводы;
- выделяет важные наблюдения;
- рекомендует следующие шаги.
```

## 7. Работа с контекстом

### Что это
Продуманное управление информацией для экономии токенов и ясности.

### Приёмы

#### Постепенное раскрытие деталей
```
Начни с: общего обзора.
Затем дай: относящиеся к делу подробности.
Наконец добавь: пограничные случаи и исключения.
```

#### Иерархическая организация
```
Уровень 1: Основная идея
├── Уровень 2: Ключевые части
│   ├── Уровень 3: Конкретные детали
│   └── Уровень 3: Замечания по реализации
└── Уровень 2: Связанные понятия
```

#### Информация по условию
```
Если [условие], включи [сведения].
Иначе пропусти [сведения].

Это сокращает ненужный контекст.
```

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

## 8. Мультимодальные запросы

### Промпты для изображений

#### Структура
```
Проанализируй изображение:
[ИЗОБРАЖЕНИЕ]

В частности, определи:
1. [Что искать]
2. [Что анализировать]
3. [Что извлекать]

Оформи ответ так:
[Желаемый формат]
```

#### Пример
```
Проанализируй этот график:
[ИЗОБРАЖЕНИЕ ГРАФИКА]

Определи:
1. Основные тенденции.
2. Аномалии и выбросы.
3. Прогноз на следующий период.

Оформи как структурированный отчёт.
```

### Промпты с файлами

#### Структура
```
Проанализируй документ:
[ФАЙЛ]

Извлеки:
- [Тип сведений 1]
- [Тип сведений 2]
- [Тип сведений 3]

Формат:
[Желаемый формат]
```

#### Пример
```
Проанализируй финансовый отчёт PDF:
[ФАЙЛ PDF]

Извлеки:
- Выручку по кварталам.
- Категории расходов.
- Размер прибыли.

Оформи сравнительной таблицей.
```

### Использование эмбеддингов

#### Структура
```
Используя эти эмбеддинги:
[ДАННЫЕ ЭМБЕДДИНГОВ]

Найди:
- Наиболее похожие элементы.
- Кластеры или группы.
- Выбросы.

Объясни связи.
```

## Сочетание методов

### Пример: промпт для сложного анализа

```xml
<prompt>
  <role>
    Ты старший аналитик данных со знаниями бизнес-аналитики.
  </role>

  <task>
    Проанализируй данные продаж и дай полезные выводы.
  </task>

  <instructions>
    Разберём задачу по шагам:

    Шаг 1: Обзор данных
    - Что показывают данные?
    - Какой период они охватывают?
    - Какие показатели главные?

    Шаг 2: Анализ тенденций
    - Какие закономерности видны?
    - Есть ли сезонность?
    - Какова траектория роста?

    Шаг 3: Сравнительный анализ
    - Как это соотносится с ориентирами?
    - Какие сегменты работают лучше всего?
    - Где есть возможности?

    Шаг 4: Рекомендации
    - Какие действия стоит предпринять?
    - Что важнее всего?
    - Каков ожидаемый эффект?
  </instructions>

  <format>
    <executive_summary>2–3 предложения</executive_summary>
    <key_findings>Пункты списка</key_findings>
    <detailed_analysis>Структурированные разделы</detailed_analysis>
    <recommendations>Список по приоритету</recommendations>
  </format>
</prompt>
```

## Антипаттерны

### ❌ Расплывчатая цепочка
```
«Проанализируй это, затем подведи итог, потом дай наблюдения».
```

### ✅ Ясная цепочка
```
«Шаг 1: Извлеки из данных ключевые показатели.
Шаг 2: Сравни их с отраслевыми ориентирами.
Шаг 3: Найди три главные возможности.
Шаг 4: Порекомендуй действия в порядке приоритета».
```

### ❌ Неясная роль
```
«Веди себя как эксперт и помоги мне».
```

### ✅ Ясная роль
```
«Ты старший продакт-менеджер с 10-летним опытом в SaaS-компаниях. Твоя задача — ...»
```

### ❌ Неоднозначный формат
```
«Представь результат в красивом виде».
```

### ✅ Ясный формат
```
«Оформи таблицей со столбцами: Показатель, Сейчас, Цель, Разница».
```

# Руководство по устранению проблем

## Частые проблемы с промптами и решения

### Проблема 1: Нестабильные ответы

**Признаки:**
- Один промпт даёт разные результаты.
- Формат и качество ответов меняются.
- Поведение трудно предсказать.

**Причины:**
- Двусмысленные инструкции.
- Не заданы ограничения.
- Слишком мало примеров.
- Неясные критерии успеха.

**Решения:**
```
1. Добавь конкретные требования к формату.
2. Приведи несколько примеров.
3. Явно определи ограничения.
4. Задай структуру ответа тегами XML.
5. Для стабильности назначь роль.
```

**Пример исправления:**
```
❌ До: «Кратко перескажи эту статью».

✅ После: «Перескажи статью ровно тремя пунктами, по 1–2 предложения
в каждом. Сосредоточься на основных выводах и их последствиях».
```

---

### Проблема 2: Выдуманные или ложные сведения

**Признаки:**
- Claude выдумывает факты.
- Звучит уверенно, но ошибается.
- Приводит несуществующие ссылки или данные.

**Причины:**
- Промпт поощряет догадки.
- Нет опоры на факты.
- Недостаточно контекста.
- Неоднозначные вопросы.

**Решения:**
```
1. Попроси Claude приводить источники.
2. Запроси оценку уверенности.
3. Попроси указать оговорки и ограничения.
4. Дай фактический контекст.
5. Спроси: «Чего ты не знаешь?»
```

**Пример исправления:**
```
❌ До: «Что произойдёт с рынком в следующем году?»

✅ После: «На основе текущих рыночных данных опиши три возможных
сценария на следующий год. Для каждого объясни ход мысли и оцени
уверенность: высокая, средняя или низкая».
```

---

### Проблема 3: Расплывчатые или бесполезные ответы

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

**Причины:**
- Расплывчатый промпт.
- Недостающий контекст.
- Неясная цель.
- Не задан формат.

**Решения:**
```
1. Сформулируй промпт конкретнее.
2. Дай относящийся к делу контекст.
3. Укажи формат ответа.
4. Приведи примеры хороших ответов.
5. Определи критерии успеха.
```

**Пример исправления:**
```
❌ До: «Как улучшить мой бизнес?»

✅ После: «У меня SaaS-компания с годовой регулярной выручкой 2 млн
долларов. Клиенты уходят к конкурентам. Какие три конкретные стратегии
помогут улучшить удержание? Для каждой опиши шаги внедрения и ожидаемый эффект».
```

---

### Проблема 4: Слишком длинные или короткие ответы

**Признаки:**
- Ответ слишком многословен.
- Ответ чрезмерно краток.
- Не соответствует ожиданиям.
- Зря расходует токены.

**Причины:**
- Не задана длина.
- Неясен объём задачи.
- Нет указаний по формату.
- Неясна требуемая подробность.

**Решения:**
```
1. Укажи число слов или предложений.
2. Ясно определи объём.
3. Используй шаблон формата.
4. Приведи примеры.
5. Попроси нужный уровень детализации.
```

**Пример исправления:**
```
❌ До: «Объясни машинное обучение».

✅ После: «Объясни машинное обучение в двух-трёх абзацах человеку
без технической подготовки. Сосредоточься на практическом применении,
а не теории».
```

---

### Проблема 5: Неверный формат ответа

**Признаки:**
- Формат не подходит для задачи.
- Ответ нельзя автоматически разобрать.
- Он несовместим со следующими инструментами.
- Нужна ручная переработка.

**Причины:**
- Формат не указан.
- Требование к формату неоднозначно.
- Пример формата не показан ясно.
- Не хватает примеров.

**Решения:**
```
1. Укажи точный формат: JSON, CSV, таблица и так далее.
2. Покажи пример.
3. Для структуры используй теги XML.
4. Перечисли нужные поля.
5. Покажи пример до и после.
```

**Пример исправления:**
```
❌ До: «Перечисли пять лучших продуктов».

✅ После: «Выведи пять лучших продуктов в формате JSON:
{
  "products": [
    {"name": "...", "revenue": "...", "growth": "..."}
  ]
}»
```

---

### Проблема 6: Claude отказывается отвечать

**Признаки:**
- «Я не могу с этим помочь».
- Отказ отвечать.
- Предлагает альтернативы.
- Выглядит чрезмерно осторожным.

**Причины:**
- Промпт кажется вредным.
- Намерение двусмысленно.
- Тема чувствительна.
- Неясно законное применение.

**Решения:**
```
1. Проясни законную цель.
2. Переформулируй вопрос.
3. Дай контекст.
4. Объясни, зачем тебе это нужно.
5. Вместо деталей попроси общую рекомендацию.
```

**Пример исправления:**
```
❌ До: «Как манипулировать людьми?»

✅ После: «Я пишу роман с персонажем-манипулятором. Как психолог
описал бы тактики манипуляции? Какие психологические механизмы здесь действуют?»
```

---

### Проблема 7: Слишком длинный промпт

**Признаки:**
- Превышает окно контекста.
- Медленный ответ.
- Большой расход токенов.
- Дорогой запуск.

**Причины:**
- Лишний контекст.
- Повторы.
- Слишком много примеров.
- Многословные инструкции.

**Решения:**
```
1. Удали лишний контекст.
2. Объедини похожие пункты.
3. Дай ссылки на материалы вместо полного текста.
4. Сократи число примеров.
5. Раскрывай подробности постепенно.
```

**Пример исправления:**
```
❌ До: [Промпт на 5000 слов с полной документацией]

✅ После: [Промпт на 500 слов со ссылками на подробную документацию]
«Подробные требования см. в REFERENCE.md».
```

---

### Проблема 8: Промпт не обобщается

**Признаки:**
- Работает для одного случая, но не для других.
- Ломается при изменении входных данных.
- Не выдерживает другого формата данных.
- Не пригоден для повторного использования.

**Причины:**
- Слишком привязан к одному примеру.
- Значения зашиты в код.
- Предполагает только один формат.
- Не хватает гибкости.

**Решения:**
```
1. Используй переменные вместо жёстко заданных значений.
2. Обрабатывай несколько форматов входа.
3. Добавь обработку ошибок.
4. Проверяй на разных входных данных.
5. Сохраняй гибкость.
```

**Пример исправления:**
```
❌ До: «Проанализируй данные продаж за третий квартал...»

✅ После: «Проанализируй данные [ПЕРИОД] по показателю [ПОКАЗАТЕЛЬ].
Принимай разные форматы: CSV, JSON или таблицу.
Если формат непонятен, попроси уточнение».
```

---

## Порядок отладки

### Шаг 1. Определи проблему
- Что не работает?
- Как проявляется сбой?
- Каковы последствия?

### Шаг 2. Проанализируй промпт
- Цель понятна?
- Инструкции конкретны?
- Контекста достаточно?
- Формат указан?

### Шаг 3. Проверь гипотезы
- Попробуй добавить контекст.
- Попробуй сформулировать конкретнее.
- Попробуй привести примеры.
- Попробуй изменить формат.

### Шаг 4. Внеси исправление
- Обнови промпт.
- Проверь на нескольких входных данных.
- Убедись в стабильности.
- Задокументируй изменение.

### Шаг 5. Проверь результат
- Теперь работает?
- Подходит для разных случаев?
- Эффективен?
- Удобен в сопровождении?

---

## Быстрая справка: частые исправления

| Проблема | Быстрое исправление |
|----------|---------------------|
| Нестабильность | Добавь формат и примеры. |
| Выдумки | Попроси источники и оценку уверенности. |
| Расплывчатость | Добавь конкретные детали и примеры. |
| Слишком длинный ответ | Задай число слов и формат. |
| Неверный формат | Покажи точный пример формата. |
| Отказ отвечать | Проясни законную цель. |
| Слишком длинный промпт | Удали лишний контекст. |
| Плохое обобщение | Используй переменные и обрабатывай разные входные данные. |

---

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

До использования промпта проверь:

- [ ] Цель предельно ясна.
- [ ] Инструкции конкретны.
- [ ] Формат задан.
- [ ] Примеры приведены.
- [ ] Пограничные случаи обработаны.
- [ ] Работает с несколькими видами входных данных.
- [ ] Ответ стабилен.
- [ ] Расход токенов оптимизирован.
- [ ] Обработка ошибок понятна.
- [ ] Документация полна.

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

## Пример 1. Уточнение расплывчатого промпта

### До (неэффективно)
```
Помоги написать более удачный промпт для анализа отзывов клиентов.
```

### После (эффективно)
```
Ты эксперт по промпт-инжинирингу. Мне нужен промпт, который:
- анализирует настроение отзывов клиентов (положительное, отрицательное, нейтральное);
- извлекает основные темы и болезненные проблемы;
- находит рекомендации, по которым можно действовать;
- выдаёт структурированный JSON с полями: sentiment, themes (массив), pain_points (массив), recommendations (массив).

Промпт должен работать с отзывами объёмом 50–500 слов и давать стабильный результат для разных групп клиентов.

Проверь этот промпт и предложи улучшения:
[ИСХОДНЫЙ ПРОМПТ]
```

## Пример 2. Пользовательские инструкции агенту анализа данных

```yaml
---
name: data-analysis-agent
description: Специализированный агент для анализа финансовых данных и отчётности
---

# Инструкции агенту анализа данных

## Роль
Ты опытный финансовый аналитик, глубоко разбирающийся в:
- анализе финансовой отчётности;
- выявлении тенденций и прогнозировании;
- оценке рисков;
- сравнительном анализе.

## Основные правила поведения

### Делай
- Всегда проверяй источники данных до анализа.
- Оценивай уверенность в прогнозах.
- Отмечай предположения и ограничения.
- Используй понятные визуализации и таблицы.
- Объясняй метод до результатов.

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

## Формат ответа
Всегда строй анализ так:
1. Краткая сводка (2–3 предложения).
2. Основные выводы (списком).
3. Подробный анализ (с подтверждающими данными).
4. Ограничения и оговорки.
5. Рекомендации, если уместны.

## Границы
- Только анализ финансовых данных.
- Исторические и текущие данные, без домыслов.
- Предпочтителен количественный анализ.
- Стратегические решения передавай человеку-аналитику.
```

## Пример 3. Классификация по нескольким примерам

```
Ты классификатор обращений в поддержку. Отнеси каждое обращение к одной категории:
- billing: вопросы оплаты, счетов или подписки;
- technical: ошибки, сбои или технические проблемы;
- feature_request: запросы новых возможностей;
- general: общие вопросы и отзывы.

Примеры:

Обращение: «В этом месяце с меня дважды списали плату за подписку».
Категория: billing

Обращение: «Приложение падает, когда я загружаю файлы больше 100 МБ».
Категория: technical

Обращение: «Хотелось бы тёмную тему в мобильном приложении».
Категория: feature_request

Теперь классифицируй:
Обращение: «Как сбросить пароль?»
Категория:
```

## Пример 4. Промпт с пошаговым рассуждением для сложного анализа

```
Проанализируй эту бизнес-ситуацию по шагам:

Шаг 1: Определи основную проблему.
- В чём главная трудность?
- Каковы симптомы?
- Какова первопричина?

Шаг 2: Изучи сопутствующие факторы.
- Какие внешние факторы участвуют?
- Какие внутренние факторы участвуют?
- Как они взаимодействуют?

Шаг 3: Оцени возможные решения.
- Какие 3–5 решений жизнеспособны?
- Каковы плюсы и минусы каждого?
- Какие трудности будут при внедрении?

Шаг 4: Дай рекомендацию и обоснуй её.
- Какое решение лучше?
- Почему оно лучше альтернатив?
- Каковы риски и способы их снизить?

Ситуация: [ОПИШИТЕ СИТУАЦИЮ]
```

## Пример 5. XML-промпт для стабильности

```xml
<prompt>
  <metadata>
    <version>1.0</version>
    <purpose>Создать рекламный текст для SaaS-продуктов</purpose>
    <target_audience>Лица, принимающие решения в B2B</target_audience>
  </metadata>

  <instructions>
    <objective>
      Напиши убедительный рекламный текст с упором на окупаемость и экономию времени.
    </objective>

    <constraints>
      <max_length>150 слов</max_length>
      <tone>Профессиональный, но доступный</tone>
      <avoid>Жаргон, преувеличения, ложные утверждения</avoid>
    </constraints>

    <format>
      <headline>Убедительный заголовок о пользе (не больше 10 слов)</headline>
      <body>2–3 абзаца об основных преимуществах</body>
      <cta>Ясный призыв к действию</cta>
    </format>

    <examples>
      <example>
        <product>Инструмент управления проектами</product>
        <copy>
          Заголовок: «Сократите задержки проектов на 40%»
          Текст: «Команды тратят 8 часов в неделю на обновление статуса. Наш инструмент автоматизирует координацию...»
        </copy>
      </example>
    </examples>
  </instructions>
</prompt>
```

## Пример 6. Промпт для итеративной доработки

```
Я работаю над промптом для [ЗАДАЧА]. Вот текущая версия:

[ТЕКУЩИЙ ПРОМПТ]

Я заметил проблемы:
- [ПРОБЛЕМА 1]
- [ПРОБЛЕМА 2]
- [ПРОБЛЕМА 3]

Как эксперт по промпт-инжинирингу:
1. Найди дополнительные проблемы, которые я пропустил.
2. Предложи конкретные улучшения с обоснованием.
3. Дай доработанный промпт.
4. Объясни, что изменилось и зачем.
5. Предложи тестовые случаи для проверки улучшений.
```

## Пример 7. Распознавание антипаттерна

### ❌ Неэффективный промпт
```
«Проанализируй эти данные и скажи, что о них думаешь. Сделай хорошо».
```

**Проблемы:**
- Расплывчатая цель («проанализируй» и «что думаешь»).
- Не задан формат.
- Нет критериев успеха.
- Неясен стандарт качества («сделай хорошо»).

### ✅ Улучшенный промпт
```
«Проанализируй данные продаж и найди:
1. Три самых успешных продукта по выручке.
2. Сезонные тенденции — изменения от месяца к месяцу.
3. Группы клиентов с наибольшей пожизненной ценностью.

Оформи структурированным отчётом с:
- краткой сводкой на 2–3 предложения;
- таблицей основных показателей;
- анализом тенденций с подтверждающими данными;
- рекомендациями, по которым можно действовать.

Сосредоточься на наблюдениях, которые помогут увеличить выручку в четвёртом квартале».
```

## Пример 8. Подход к тестированию промптов

```
# Схема оценки промпта

## Тестовый случай 1: обычный сценарий
Вход: [Стандартные, корректно оформленные данные]
Ожидаемый результат: [Конкретный, подробный ответ]
Критерий успеха: [Измеримый критерий]

## Тестовый случай 2: пограничный — неоднозначный вход
Вход: [Неоднозначные или неясные данные]
Ожидаемый результат: [Запрос уточнения]
Критерий успеха: [Заданы уточняющие вопросы]

## Тестовый случай 3: пограничный — сложная ситуация
Вход: [Сложные, многосторонние данные]
Ожидаемый результат: [Структурированный, полный анализ]
Критерий успеха: [Охвачены все стороны]

## Тестовый случай 4: обработка ошибок
Вход: [Неверные или повреждённые данные]
Ожидаемый результат: [Понятное сообщение об ошибке с подсказкой]
Критерий успеха: [Полезное сообщение, по которому можно действовать]

## Регрессионный тест
Вход: [Случай, который раньше не работал]
Ожидаемый результат: [Теперь обрабатывается правильно]
Критерий успеха: [Проблема устранена]
```

## Пример 9. Шаблон метаданных навыка

```yaml
---
name: analyzing-financial-statements
description: Экспертное руководство по анализу финансовой отчётности, выявлению тенденций и получению полезных выводов для деловых решений
---

# Навык анализа финансовой отчётности

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

## Ключевые возможности
- Анализ баланса.
- Интерпретация отчёта о прибылях и убытках.
- Анализ движения денежных средств.
- Анализ коэффициентов и сравнение с ориентирами.
- Выявление тенденций.
- Оценка рисков.

## Сценарии использования
- Оценка финансового здоровья компании.
- Сравнение конкурентов.
- Поиск инвестиционных возможностей.
- Оценка результатов бизнеса.
- Прогнозирование финансовых тенденций.

## Ограничения
- Только исторические данные: не для прогнозов.
- Нужны точные финансовые данные.
- Важен контекст отрасли.
- Рекомендуется профессиональное суждение.
```

## Пример 10. Контрольный список оптимизации промпта

```
# Контрольный список оптимизации промпта

## Ясность
- [ ] Цель предельно ясна.
- [ ] Нет неоднозначных терминов.
- [ ] Приведены примеры.
- [ ] Указан формат.

## Краткость
- [ ] Нет лишних слов.
- [ ] В центре внимания главное.
- [ ] Структура экономная.
- [ ] Учтено окно контекста.

## Полнота
- [ ] Приведён весь нужный контекст.
- [ ] Рассмотрены пограничные случаи.
- [ ] Определены критерии успеха.
- [ ] Указаны ограничения.

## Проверяемость
- [ ] Успех можно измерить.
- [ ] Есть ясные критерии «прошёл/не прошёл».
- [ ] Результат воспроизводим.
- [ ] Обрабатываются пограничные случаи.

## Устойчивость
- [ ] Работает при изменениях входных данных.
- [ ] Корректно обрабатывает ошибки.
- [ ] Стабильно соблюдает формат ответа.
- [ ] Устойчив к обходу инструкций.
```