Налаштуйте відповіді GitHub Copilot Chat

Завершено

GitHub Copilot Chat може генерувати відповіді та код, які відповідають вашим практикам програмування та вимогам проєкту, якщо надати відповідний контекст. Замість того, щоб постійно додавати цю інформацію в кожен запит чату, ви можете зберігати цей контекст у файлах і автоматично включати його в кожен запит чату.

Існує три основні способи налаштування відповідей ШІ у Visual Studio Code:

  • Користувацькі інструкції: Визначте загальні правила для таких завдань, як генерація коду, виконання рев'ю коду або генерація повідомлень про коміти. Вони описують, як повинні виконуватися завдання, і можуть визначати методи кодування, бажані технології, правила безпеки або формати повідомлень комітів.

  • Файли командних рядків: визначайте багаторазово використовувані запити для типових завдань. Ці окремі підказки описують, що слід зробити, і можуть включати компоненти будівельних риштувань, виконання рев'ю коду, створення покрокових інструкцій або генерацію планів впровадження.

  • Користувацькі режими чату: визначте, як працює чат, які інструменти він може використовувати та як він взаємодіє з кодовою базою. Приклади включають режими планування з доступом лише для читання, режими досліджень, які отримують доступ до зовнішніх ресурсів, або режими для конкретних ролей, як-от front-end розробка.

Користувальницькі інструкції

За допомогою спеціальних інструкцій можна описати рекомендації, які отримують відповіді, що відповідають вашим конкретним практикам кодування та технологічному стеку. Замість того, щоб вручну включати цей контекст у кожен запит до чату, спеціальні інструкції автоматично включають цю інформацію до кожного запиту в чаті.

Note

Користувацькі інструкції не враховуються при доповненні коду.

Види користувальницьких інструкцій

Visual Studio Code підтримує три способи визначення власних інструкцій:

Type Description Випадки використання
.github/copilot-instructions.md Єдиний файл Markdown в робочій області, автоматично включений у всі запити, підтримка крос-редактора. Загальні практики кодування, бажані технології, вимоги до всього проекту.
.instructions.md files Кілька файлів Markdown з підтримкою шаблонів шаблонів-шаблонів, робочою областю або сховищем профілю користувача. Інструкції для конкретного завдання, детальний контроль за тим, коли інструкції застосовуються.
Налаштування Visual Studio Code Інструкції в налаштуваннях користувача/робочої області для конкретних сценаріїв. Генерація коду, генерація тестів, повідомлення про коміти, код-рев'ю, PR-описи.

Ви можете комбінувати ці підходи, але уникайте суперечливих інструкцій, оскільки порядок пріоритетів не застосовується.

Приклади користувальницьких інструкцій

Загальні рекомендації з кодування:

---
applyTo: "**"
---
# Project coding standards

## Naming Conventions
- Use PascalCase for component names, interfaces, and type aliases.
- Use camelCase for variables, functions, and methods.
- Prefix private class members with underscore (_).
- Use ALL_CAPS for constants.

## Error Handling
- Use try/catch blocks for async operations.
- Implement proper error boundaries in React components.
- Always log errors with contextual information.

Інструкції з TypeScript та React:

---
applyTo: "**/*.ts,**/*.tsx"
---
# TypeScript and React standards

Apply the [general coding guidelines](./general-coding.instructions.md) to all code.

## TypeScript Guidelines
- Use TypeScript for all new code.
- Follow functional programming principles where possible.
- Use interfaces for data structures and type definitions.
- Prefer immutable data (const, readonly).
- Use optional chaining (?.) and nullish coalescing (??) operators.

## React Guidelines
- Use functional components with hooks.
- Follow the React hooks rules (no conditional hooks).
- Use React.FC type for components with children.
- Keep components small and focused.
- Use CSS modules for component styling.

Використовуйте файл .github/copilot-instructions.md

Зберігайте власні інструкції у файлі .github/copilot-instructions.md в корені робочої області, щоб описати методи кодування, бажані технології та вимоги до проекту. Ці інструкції стосуються лише робочої області та автоматично включаються до кожного запиту в чаті.

Етапи налаштування:

  1. Перевірте, що github.copilot.chat.codeGeneration.useInstructionFiles увімкнено (за замовчуванням у останніх версіях Visual Studio Code).
  2. Create .github/copilot-instructions.md в робочому просторі root.
  3. Опишіть інструкції, використовуючи природну мову та формат Markdown.

Note

Цей файл працює для Visual Studio Code, Visual Studio та GitHub.com.

Використовуйте файли .instructions.md

Створюйте кілька .instructions.md файлів для конкретних завдань, мов програмування, фреймворків або типів проектів. Вони можуть бути автоматично застосовані на основі шаблонів файлів або вручну прикріплені до підказок чату.

Розташування файлів:

  • Файли робочої області: зберігаються в .github/instructions папці, доступні лише в межах робочої області.
  • User files: Зберігаються у Visual Studio Code профілі, доступні в кількох робочих просторах і синхронізовані через Settings Sync.

Структура файлу:

---
description: "Brief description of the instructions file"
applyTo: "**/*.ts,**/*.tsx"  # Glob pattern for automatic application
---
# Instructions content in Markdown format

Створення та використання файлів інструкцій:

  1. Запуск Chat: New Instructions File з палітри команд.
  2. Виберіть робочу область або місцезнаходження користувача.
  3. Введіть ім'я та інструкції автора в Markdown.
  4. Використовується Chat: Configure Instructions для редагування існуючих файлів.

Ручне кріплення:

  • У режимі чату: Додайте контекстні > інструкції
  • Палітра команд: Chat: Attach Instructions

Автоматичне застосування: використовуйте applyTo метадані з шаблонами-замінниками (** для всіх запитів, конкретні шаблони для цільового застосування)

Вкажіть кастомні інструкції в налаштуваннях

Налаштуйте власні інструкції в налаштуваннях Visual Studio Code для конкретних сценаріїв:

Scenario Setting
Генерація коду github.copilot.chat.codeGeneration.instructions
Генерація тестів github.copilot.chat.testGeneration.instructions
Перегляд коду github.copilot.chat.reviewSelection.instructions
Повідомлення про внески github.copilot.chat.commitMessageGeneration.instructions
PR назви/описи github.copilot.chat.pullRequestDescriptionGeneration.instructions

Визначте інструкції як текстові або довідкові зовнішні файли:

"github.copilot.chat.codeGeneration.instructions": [
  {
    "text": "Always add a comment: 'Generated by Copilot'."
  },
  {
    "text": "In TypeScript always use underscore for private field names."
  },
  {
    "file": "general.instructions.md"
  },
  {
    "file": "db.instructions.md"
  }
]

Практичні поради щодо користувацьких інструкцій

  • Дотримуйтесь стислості інструкцій: кожна інструкція має бути єдиним простим твердженням.
  • Уникайте зовнішніх посилань: не посилайтеся на зовнішні стандарти кодування або ресурси.
  • Упорядкування за темами: розділіть інструкції на кілька файлів для кращої організації.
  • Увімкнути спільний доступ до команди: зберігайте інструкції у файлах із керуванням версіями для співпраці в команді.
  • Використовувати цільову програму: властивість Leverage applyTo для інструкцій для конкретного файлу.
  • Ефективне посилання: посилайтеся на користувацькі інструкції у файлах запитів, щоб уникнути дублювання.

Запитувати файли

Файли запитів — це багаторазові окремі завдання, які зберігаються як .prompt.md файли. На відміну від кастомних інструкцій — які описують how GitHub Copilot має відповідати — файли запитів описують що слід виконувати для конкретного завдання. Ви запускаєте їх на вимогу, а не автоматично застосовуєте їх до кожного запиту.

Файли запитів добре підходять для повторюваних робочих процесів кодування Vibe: створення нового компонента, створення першого чернетки документа з вимогами до продукту, запуску перегляду коду або запуску сесії з уже завантаженим контекстом проєкту.

Створити файл із запитом

Зберігайте файли запитів у .github/prompts/ папці у вашому робочому просторі. Ім'я файлу стає ім'ям запиту.

Структура файлу:

---
mode: "ask"
description: "Generate a product requirements document for a new feature"
---
# Generate a PRD

Create a product requirements document for the described feature.

Include the following sections:
- Product summary
- Target audience
- Core features (prioritized by must-have / should-have / could-have)
- Out of scope
- Technical requirements

Feature description: ${input:Feature description}

Запустити файл запитів

  • Командна палітра: Запустити Chat: Run Prompt і вибрати файл.
  • Введення чату: Введіть # перегляд чату та виберіть файл запитів за назвою.

Файли запитів підтримують mode значення ask, edit, та agent. Вони також можуть посилатися на ваші кастомні інструкційні файли, використовуючи синтаксис посилань Markdown, щоб уникнути дублювання вмісту між файлами.

Кастомні чат-режими

Власні режими чату дозволяють налаштувати, як працює панель Copilot Chat на GitHub для конкретного робочого процесу. Ви визначаєте, які інструменти доступні, як ШІ взаємодіє з вашою кодовою базою і яку роль він має відігравати — без змін власних інструкцій.

Для кодування вібрації це особливо корисно для відокремлення фази планування від етапу будівництва . Режим планування може обмежити GitHub Copilot лише аналізом лише для читання, тому він пропонує дизайни без змін, тоді як режим реалізації відкриває повні інструменти редагування.

Створіть власний чат-режим

Зберігайте власні файли чату в .github/chatmodes/ папці у вашому робочому просторі.

Структура файлу:

---
description: "Plan mode: read-only analysis and architecture decisions"
tools: []
---
You are a software architect in planning mode. Analyze the codebase, identify patterns, suggest designs, and answer questions — but do not make any code changes.

Поширені конфігурації чату для кодування vibe:

Режим Інструмент Приклад використання
Планування Немає (лише для читання) Архітектурні рішення, дизайн функцій, огляд PRD
Довідкові матеріали Веб-пошук Дослідження бібліотек, порівняння підходів
Упровадження Повний доступ до інструментів Написання та редагування коду, виконання команд
Перевірити Лише для читання Огляд коду, аудит безпеки, перевірка продуктивності

Використовуйте власний чат

Виберіть режим у виборі чату в панелі інструментів Чат-режим. Режим зберігається протягом сесії, поки ви не переключитеся.

Summary

Налаштування відповідей GitHub Copilot дозволяє налаштувати AI-допомогу відповідно до вашого робочого процесу. Власні інструкції — використовуючи файли .github/copilot-instructions.md, файли .instructions.md або Visual Studio Code налаштування — визначають how GitHub Copilot мають відповідати, кодуючи ваші практики, стандарти та вподобання у програмуванні. Файли запитів визначають, що слід робити для повторюваних завдань, надаючи вам повторні підказки, які можна запускати на вимогу. Власні режими чату налаштовують, як працює чат-сесія, дозволяючи перемикатися між плануванням, дослідженнями, впровадженням і переглядом робочих процесів без зміни базових інструкцій. Разом ці три інструменти допомагають створити послідовне середовище для програмування атмосфери, де GitHub Copilot розуміє ваш проєкт з самого початку.