Этот быстрый старт проводит вас через настройку GitHub Copilot репозитория. К концу вы Copilot будете знать конвенции вашего проекта, иметь специализированного агента для обычных задач и курировать контекст проекта.
**Сценарий:** Вы работаете над репозиторием веб-приложений команды с установленным тестовым набором, кодовыми нормами и активными проблемами. Вы хотите Copilot эффективно работать с кодовой базой с первого дня.
Необходимые условия
- План Copilot , включающий Copilot облачный агент (GitHub Copilot Pro+, Copilot Business, или Копилот Энтерпрайз). Дополнительные сведения см. в разделе Планы по GitHub Copilot.
- Облачный агент Включено для вашей организации или аккаунта. Дополнительные сведения см. в разделе Управление доступом к облачному агенту GitHub Copilot.
- Запишите доступ к GitHub репозиторию.
Шаг 1: Обучайте Copilot конвенциям вашего проекта
Пользовательские инструкции репозитория дают Copilot постоянный контекст вашего проекта — его структуру, стандарты кодирования и способы создания и тестирования кода. Каждое Copilot взаимодействие в репозитории использует эти инструкции автоматически.
Попросите Copilot облачный агент сгенерировать copilot-instructions.md файл:
-
Иди на github.com/copilot/agents.
-
Выберите свой репозиторий из выпадающего меню в поле запросов.
-
Введите следующий запрос:
Text Onboard this repository to Copilot cloud agent by adding a .github/copilot-instructions.md file. Include information about project structure, coding conventions, the test framework, and how to build and run the project.
Onboard this repository to Copilot cloud agent by adding a .github/copilot-instructions.md file. Include information about project structure, coding conventions, the test framework, and how to build and run the project. -
Просмотрите сгенерированный файл и объедините pull request.
Copilot Теперь понимает каноны вашего проекта в чате, обзоре кода и сессиях с агентами. См [. раздел AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions).
Шаг 2: Создайте специализированного агента
Пользовательские агенты Это позволяет создавать специализированных помощников для повторяющихся задач. В этом примере создайте агент, который диагностирует и исправляет ошибки.
-
Зайдите в github.com/copilot/agents и выберите свой репозиторий.
-
В поле запроса нажмите . Затем нажмите Создать пользовательского агента.
-
Переименуйте файл в
bug-fixer.agent.md. -
Замените содержимое шаблона на:
YAML --- name: Bug Fixer description: Diagnoses and fixes bugs reported in GitHub issues. tools: - read - edit - terminal - search --- You are a bug-fixing specialist. When given a bug report or issue: 1. Reproduce the bug by writing a failing test. 2. Identify the root cause. 3. Fix the code. 4. Verify the fix passes the test and doesn't break existing tests. Always follow the project's testing conventions and coding standards.
--- name: Bug Fixer description: Diagnoses and fixes bugs reported in GitHub issues. tools: - read - edit - terminal - search --- You are a bug-fixing specialist. When given a bug report or issue: 1. Reproduce the bug by writing a failing test. 2. Identify the root cause. 3. Fix the code. 4. Verify the fix passes the test and doesn't break existing tests. Always follow the project's testing conventions and coding standards. -
Зафиксируйте файл и объедините его в стандартную ветку.
Ваш агент исправления багов теперь отображается в выпадающем меню агентов на вкладке агентов. Выберите его перед вставкой URL проблемы, чтобы начать целенаправленную отладочную сессию. См . раздел AUTOTITLE.
Шаг 3: Организуйте контекст проекта с помощью пространства
Пространства второпилотов Это позволяет вам выбрать точные контекстные Copilot потребности для конкретной области вашего проекта. Ответы основаны на соответствующих файлах, проблемах и документации.
-
Перейдите в github.com/copilot/spaces и нажмите Создать пространство.
-
Назовите пространство (например, «API Architecture») и выберите владельца.
-
Нажмите «Добавить источники», затем добавьте контекст, релевантный для вашего проекта:
<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-file-code" aria-label="file-code" role="img"><path d="M4 1.75C4 .784 4.784 0 5.75 0h5.586c.464 0 .909.184 1.237.513l2.914 2.914c.329.328.513.773.513 1.237v8.586A1.75 1.75 0 0 1 14.25 15h-9a.75.75 0 0 1 0-1.5h9a.25.25 0 0 0 .25-.25V6h-2.75A1.75 1.75 0 0 1 10 4.25V1.5H5.75a.25.25 0 0 0-.25.25v2.5a.75.75 0 0 1-1.5 0Zm1.72 4.97a.75.75 0 0 1 1.06 0l2 2a.75.75 0 0 1 0 1.06l-2 2a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734l1.47-1.47-1.47-1.47a.75.75 0 0 1 0-1.06ZM3.28 7.78 1.81 9.25l1.47 1.47a.751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018l-2-2a.75.75 0 0 1 0-1.06l2-2a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042Zm8.22-6.218V4.25c0 .138.112.25.25.25h2.688l-.011-.013-2.914-2.914-.013-.011Z"></path></svg> Добавляйте файлы и репозитории** — добавляйте архитектурную документацию, схемы API или файлы конфигурации ключей.
<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link" aria-label="link" role="img"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> Файлы ссылок, pull requests и issues** — вставляйте URL-адреса для активных проблем или обсуждений дизайна. -
В чате пространства задайте вопрос вроде: «Какие шаблоны использует наш API для обработки ошибок?»
Copilot Отвечайте только на тот контекст, который вы выбрали. См [. раздел AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/copilot-spaces/create-copilot-spaces).
Дальнейшие действия
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-personal-instructions)** — Установите личные предпочтения, которые применимы ко всем вашим репозиториям.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills)** — Добавьте новые возможности своим агентам.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/extend-cloud-agent-with-mcp)** — Подключать агентов к внешним инструментам и сервисам.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/copilot-spaces/collaborate-with-others)** — Делитесь своими местами с товарищами по команде.