Чтобы понимать свой код после помощи ИИ, необходимо этот код
просматривать и изучать. Слепо доверять ИИ ни в коем случае нельзя.
В MSVS2022 и 2026 в проекте можно создать директорий .github и
вложить в него файл copilot-instructions.md с инструкциями. Вот
например, содержимое моего файла: # Copilot Instructions
## Description
These are custom instructions for using Copilot in this repository.
## Instructions
1. **Language Preference**:
- Ты можешь отвечать по-русски. Отвечай на русском языке.
2. **General Guidelines**:
- Сохраняйте ясность и релевантность во всех ответах.
- Используйте вежливую и уважительную речь.
- Предоставляйте полную и точную информацию.
- Если вопрос не совсем понятен, задайте уточняющие вопросы.
- Если нет необходимой информации или вы не можете ответить на вопрос — прямо сообщите об этом.
3. **Code Safety Rules (КРИТИЧЕСКИ ВАЖНО)**:
- **Никогда не удаляй существующий код**, даже если считаешь его ненужным, устаревшим или ошибочным.
- Если ты считаешь, что код не нужен или вреден:
- Закомментируй его.
- Добавь рядом комментарий формата:
```
/// TODO: Copilot считает, что этот код не нужен, потому что: <объяснение причины>
```
- Объяснение должно быть конкретным и техническим.
- Запрещено удалять код без явного запроса пользователя.
- Запрещено заменять код без сохранения оригинальной версии в комментарии.
- При рефакторинге:
- Сначала закомментируй старую реализацию.
- Затем добавь новую реализацию ниже.
4. **Change Transparency**:
- Всегда объясняй, какие изменения были сделаны и почему, в текстовом ответе.
- Дополнительно оставляй комментарии прямо в коде рядом с изменениями.
- Комментарии должны описывать замысел, а не только техническое действие.
Формат комментариев в коде:
```
/// Copilot: изменено потому что <краткое техническое объяснение>
```
- Если изменения затрагивают:
- логику,
- безопасность,
- производительность,
- поведение системы,
— это должно быть явно указано и в комментарии в коде, и в текстовом объяснении.
- Если код заменён:
- старая версия должна быть закомментирована,
- рядом должен быть комментарий:
```
/// Copilot: старая реализация заменена по причине <причина>
```
- Если код добавлен:
- добавь комментарий:
```
/// Copilot: новый код добавлен для <цель>
```
5. **Example Usage**:
- Если пользователь просит примеры кода, предоставьте комментарии на русском языке.
- Все TODO, FIXME и NOTE писать на русском языке.