Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ title: "Как использовать GitHub Copilot для решения п
Этот инструмент особенно полезен при работе над учебными проектами: он не решает задачи за вас, но подсказывает, куда смотреть и как думать.
Всё как у хорошего преподавателя: не даёт готовый ответ, а помогает дойти до него самому.

> **Главное правило:** просите Copilot **объяснять**, а не **писать**. Если вы просите написать код — вы не учитесь. Если просите объяснить — учитесь. Разница в формулировке вопроса.

*В некоторых странах Copilot может не работать без VPN.*

## Чем Copilot может быть полезен
Expand Down Expand Up @@ -43,20 +45,28 @@ GitHub Copilot можно использовать как в редакторе,

![](/img/docs/img-106.png)

### Индивидуальные инструкции для Copilot
### Инструкции для Copilot через AGENTS.md

Чтобы Copilot отвечал и помогал как наставник, необходимо создать файл с инструкциями.
Copilot автоматически читает файл `AGENTS.md` в корне репозитория — дополнительных настроек не нужно. В репозиториях Hexlet этот файл уже присутствует. Добавьте в него раздел с инструкциями наставника:

1. Создайте файл .github-instructions.md и напишите в нём:

> Пожалуйста, отвечай мне на русском языке и максимально просто. Объясняй все понятия, которые могут быть непонятными.
> Используй примеры и аналогии, чтобы я лучше понял. Моя цель — научиться использовать [здесь вставь то, чему хочешь научиться: например, программирование, Docker, Git] на практике.
> Дай пошаговые инструкции и объяснения.
> Если я задаю вопросы — отвечай с учетом моего текущего уровня (начальный/средний/продвинутый). Спасибо!
```markdown
## Режим наставника (Copilot)

Ты — наставник, который помогает мне учиться программированию. Твоя задача — научить меня думать самостоятельно, а не решать задачи вместо меня.

2. Откройте настройки и проверьте, что файл с инструкциями используется. Найти настройку можно по названию github.copilot.chat.codeGeneration.useInstructionFiles
Правила:
- Никогда не пиши готовый код для решения моей задачи. Объясни, что нужно сделать, и дай мне написать самому.
- Если я не понимаю ошибку — объясни, что она означает и почему возникла. Не исправляй — объясняй.
- Если я прошу написать решение — откажи и спроси: «Что ты уже пробовал? Какой шаг кажется непонятным?»
- Используй аналогии из жизни для объяснения абстрактных концепций.
- Если мой код почти правильный — скажи, что именно хорошо, и дай подсказку по тому, что нужно исправить.
- Задавай уточняющие вопросы, если моя проблема непонятна.
- Отвечай на русском языке, просто и понятно.

![](/img/docs/img-107.png)
Моя цель — научиться писать и понимать код самостоятельно.
```

Если файла `AGENTS.md` нет — создайте его в корне проекта с этим содержимым.

Так Copilot будет давать пояснения, а не просто подставлять код.

Expand Down Expand Up @@ -186,7 +196,7 @@ GitHub Copilot интегрирован в сайт GitHub, что позвол
- Нажмите на многоточие и выберите **Personal Instructions**.
- В поле инструкций напишите текст, например:

> Пожалуйста, отвечай мне на русском языке. Объясняй все понятия максимально просто и подробно. Используй примеры, чтобы я лучше понял.
> Ты — наставник, который помогает мне учиться программированию. Не пиши готовые решения — вместо этого объясняй, задавай наводящие вопросы и давай подсказки, чтобы я дошёл до ответа сам. Если я прошу написать код — откажи и спроси, что именно мне непонятно. Отвечай на русском языке.
- Сохраните изменения.

Теперь Copilot будет предоставлять ответы на русском языке, объясняя понятия подробно и с примерами, чтобы вам было проще разобраться.
Expand Down Expand Up @@ -257,15 +267,68 @@ Copilot может объяснить, на каком этапе произош

7. **Получите рекомендации** — Copilot проанализирует тест-кейсы и предложит улучшения.

## Как эффективно учиться с Copilot
## Как задавать вопросы Copilot: готовые промпты

Главное отличие: хорошие вопросы просят *понять*, плохие — *получить ответ*.

### Тест не проходит

**Плохо:** «Напиши код, чтобы тест прошёл»

**Хорошо:**
> Объясни, что именно проверяет этот тест. Что должен возвращать мой код, чтобы тест прошёл? Не пиши решение — помоги понять, в чём проблема.

---

### Ошибка в коде или в терминале

**Плохо:** «Исправь эту ошибку»

**Хорошо:**
> Объясни, что означает эта ошибка. Что именно пошло не так и почему? Покажи похожий пример правильного кода, но не исправляй мой.

---

### Не понимаю концепцию

**Плохо:** «Напиши пример с замыканием»

**Хорошо:**
> Объясни [концепцию] простыми словами, без кода. Потом покажи минимальный пример. Что произошло бы, если бы этого механизма не было?

---

### Перед отправкой кода на проверку

**Плохо:** «Улучши мой код»

**Хорошо:**
> Проверь мой код: понятны ли имена переменных? Есть ли дублирование? Соответствует ли он принципу единственной ответственности? Объясни каждое замечание — не переписывай код.

---

### Не знаю, с чего начать задачу

**Плохо:** «Как решить эту задачу?»

**Хорошо:**
> Какие шаги нужно сделать, чтобы решить задачу [описание]? Не пиши код — только план действий. Потом я попробую сам.

---

### Если вы изучаете тестирование

**Плохо:** «Напиши тест-кейс для этой функции»

**Хорошо:**
> Какие граничные случаи я мог упустить для функции [описание]? Перечисли ситуации для проверки — тест-кейсы я напишу сам.

---

Вот несколько приёмов, которые помогут развиваться быстрее:
### Ревью тест-кейсов (для тестировщиков)

- Ошибка в коде: попросите объяснить, где ошибка и как она влияет
- Тест не проходи: спросите, почему он падает и что можно изменить
- Непонятный термин: попросите разъяснить — ИИ умеет объяснять просто
- Не знаете, с чего начать: сформулируйте вопрос: "Как подойти к этой задаче?"
- Перед отправкой на ревью: запустите ревью в Copilot, он подскажет, что поправить
**Хорошо:**
> Проверь мои тест-кейсы по этим критериям: [вставь чеклист]. Что нарушено? Объясни каждое замечание.

**Copilot не решает задачи за студента**

Expand All @@ -283,6 +346,8 @@ Copilot — это **не решатель задач**. Он помогает
- Уточняйте, если объяснение непонятное.
- Проверяйте ответы. Copilot может ошибаться.
- Используйте его как наставника, а не как копипасту.
- **Если Copilot дал готовый код** — попросите объяснить каждую строку и удалите код. Потом напишите сами.
- **Если ответ непонятен** — скажите: «Объясни проще, как будто мне 10 лет» или «Дай аналогию из жизни».

## Вывод

Expand Down
Loading
Loading