From 787a5a013fa0bd9854de41e076aa5d2fd4278b58 Mon Sep 17 00:00:00 2001 From: Nikolay Gagarinov Date: Thu, 14 May 2026 16:09:27 +0500 Subject: [PATCH 1/2] Add learning prompts section: good vs bad Copilot questions - Add main principle blockquote: ask Copilot to explain, not to write - Replace abstract tips with concrete prompt templates organized by situation: failing tests, code errors, unknown concepts, pre-review, unknown starting point, testing track (QA), test-case review - Add two actionable tips: what to do when Copilot gives ready code, how to ask for simpler explanations Co-Authored-By: Claude Sonnet 4.6 --- ...a-resheniya-problem-v-uchebnyh-proektah.md | 71 ++++++++++++++++-- ...a-resheniya-problem-v-uchebnyh-proektah.md | 73 +++++++++++++++++-- 2 files changed, 130 insertions(+), 14 deletions(-) diff --git a/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md b/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md index 3ab75dd..84da0e5 100644 --- a/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md +++ b/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md @@ -15,6 +15,8 @@ title: "Как использовать GitHub Copilot для решения п Этот инструмент особенно полезен при работе над учебными проектами: он не решает задачи за вас, но подсказывает, куда смотреть и как думать. Всё как у хорошего преподавателя: не даёт готовый ответ, а помогает дойти до него самому. +> **Главное правило:** просите Copilot **объяснять**, а не **писать**. Если вы просите написать код — вы не учитесь. Если просите объяснить — учитесь. Разница в формулировке вопроса. + *В некоторых странах Copilot может не работать без VPN.* ## Чем Copilot может быть полезен @@ -257,15 +259,68 @@ Copilot может объяснить, на каком этапе произош 7. **Получите рекомендации** — Copilot проанализирует тест-кейсы и предложит улучшения. -## Как эффективно учиться с Copilot +## Как задавать вопросы Copilot: готовые промпты + +Главное отличие: хорошие вопросы просят *понять*, плохие — *получить ответ*. + +### Тест не проходит + +**Плохо:** «Напиши код, чтобы тест прошёл» + +**Хорошо:** +> Объясни, что именно проверяет этот тест. Что должен возвращать мой код, чтобы тест прошёл? Не пиши решение — помоги понять, в чём проблема. + +--- + +### Ошибка в коде или в терминале + +**Плохо:** «Исправь эту ошибку» + +**Хорошо:** +> Объясни, что означает эта ошибка. Что именно пошло не так и почему? Покажи похожий пример правильного кода, но не исправляй мой. + +--- + +### Не понимаю концепцию + +**Плохо:** «Напиши пример с замыканием» + +**Хорошо:** +> Объясни [концепцию] простыми словами, без кода. Потом покажи минимальный пример. Что произошло бы, если бы этого механизма не было? + +--- + +### Перед отправкой кода на проверку + +**Плохо:** «Улучши мой код» + +**Хорошо:** +> Проверь мой код: понятны ли имена переменных? Есть ли дублирование? Соответствует ли он принципу единственной ответственности? Объясни каждое замечание — не переписывай код. + +--- + +### Не знаю, с чего начать задачу + +**Плохо:** «Как решить эту задачу?» + +**Хорошо:** +> Какие шаги нужно сделать, чтобы решить задачу [описание]? Не пиши код — только план действий. Потом я попробую сам. + +--- + +### Если вы изучаете тестирование + +**Плохо:** «Напиши тест-кейс для этой функции» + +**Хорошо:** +> Какие граничные случаи я мог упустить для функции [описание]? Перечисли ситуации для проверки — тест-кейсы я напишу сам. + +--- -Вот несколько приёмов, которые помогут развиваться быстрее: +### Ревью тест-кейсов (для тестировщиков) -- Ошибка в коде: попросите объяснить, где ошибка и как она влияет -- Тест не проходи: спросите, почему он падает и что можно изменить -- Непонятный термин: попросите разъяснить — ИИ умеет объяснять просто -- Не знаете, с чего начать: сформулируйте вопрос: "Как подойти к этой задаче?" -- Перед отправкой на ревью: запустите ревью в Copilot, он подскажет, что поправить +**Хорошо:** +> Проверь мои тест-кейсы по этим критериям: [вставь чеклист]. Что нарушено? Объясни каждое замечание. **Copilot не решает задачи за студента** @@ -283,6 +338,8 @@ Copilot — это **не решатель задач**. Он помогает - Уточняйте, если объяснение непонятное. - Проверяйте ответы. Copilot может ошибаться. - Используйте его как наставника, а не как копипасту. +- **Если Copilot дал готовый код** — попросите объяснить каждую строку и удалите код. Потом напишите сами. +- **Если ответ непонятен** — скажите: «Объясни проще, как будто мне 10 лет» или «Дай аналогию из жизни». ## Вывод diff --git a/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md b/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md index 154a7b4..6372950 100644 --- a/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md +++ b/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md @@ -6,6 +6,8 @@ title: "Чем Copilot может быть полезен" Этот инструмент особенно полезен при работе над учебными проектами: он не решает задачи за вас, но подсказывает, куда смотреть и как думать. Всё как у хорошего преподавателя: не даёт готовый ответ, а помогает дойти до него самому. +> **Главное правило:** просите Copilot **объяснять**, а не **писать**. Если вы просите написать код — вы не учитесь. Если просите объяснить — учитесь. Разница в формулировке вопроса. + *В некоторых странах Copilot может не работать без VPN.* ## Чем Copilot может быть полезен @@ -234,13 +236,68 @@ Copilot может объяснить, на каком этапе произош Вот несколько приёмов, которые помогут развиваться быстрее: -| Задача | Что делать с Copilot | -|--------------------------|--------------------------------------------------------| -| Ошибка в коде | Попросите объяснить, где ошибка и как она влияет | -| Тест не проходит | Спросите, почему он падает и что можно изменить | -| Непонятный термин | опросите разъяснить — ИИ умеет объяснять просто | -| Не знаете, с чего начать | Сформулируйте вопрос: "Как подойти к этой задаче?" | -| Перед отправкой на ревью | Запустите ревью в Copilot, он подскажет, что поправить | +## Как задавать вопросы Copilot: готовые промпты + +Главное отличие: хорошие вопросы просят *понять*, плохие — *получить ответ*. + +### Тест не проходит + +**Плохо:** «Напиши код, чтобы тест прошёл» + +**Хорошо:** +> Объясни, что именно проверяет этот тест. Что должен возвращать мой код, чтобы тест прошёл? Не пиши решение — помоги понять, в чём проблема. + +--- + +### Ошибка в коде или в терминале + +**Плохо:** «Исправь эту ошибку» + +**Хорошо:** +> Объясни, что означает эта ошибка. Что именно пошло не так и почему? Покажи похожий пример правильного кода, но не исправляй мой. + +--- + +### Не понимаю концепцию + +**Плохо:** «Напиши пример с замыканием» + +**Хорошо:** +> Объясни [концепцию] простыми словами, без кода. Потом покажи минимальный пример. Что произошло бы, если бы этого механизма не было? + +--- + +### Перед отправкой кода на проверку + +**Плохо:** «Улучши мой код» + +**Хорошо:** +> Проверь мой код: понятны ли имена переменных? Есть ли дублирование? Соответствует ли он принципу единственной ответственности? Объясни каждое замечание — не переписывай код. + +--- + +### Не знаю, с чего начать задачу + +**Плохо:** «Как решить эту задачу?» + +**Хорошо:** +> Какие шаги нужно сделать, чтобы решить задачу [описание]? Не пиши код — только план действий. Потом я попробую сам. + +--- + +### Если вы изучаете тестирование + +**Плохо:** «Напиши тест-кейс для этой функции» + +**Хорошо:** +> Какие граничные случаи я мог упустить для функции [описание]? Перечисли ситуации для проверки — тест-кейсы я напишу сам. + +--- + +### Ревью тест-кейсов (для тестировщиков) + +**Хорошо:** +> Проверь мои тест-кейсы по этим критериям: [вставь чеклист]. Что нарушено? Объясни каждое замечание. ## Copilot не решает задачи за студента @@ -259,6 +316,8 @@ Copilot — это **не решатель задач**. Он помогает * **Уточняйте**, если объяснение непонятное. * **Проверяйте ответы.** Copilot может ошибаться. * **Используйте его как наставника**, а не как копипасту. +* **Если Copilot дал готовый код** — попросите объяснить каждую строку и удалите код. Потом напишите сами. +* **Если ответ непонятен** — скажите: «Объясни проще, как будто мне 10 лет» или «Дай аналогию из жизни». # Вывод From f85a7ba5e6bfb3fe687a016dfcf370648f5d665a Mon Sep 17 00:00:00 2001 From: Nikolay Gagarinov Date: Thu, 14 May 2026 16:40:11 +0500 Subject: [PATCH 2/2] Use AGENTS.md as default Copilot instruction file, improve mentor prompts - Replace .github-instructions.md with AGENTS.md (Copilot reads it automatically) - Remove VS Code settings step (not needed for AGENTS.md) - Replace generic "respond in Russian" prompt with a pedagogical mentor prompt: never write ready code, explain instead, ask guiding questions - Update Personal Instructions prompt on GitHub with same mentor approach Co-Authored-By: Claude Sonnet 4.6 --- ...a-resheniya-problem-v-uchebnyh-proektah.md | 30 ++++++++++++------- ...a-resheniya-problem-v-uchebnyh-proektah.md | 28 +++++++++++------ 2 files changed, 38 insertions(+), 20 deletions(-) diff --git a/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md b/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md index 84da0e5..763c273 100644 --- a/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md +++ b/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md @@ -45,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 будет давать пояснения, а не просто подставлять код. @@ -188,7 +196,7 @@ GitHub Copilot интегрирован в сайт GitHub, что позвол - Нажмите на многоточие и выберите **Personal Instructions**. - В поле инструкций напишите текст, например: - > Пожалуйста, отвечай мне на русском языке. Объясняй все понятия максимально просто и подробно. Используй примеры, чтобы я лучше понял. + > Ты — наставник, который помогает мне учиться программированию. Не пиши готовые решения — вместо этого объясняй, задавай наводящие вопросы и давай подсказки, чтобы я дошёл до ответа сам. Если я прошу написать код — откажи и спроси, что именно мне непонятно. Отвечай на русском языке. - Сохраните изменения. Теперь Copilot будет предоставлять ответы на русском языке, объясняя понятия подробно и с примерами, чтобы вам было проще разобраться. diff --git a/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md b/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md index 6372950..d23e2d1 100644 --- a/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md +++ b/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md @@ -36,18 +36,28 @@ GitHub Copilot можно использовать как в редакторе, ![sign in copilot vscode](/img/docs/img-152.png) -### Индивидуальные инструкции для Copilot +### Инструкции для Copilot через AGENTS.md -Чтобы Copilot отвечал и помогал как наставник, необходимо создать файл с инструкциями. +Copilot автоматически читает файл `AGENTS.md` в корне репозитория — дополнительных настроек не нужно. В репозиториях Hexlet этот файл уже присутствует. Добавьте в него раздел с инструкциями наставника: -1. Создайте файл *.github-instructions.md* и напишите в нём: - ```text - Пожалуйста, отвечай мне на русском языке и максимально просто. Объясняй все понятия, которые могут быть непонятными. Используй примеры и аналогии, чтобы я лучше понял. Моя цель — научиться использовать [здесь вставь то, чему хочешь научиться: например, программирование, Docker, Git] на практике. Дай пошаговые инструкции и объяснения. Если я задаю вопросы — отвечай с учетом моего текущего уровня (начальный/средний/продвинутый). Спасибо! - ``` +```markdown +## Режим наставника (Copilot) + +Ты — наставник, который помогает мне учиться программированию. Твоя задача — научить меня думать самостоятельно, а не решать задачи вместо меня. + +Правила: +- Никогда не пиши готовый код для решения моей задачи. Объясни, что нужно сделать, и дай мне написать самому. +- Если я не понимаю ошибку — объясни, что она означает и почему возникла. Не исправляй — объясняй. +- Если я прошу написать решение — откажи и спроси: «Что ты уже пробовал? Какой шаг кажется непонятным?» +- Используй аналогии из жизни для объяснения абстрактных концепций. +- Если мой код почти правильный — скажи, что именно хорошо, и дай подсказку по тому, что нужно исправить. +- Задавай уточняющие вопросы, если моя проблема непонятна. +- Отвечай на русском языке, просто и понятно. -2. Откройте настройки и проверьте, что файл с инструкциями используется. Найти настройку можно по названию `github.copilot.chat.codeGeneration.useInstructionFiles` +Моя цель — научиться писать и понимать код самостоятельно. +``` -![vscode settings custom instructions](/img/docs/img-153.png) +Если файла `AGENTS.md` нет — создайте его в корне проекта с этим содержимым. Так Copilot будет давать пояснения, а не просто подставлять код. @@ -169,7 +179,7 @@ GitHub Copilot интегрирован в сайт GitHub, что позвол * Нажмите на многоточие и выберите **Personal Instructions**. * В поле инструкций напишите текст, например: ```text - Пожалуйста, отвечай мне на русском языке. Объясняй все понятия максимально просто и подробно. Используй примеры, чтобы я лучше понял. + Ты — наставник, который помогает мне учиться программированию. Не пиши готовые решения — вместо этого объясняй, задавай наводящие вопросы и давай подсказки, чтобы я дошёл до ответа сам. Если я прошу написать код — откажи и спроси, что именно мне непонятно. Отвечай на русском языке. ``` * Сохраните изменения.