Универсальный шаблон

\#\# Роль  
$Опционально: экспертиза и стиль$  
  
\#\# Контекст  
$Домен, технологии, ограничения, релевантные данные$  
  
\#\# Задача  
$Одно предложение: глагол + объект$  
  
\#\# Требования  
1. $Требование$  
2. $Требование$  
3. $Требование$  
  
\#\# Не делать  
- $Ограничение$  
- $Ограничение$  
  
\#\# Формат ответа  
$Структура: JSON, markdown, код$  
  
\#\# Примеры (опционально)  
Вход: $пример$  
Выход: $пример$

Шаблон: Генерация кода

\#\# Задача  
Напиши $тип: функция/класс/модуль$ для $назначение$  
  
\#\# Контекст  
- Язык: Python $версия$  
- Зависимости: $библиотеки$  
- Окружение: $sync/async, версии$  
  
\#\# Сигнатура  
\`\`\`python  
def function\_name(  
    param1: Type1,  
    param2: Type2 = default  
) -\> ReturnType:

Поведение

• $Нормальный случай$

• $Edge case 1$

• $Edge case 2$

• $Ошибки$

Не делать

• $Ограничение$

Формат

$код с type hints и docstring$

  
\#\# Шаблон: Code Review  
  
\`\`\`markdown  
\#\# Код  
\`\`\`python  
$код для ревью$

Контекст

• Проект: $описание$

• Назначение кода: $что делает$

Фокус ревью

• Безопасность

• Производительность

• Корректность

• Читаемость

Не комментировать

• $Что игнорировать: стиль, форматирование$

Формат ответа

\#\# Критичные (блокеры)  
- Строка N: $проблема$  
  - Причина: $почему плохо$  
  - Решение: $как исправить$  
  
\#\# Важные  
- Строка N: $проблема$ → $решение$  
  
\#\# Рекомендации  
- $Улучшение$

Лимит

$Максимум замечаний: 10$

  
\#\# Шаблон: Отладка  
  
\`\`\`markdown  
\#\# Симптом  
$Что происходит — конкретно$  
  
\#\# Ожидаемое поведение  
$Что должно происходить$  
  
\#\# Воспроизведение  
1. $Шаг$  
2. $Шаг$  
3. $Результат$  
  
\#\# Код  
\`\`\`python  
$Релевантный код с номерами строк$

Traceback (если есть)

$Traceback$

Уже проверено

• $Гипотеза 1$: $результат проверки$

• $Гипотеза 2$: $результат проверки$

Задача

1. Найди причину

2. Предложи исправление

3. Объясни, почему это работает

  
\#\# Шаблон: Рефакторинг  
  
\`\`\`markdown  
\#\# Текущий код  
\`\`\`python  
$код для рефакторинга$

Проблемы с текущим кодом

• $Проблема 1$

• $Проблема 2$

Цели рефакторинга

• $Цель 1: читаемость / производительность / тестируемость$

• $Цель 2$

Ограничения

• Сохранить: $публичный API / поведение$

• Не менять: $что не трогать$

Формат

\# === БЫЛО ===  
$старый код$  
  
\# === СТАЛО ===  
$новый код$  
  
\# === ИЗМЕНЕНИЯ ===  
\# 1. $Что изменилось и почему$  
\# 2. $Что изменилось и почему$

  
\#\# Шаблон: Статистический анализ  
  
\`\`\`markdown  
\#\# Данные  
- Источник: $файл/описание$  
- Размер: $n записей, m признаков$  
- Переменные:  
  - $Имя$: $тип, описание$  
  - $Имя$: $тип, описание$  
  
\#\# Гипотеза  
$H\_0$: $нулевая гипотеза$  
$H\_1$: $альтернативная гипотеза$  
  
\#\# Требования  
- Уровень значимости: $\\alpha = $0.05$$  
- Мощность: $1 - \\beta = $0.8$$  
  
\#\# Задача  
1. Проверить допущения  
2. Выбрать статистический тест  
3. Провести анализ  
4. Интерпретировать результаты  
  
\#\# Формат  
\`\`\`python  
\# Код анализа с комментариями

Интерпретация

$Вывод: статистически значимо / не значимо$ $Практическая значимость$ $Ограничения$

  
\#\# Шаблон: ML Эксперимент  
  
\`\`\`markdown  
\#\# Задача  
$Классификация / Регрессия / Кластеризация$  
  
\#\# Данные  
- Размер: $train/val/test split$  
- Признаки: $число, типы$  
- Целевая переменная: $имя, тип, распределение$  
- Дисбаланс: $если есть$  
  
\#\# Baseline модели  
1. $Модель 1$  
2. $Модель 2$  
3. $Модель 3$  
  
\#\# Метрики  
- Основная: $метрика$  
- Дополнительные: $метрики$  
  
\#\# Требования  
- Cross-validation: $тип, folds$  
- Воспроизводимость: random\_state=42  
  
\#\# Формат  
\`\`\`python  
\# Код эксперимента

Шаблон: API Endpoint

\#\# Endpoint  
$METHOD$ $PATH$  
  
\#\# Описание  
$Что делает endpoint$  
  
\#\# Аутентификация  
$Требуется / Не требуется / Опционально$  
  
\#\# Request  
\#\#\# Headers

Authorization: Bearer {token} Content-Type: application/json

  
\#\#\# Path параметры  
| Параметр | Тип | Описание |  
|----------|-----|----------|  
  
\#\#\# Query параметры  
| Параметр | Тип | Default | Описание |  
|----------|-----|---------|----------|  
  
\#\#\# Body  
\`\`\`json  
\{  
  "field": "type — описание"  
\}

Response

200 OK

\{  
  "field": "type"  
\}

400 Bad Request

\{  
  "error": "описание"  
\}

404 Not Found

...

Пример

curl -X POST https://api.example.com/endpoint \\  
  -H "Authorization: Bearer token" \\  
  -d '\{"field": "value"\}'

  
\#\# Шаблон: Документация функции  
  
\`\`\`markdown  
\#\# Функция  
$Имя функции$  
  
\#\# Описание  
$Что делает функция — 1-2 предложения$  
  
\#\# Сигнатура  
\`\`\`python  
def function\_name(  
    param1: Type1,  
    param2: Type2 = default  
) -\> ReturnType:

Параметры

Возвращает

$Тип и описание возвращаемого значения$

Исключения

Примеры

\>\>\> function\_name(arg1, arg2)  
result  
  
\>\>\> function\_name(edge\_case)  
edge\_result

Заметки

$Особенности реализации, ограничения$