Тема
Задачи
Как поставить задачу, кто в ней участвует и что есть в карточке задачи.
Роли в задаче
У каждой задачи четыре участника:
- Создатель — тот, кто поставил задачу. Всегда человек.
- Ревизор — принимает работу: проверяет постановку, план и результат, решает споры о сроке и оценке.
- Исполнитель — делает работу: пишет план и выполняет его.
- Оператор — дежурный по задаче. Следит за запусками агентов, перезапускает их и подтверждает решения, которые доска оставляет человеку. Всегда человек.
Ревизором и исполнителем может быть человек или агент. Это должны быть разные участники: один и тот же агент не может проверять собственную работу. Два разных агента одного владельца — можно.
Агент вместо человека
В полях «Ревизор» и «Исполнитель» выбираются люди. Если у человека есть агент на эту роль, в задачу встанет его агент. В списке это видно заранее: «Анна → @anna:executor». В журнале задачи останется запись, кого выбрали и какой агент назначен.
Какой агент подставляется, владелец настраивает в своём профиле. Можно задать агента на проект, на тип задачи и время работы.
Новая задача
Нажмите «Новая задача» на доске или в обзоре.
| Поле | Обязательно | Что указать |
|---|---|---|
| Проект | да | |
| Тип | да | От типа зависят поля постановки, см. ниже |
| Название | да | Одна строка, до 120 символов |
| Ревизор | да | Подставляется из настроек проекта, иначе вы |
| Исполнитель | да | Подставляется из настроек проекта |
| Оператор | да | Только человек. Подставляется из настроек проекта, иначе вы |
| Приоритет | нет | |
| Срок | да | Не раньше сегодняшнего дня |
| Теги | нет | Метки, по которым задачи потом находятся вместе, см. ниже |
| План, часов | да | Оценка трудоёмкости, можно дробное число |
| Очередь | нет | В какую очередь поставить задачу |
| Запустить в | нет | Когда задача стартует сама |
Ниже идут поля постановки выбранного типа. Отдельного поля «Описание» у задачи нет: что нужно сделать, описывается в полях типа. Какие из них обязательны, задаёт тип. Если у типа есть поле «Файлы», файлы можно перетащить в него мышью.
Если обязательные поля пусты, доска подсветит их все сразу.
Задача не уйдёт агентам сама
Созданная задача ждёт в «Бэклоге», пока её не запустят: временем в поле «Запустить в» или очередью. Подробнее — в разделе «Как задача идёт по стадиям».
Теги
Теги собирают задачи в группу. Например, задачи одного релиза или одной доработки помечаются общим тегом. По тегу задачи потом находятся в «Фильтрах» — так видно, какие задачи выполнялись вместе. Тег ищется и обычным поиском.
У задачи может быть несколько тегов.
Карточка задачи
Нажмите на задачу на доске, чтобы открыть её карточку. Карточка разбита на секции, каждую можно свернуть. На телефоне сразу открыто только «Обсуждение».
| Секция | Что в ней |
|---|---|
| Постановка | Поля типа: что нужно сделать |
| Карточка | Проект, родительская задача, участники, приоритет, срок, время запуска, теги, план и факт |
| Обсуждение | Комментарии людей и агентов. Отсюда же можно говорить с агентом, пока он работает |
| Подзадачи | Дочерние задачи и кнопка «Добавить» |
| Вложения | Файлы задачи |
| Согласования | Решения, которые ждут подтверждения человеком |
| Запуски | Каждый запуск агента: попытка, длительность, итог и вывод |
| Журнал | Все события задачи: переходы, назначения, запуски |
| Расход | Сколько токенов потратил каждый запуск |
Стадию задачи можно сменить и в карточке: в шапке есть список стадий. В нём только те, куда вам разрешено перевести задачу.
Комментарии и упоминания
Комментарий пишется в поле внизу «Обсуждения». Отправить — кнопкой или Ctrl+Enter (⌘+Enter на Mac). К комментарию можно приложить файлы.
Наберите @, чтобы упомянуть человека или агента. Упомянутый получит уведомление.
Свои комментарии можно изменить или удалить.
Подзадачи
Крупную задачу можно разбить: в секции «Подзадачи» нажмите «Добавить». Откроется форма новой задачи, родитель подставится сам.
Пока не закрыты все подзадачи, в том числе вложенные на любую глубину, родительскую задачу не закрыть: принять её работу нельзя, доска ответит «У задачи есть незавершённые подзадачи».
Через подзадачи удобно:
- подключить к задаче ещё исполнителей. У задачи один исполнитель и один ревизор. Если нужен ещё кто-то, заведите на его часть подзадачу. Например, агент пишет код, а код-ревью делает человек: подзадача «Код-ревью» с этим человеком в роли исполнителя. Пока он её не закроет, родительская задача не закроется;
- собрать большую фичу. Заведите родительскую задачу на всю фичу и подзадачи на её части. Каждую часть делают и принимают отдельно, а фича закрывается, когда готовы все.
Правка
Кнопка «Редактировать» в шапке превращает поля «Карточки» и «Постановки» в редактируемые. Сохраните изменения кнопкой «Сохранить».
Ревизор, исполнитель и оператор есть у задачи всегда: их можно заменить, но не убрать.
Пока задача в «Бэклоге», её можно править свободно. Когда она ушла в работу, ревизор, исполнитель, приоритет, оценка, срок и очередь фиксируются. Чтобы снова их поменять, верните задачу в «Бэклог».
Спор о сроке и оценке
Если срок или оценка не подходят, исполнитель может предложить свои: кнопка «Оспорить» у поля «Срок» или «План». Предложение появится в «Карточке», ревизор примет его или отклонит.
Пауза
Кнопка «Пауза» приостанавливает задачу, если работа по ней уже началась. Агент, который сейчас работает, останавливается. Нужно указать причину, она появится в обсуждении. Время паузы не входит в фактические затраты. Продолжить — кнопкой «Продолжить»: агент вернётся в ту же сессию.
Время
У задачи два числа, они видны на карточке на доске («4 ч / 1.5 ч») и в «Карточке» задачи:
- План — оценка в часах, её указывают при создании задачи;
- Факт — сколько задача была в работе. Доска считает его сама: отсчёт начинается, когда задача входит в «К запуску», и останавливается, когда она доходит до «Готово» или возвращается в «Бэклог». Время пауз вычитается. Если задачу снова запустят, отсчёт продолжится и сложится с прежним.
Проверка постановки в «Бэклоге» в факт не входит.
Расход токенов
Секция «Расход» в карточке задачи показывает, сколько токенов потратил каждый запуск агента: вход, выход, чтение и запись кэша, рассуждение и всего, а внизу — итог по задаче. Если движок агента не сообщил расход, число оценено по длине текста и помечено «оценка».
Расход всего проекта — на вкладке «Расход» в карточке проекта: за выбранный период, с группировкой по месяцу, движку и модели и числом запусков.
Удаление
Удалить задачу можно, пока она в «Бэклоге», без подзадач и без запусков агентов. Для подтверждения нужно ввести ключ задачи.
Закрытая задача
Задача закрывается, когда доходит до финальной стадии, в новой доске это «Готово». Закрытую задачу менять нельзя: её можно читать и комментировать.