Кодовая база — это ресурс проекта, который определяет исходный код и рабочую среду для разработки. Она может подключать локальную рабочую копию, зеркало GitHub или и то и другое. Агенты используют этот контекст для разрешённого изучения кода, программирования и операций Git.
Это отличается от загрузки фрагмента кода в качестве знаний. Справочный документ помогает понять систему, а кодовая база связывает работу с файлами и репозиторием, в которых вносятся изменения.
Выберите подходящий ресурс
| Ресурс | Для чего использовать | Чего он не обеспечивает |
|---|---|---|
| Документ или источник знаний | Спецификации, заметки об архитектуре, примеры и справочные материалы | Готовую к запуску рабочую копию репозитория или разрешение изменять репозиторий |
| Зеркало GitHub | Контекст кода из репозитория и поддерживаемую работу с GitHub | Локальную рабочую копию или онлайн-среду программирования само по себе |
| Локальная рабочая копия | Файлы кода в подключённой среде выполнения | Разрешение каждому агенту или каждому компьютеру редактировать их |
| Кодовая база с обоими вариантами | Связь рабочей копии с контекстом репозитория | Автоматическую синхронизацию или разрешение на push без решения по результатам проверки |
Подключение репозитория и работающая среда — разные вещи. Если запрошенная среда выполнения недоступна или не настроена, запросите недостающее условие, а не предполагайте, что агент может запустить тесты где-то ещё.
Откройте форму подключения кодовой базы
- Откройте нужный проект.
- Выберите Data (Данные).
- Откройте New resource (Новый ресурс).
- Выберите Codebase (Кодовая база).
- Изучите форму Connect codebase (Подключить кодовую базу).
В проверенной форме отображались поля Local working copy (Локальная рабочая копия), GitHub mirror (Зеркало GitHub) и Name (Название). В учётной записи для документации оба списка выбора были пустыми, а кнопка Connect (Подключить) была недоступна. При этой проверке репозиторий или компьютер не подключали.
Текущий исходный код поддерживает выбор допустимой папки рабочей копии, зеркала GitHub или обоих вариантов с последующим сохранением подключения. Локальная рабочая копия должна быть доступна через соответствующую подключённую среду. Не вводите чужую папку или учётные данные, чтобы появился отсутствующий вариант.
Задайте ограниченную первую задачу
Начните с задачи только на чтение, чтобы проверить выбранный контекст:
Изучи подключённую кодовую базу этого проекта. Укажи репозиторий или рабочую копию, текущую ветку и состояние рабочего дерева, а также команду запуска тестов из документации проекта. Не редактируй файлы, не устанавливай зависимости, не создавай коммиты и не выполняй push.
Затем поручите подходящему агенту команды конкретное изменение:
В этой кодовой базе реализуй [конкретное изменение]. Сохрани посторонние локальные изменения, запусти соответствующие тесты и верни сводку различий и результаты тестов для проверки. Не выполняй push или развёртывание.
Это примеры заданий, а не утверждение, что процесс разработки выполнялся в демонстрации. Прежде чем полагаться на отчёт агента, проверьте фактический результат его инструмента и среду.
Назначьте подходящего редактора
В текущей реализации редакторы кодовой базы назначаются явно из текущей команды проекта. Руководитель проекта (PM) в этой модели обязательно входит в число редакторов, однако его задача по-прежнему состоит в координации и проверке работы специализированных агентов. Возможность быть редактором не означает, что руководитель должен сам выполнять всё программирование.
У локальной рабочей копии также есть владелец. Доступные пользователю локальные действия проверяют это владение; возможность просматривать проект не делает каждого участника владельцем подключённого компьютера или папки.
Подробнее о настройке агентов см. в статьях Роли и доступ и Возможности.
Соблюдайте настроенный способ редактирования
В текущем исходном коде есть политика агента программирования Use for all edits (Использовать для всех изменений). Если она выбрана, изменения кода должны проходить через настроенного агента программирования; прямая запись в файловую систему отклоняется. Если этот агент недоступен, следует сообщить о блокирующем условии, а не переключаться без предупреждения на другой способ редактирования.
После настройки проверьте сохранённую политику редактирования. Подтверждённый исходным кодом инструмент создания кодовой базы может создать ресурс, но оставить выбранным режим файловой системы, если запрошенный агент программирования недоступен; его результат содержит предупреждение. Само создание ресурса не доказывает, что запрошенный способ редактирования включён.
У локального провайдера программирования также могут быть собственные настройки песочницы, включая вариант расширенного доступа. Проверьте эту настройку, а не предполагайте, что любой вызов провайдера ограничен одной и той же папкой.
Исходный код также предоставляет статус кодовой базы, сведения о ветках и коммитах, действия Git и историю задач программирования. Это средства управления операциями. Получение изменений, создание коммитов, push, запуск команд и развёртывание имеют разные последствия и должны соответствовать разрешённой вами задаче.
Проверьте и передайте результат
Запросите список изменённых файлов, причины изменений, запущенные тесты с их фактическими результатами, неустранённые ошибки и ссылку на ветку или коммит, если их намеренно создавали. Изучите различия, прежде чем разрешать публикацию или развёртывание.
Храните архитектурные решения в документе, а повторяющиеся записи — в таблице. Кодовая база задаёт контекст выполнения; она не заменяет документацию проекта, критерии приёмки или проверку человеком.
Если подключение или выполнение заблокировано
- Нет доступной рабочей копии или зеркала: Проверьте необходимое подключение и подходящий источник вместе с его владельцем.
- Агент может обсуждать код, но не может его редактировать: Проверьте список редакторов, инструменты и выбранный способ выполнения.
- Агент программирования недоступен: Восстановите его среду или явно выберите разрешённую альтернативу; не обходите его политику без предупреждения.
- Ветка или локальные изменения отличаются от ожидаемых: Остановитесь и уточните ситуацию перед командами, которые перезаписывают работу.
- Действие Git завершилось ошибкой или его результат неясен: Проверьте состояние репозитория перед повторной попыткой.
Полные процессы подключения, редактирования, тестирования и записи через Git подтверждены исходным кодом и не проверялись в учётной записи для этой документации.