Использование пользовательских инструкций с GitHub Copilot в SQL Server Management Studio

Используйте функцию пользовательских инструкций для автоматического добавления настраиваемых, контекстных сведений в запросы. Copilot Chat использует эти инструкции для настройки ответов на основе ваших личных предпочтений.

Используйте файл .github/copilot-instructions.md

Чтобы использовать .github/copilot-instructions.md файл:

  1. Создайте или добавьте пользовательский файл инструкций с именем .github/copilot-instructions.md в корневом каталоге репозитория.

  2. Чтобы включить эту функцию, выберите "Включить загрузку пользовательских инструкций из файлов .github/copilot-instructions.md и добавить их в запросы в Инструменты>Параметры>GitHub>Copilot>Copilot Chat.

Пользовательские инструкции не отображаются в представлении чата или встроенном чате. Однако, когда Copilot использует .github/copilot-instructions.md файл, он перечисляет файл в списке ссылок ответа.

Включение инструкций на уровне пользователя

Помимо пользовательских инструкций для репозитория, вы можете определить параметры уровня пользователя, которые применяются ко всем сеансам Copilot. Параметры уровня пользователя сохраняются в %USERPROFILE%/copilot-instructions.md.

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

copilot-instructions.md Если файл не существует в %USERPROFILE% папке, его можно создать в этой папке.

Формат файла пользовательских инструкций

Пользовательские файлы инструкций — это файлы markdown (.md расширение файла) и содержат основные заголовки и подзаголовок для каждого определенного раздела.

Пример

# Copilot Instructions

## Persona
- I am a veteran SQL Server data professional with 20+ years of experience.
- Use a helpful, collegial tone. Keep explanations brief, but provide enough context to understand the code.
- Every so often, share a SQL or database-related fun fact or historical tidbit.

## Safety and execution guardrails
- Treat my database as a production database unless I explicitly state it's a dev or test environment.
- For any query that could scan large tables, include a cautious version first (TOP, date filter, or indexed predicate), but offer to give me the full version if I want it

## Code style
- Use tabs instead of spaces for indentation
- Always schema-qualify object names (e.g., dbo.Customer)
- Place JOIN conditions on separate lines
- Include header comments with author, date, parameters, change history and description for all stored procedures and functions
- Always qualify column names with table aliases
- Use short, readable aliases based on table name

## Naming conventions:
- Tables: PascalCase singular (Customer, Order, Product)
- Primary keys: <TableName>ID (CustomerID)
- Foreign keys: <ReferencedTable>ID
- Stored procedures: usp_<Action><Entity>
- Views: v_<Description>
- Functions: fn_<Description>