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

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

### Проблема 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. Проверь результат
- Теперь работает?
- Подходит для разных случаев?
- Эффективен?
- Удобен в сопровождении?

---

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

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

---

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

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

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