Глава 23 · Часть II · Планируем SafeSort на GitHub

Необязательно: встроенная автоматизация и auto-add

Встроенные workflow сами меняют статус элемента по событиям репозитория и сами добавляют новые Issues в Project.

SafeSort · Часть 2 из 6Планирование

Часть переходов между статусами не нужно делать руками — у Project есть встроенные автоматизации (built-in workflows), которые реагируют на события в репозитории.

Встроенный workflowЧто делает
Item added to projectвыставляет статус по умолчанию новому элементу
Item reopenedвозвращает элемент в заданный статус, если Issue переоткрыт
Item closedпереводит элемент в статус Done, когда Issue или PR закрыт
Pull request mergedпереводит элемент в статус Done при слиянии Pull Request
Auto-add to projectавтоматически добавляет в Project новые Issues и PR, подходящие под фильтр
Auto-archive itemsархивирует элементы, подходящие под фильтр — например, всё в статусе Done
Pull Requestсмерженсобытие в репозиторииWorkflow "Pullrequest merged"встроеннаяавтоматизация ProjectреагируетСтатус элемента→ Doneбез ручногоперетаскиваниякарточки
Встроенные workflow реагируют на события репозитория и сами меняют статус

В настоящем Project SafeSort сработал похожий, но не тот же workflow — все 14 Issues добавлялись уже закрытыми, поэтому включился Item closed, а не «Pull request merged»:

Настроенный workflow Item closed → Status: Done в настоящем Project SafeSort
Реальный workflow, который автоматически перевёл все 14 задач в Done.

Auto-add — чтобы не добавлять Issues вручную

Workflow Auto-add to project настраивается фильтром — например, «любой новый Issue в репозитории Cartesian-School/safesort». С таким правилом каждый новый Issue сам попадает в Project со статусом по умолчанию, и не нужно помнить о ручном шаге «добавить в Project» из более раннего раздела главы. Именно так настроен и включён Auto-add в настоящем Project SafeSort:

Включённый workflow Auto-add to project с фильтром is:issue для репозитория safesort
Реальный, включённый Auto-add — фильтр is:issue уже находит все 14 существующих Issues.
Автоматизация не заменяет решения — она освобождает от рутины
Auto-add избавляет только от механического действия «перетащить Issue в Project». Решение о том, в каком статусе должна оказаться задача дальше — Ready она уже или ещё Backlog, — по-прежнему принимает человек.
Официальная документация
Using the built-in automations
Adding items automatically
Перевод и учебная адаптация официальной документации GitHub. Исходный материал — CC BY 4.0.

Коротко

  • Встроенные workflow меняют статус элемента в ответ на событие репозитория — например, слияние Pull Request.
  • Auto-add to project автоматически добавляет в Project новые Issues и PR, подходящие под настроенный фильтр.
  • Автоматизация убирает рутинные действия, но не решения о том, в каком статусе должна быть задача.