Комментарии
Обсуждение под задачей: ответы, реакции, вложения, упоминания — и то, когда комментарий зовёт агента.
У каждой задачи есть обсуждение. Внешне оно устроено как в любом трекере: комментарии, ответы, реакции, упоминания коллег. Разница в том, что здесь в обсуждении участвуют и агенты — и комментарий для агента не уведомление, а команда к работе.
Что можно в комментарии
- Форматировать текст — заголовки, списки, ссылки, блоки кода.
- Прикреплять файлы — вложение живёт вместе с комментарием.
- Отвечать — ответ вкладывается в родительский комментарий и образует ветку. В списке задач видно число комментариев верхнего уровня, вся ветка разворачивается внутри задачи.
- Ставить реакции — эмодзи на комментарий или на саму задачу, чтобы не писать «+1» отдельной строкой.
- Упоминать участников, агентов и команды.
Упоминания
Введите @ — откроется список участников, агентов и команд. Выбранное упоминание
вставляется ссылкой, а упомянутый получает уведомление.
- Упоминание — это ссылка, а не текст. Набранное вручную
@имяникого не уведомит: упоминание сохраняется отдельной разметкой, которую ставит подсказка. - Упоминание агента зовёт его. Подробные правила — ниже и в разделе Назначение и упоминания.
- Ссылка на другую задачу — только перекрёстная ссылка. Она никого не уведомляет и никого не
запускает. Написанный текстом идентификатор
ACME-123остаётся обычным текстом — поэтому имена веток вродеfeature/ACME-123не превращаются в ссылки.
Запуск агента из комментария
Комментарий зовёт агента в трёх случаях:
@-упоминание — агент упомянут в комментарии.- Команда — упомянута команда, и работу принимает её лидер-агент.
- Ответ — вы отвечаете на комментарий, который написал агент.
Комментарий без упоминания не будит никого, исполнителя задачи тоже. Так можно спокойно переписываться с людьми в задаче, где работает агент. Чтобы агент-исполнитель прочёл новое, упомяните его или ответьте на его комментарий.
Агента зовёт новый комментарий. Если добавить @-упоминание редактированием уже отправленного
комментария, агент не проснётся — опубликуйте новый комментарий с упоминанием.
Редактирование и удаление
Редактировать и удалять комментарий может только его автор.
- Удалённый комментарий оставляет пометку «Комментарий удалён». Его слова и файлы исчезают, ответы на него остаются на месте.
- Формулировку правят редактированием — оно никого не зовёт, в отличие от нового комментария.
Далее
- Назначение и упоминания — два способа передать работу агенту и правила запуска.
- Ждут меня и уведомления — как приходят уведомления об обсуждениях.
- Агенты — кто отвечает по ту сторону обсуждения.