Чтобы начать работу с GitHub Projects, откройте вкладку Projects в своём профиле или репозитории и нажмите кнопку New project — сервис сразу предложит выбрать шаблон: таблицу, доску или дорожную карту. Именно с этого действия начинается знакомство с инструментом, и уже через пару минут у вас будет готовое рабочее пространство для задач.
GitHub Projects — это встроенная система управления проектами, которая тесно связана с issues и pull requests. В отличие от внешних таск-трекеров вроде Jira или Trello, здесь не нужно синхронизировать данные между сервисами: задачи, код и обсуждения живут в одном месте. В этой статье разберём, как пользоваться основными функциями инструмента.
Что такое GitHub Projects и кому он подходит
GitHub Projects представляет собой гибкую систему канбан-досок и таблиц, заточенную под разработку. Каждый элемент проекта — это обычный issue, pull request или черновик заметки, который можно превратить в полноценную задачу.
Инструмент подходит как одиночным разработчикам, ведущим личные пет-проекты, так и командам, которым нужно планировать спринты и отслеживать прогресс. Вам не потребуется отдельная подписка: базовые возможности доступны на бесплатном тарифе GitHub.
- 📋 Table — табличное представление с настраиваемыми колонками, похожее на электронную таблицу;
- 🗂️ Board — классическая канбан-доска с колонками статусов;
- 🗺️ Roadmap — временная шкала для планирования по датам.
Создание первого проекта
Перейдите на страницу github.com, авторизуйтесь и откройте вкладку Projects в шапке профиля. Нажмите New project и выберите шаблон — для старта удобнее всего Board или Table. После создания проект получает название, которое можно изменить в любой момент.
Далее необходимо добавить первые задачи. Нажмите Add item внизу любой колонки и введите символ #, чтобы найти существующий issue из ваших репозиториев. Если задачи ещё нет, просто напишите текст — создастся черновик (draft), который позже конвертируется в issue одним кликом через пункт Convert to issue.
☑️ Настройка нового проекта
Представления: таблица, доска и дорожная карта
Одна и та же информация отображается в разных видах — views. Их можно создавать сколько угодно и переключаться между ними по вкладкам вверху проекта. Например, менеджер смотрит дорожную карту, а разработчики работают с канбан-доской.
В табличном виде удобно массово редактировать поля и сортировать задачи. Доска лучше подходит для ежедневной работы: карточки перетаскиваются между колонками мышью, и статус меняется автоматически. Дорожная карта требует заполненного поля с датами — без него элементы на таймлайне не отобразятся.
| Представление | Когда использовать | Ключевая особенность |
|---|---|---|
| Table | Анализ и массовое редактирование | Сортировка и фильтры по любым полям |
| Board | Ежедневная работа команды | Перетаскивание карточек между статусами |
| Roadmap | Планирование релизов и спринтов | Визуализация сроков на таймлайне |
Пользовательские поля и структура задач
Помимо стандартного статуса, каждой задаче можно присвоить собственные поля: приоритет, исполнителя, дату, оценку трудозатрат, итерацию (спринт) и произвольные текстовые атрибуты. Поля добавляются через кнопку + в правой части заголовка таблицы.
Доступны типы полей: текст, число, дата, одиночный выбор (single select) и итерация. Поле типа Iteration особенно полезно для команд, работающих спринтами: вы задаёте длину итерации, и GitHub сам формирует последовательность циклов, к которым привязываются задачи.
⚠️ Внимание: поля создаются на уровне проекта, а не репозитория. Если вы удалите проект, значения пользовательских полей пропадут вместе с ним, хотя сами issues в репозитории останутся нетронутыми.
Автоматизация рабочих процессов
Сильная сторона GitHub Projects — встроенная автоматизация. Откройте меню проекта и перейдите в раздел Workflows: там собраны готовые правила, которые включаются одним переключателем. Например, задача автоматически попадает в колонку «Done», когда связанный issue закрывают.
Можно настроить и более тонкие сценарии: авто-добавление новых issues из конкретного репозитория, смена статуса при мерже pull request, архивация завершённых элементов. Для сложной логики используют GitHub Actions в связке с API проектов, но для большинства команд хватает стандартных workflow.
Какие workflow доступны из коробки
Item added to project — установка статуса при добавлении; Item closed — перенос в Done при закрытии; Code changes requested — статус при запросе правок в PR; Auto-add to project — автоматическое добавление issues из репозитория по фильтру.
⚠️ Внимание: правила авто-добавления работают только для репозиториев, к которым у вас есть доступ на запись. Проверьте права, если issues из чужого репозитория не появляются в проекте автоматически.
Совместная работа и права доступа
Проект может быть привязан к личному аккаунту или к организации. Во втором случае участники команды получают доступ с разными ролями: чтение, редактирование или администрирование. Настройки доступа находятся в разделе Settings проекта.
Чтобы обсуждать задачу, откройте карточку — внутри доступны комментарии, упоминания через @ и ссылки на связанные pull requests. Вся история обсуждений сохраняется в issue, поэтому контекст не теряется даже при смене исполнителя.
- 👥 Назначайте исполнителей через поле Assignees;
- 🏷️ Используйте метки (labels) репозитория для категоризации;
- 🔗 Связывайте pull request с задачей через
Closes #номерв описании; - 📊 Следите за прогрессом через встроенные графики в разделе Insights.
Типичные ошибки новичков
Частая проблема — попытка вести проект отдельно от репозитория, создавая только черновики. Черновики не поддерживают комментарии, метки и назначение исполнителей, поэтому любую задачу, над которой работает больше одного человека, стоит конвертировать в issue.
Вторая ошибка — избыточное количество колонок и полей. Если на доске десять статусов, команда перестаёт понимать, где что лежит. Начните с трёх-четырёх колонок: Todo, In Progress, Review, Done — и расширяйте структуру только по реальной необходимости.
Частые вопросы
Бесплатен ли GitHub Projects?
Да, базовые возможности доступны на бесплатном тарифе как для личных аккаунтов, так и для организаций. Ряд расширенных функций, например некоторые лимиты автоматизации и отчётности, зависят от тарифного плана — актуальные условия стоит проверять в официальной документации GitHub.
Чем GitHub Projects отличается от Projects (classic)?
Projects (classic) — устаревшая версия досок с жёсткой структурой. Новый GitHub Projects поддерживает пользовательские поля, несколько представлений, автоматизацию и табличный вид. Для новых проектов следует использовать современную версию.
Можно ли перенести задачи из Trello или Jira?
Прямой кнопки импорта нет, но задачи можно перенести через API GitHub или сторонние инструменты миграции. Для небольших проектов проще создать issues вручную или скриптом, а затем добавить их в проект.
Как удалить проект без потери задач?
Удаление проекта не удаляет issues и pull requests в репозиториях — пропадают только представления, поля и черновики. Перед удалением конвертируйте важные черновики в issues и экспортируйте данные таблицы, если они понадобятся.
Работает ли GitHub Projects с приватными репозиториями?
Да, проекты полноценно работают с приватными репозиториями. Участники увидят только те элементы, к которым у них есть доступ на уровне репозитория.