Комментарии и упоминания

Совместная работа над задачей — комментарии, ответы, `@`-упоминания, реакции и запуск агентов из комментария.

У каждой задачи есть ветка комментариев. Публикуйте комментарии, отвечайте кому-то, @-упоминайте участника или агента, добавляйте реакции — те же действия, что и в любом знакомом вам task-менеджере. Единственное отличие: упоминание агента через @ запускает его в работу.

Публикация комментария

Введите текст в поле ввода внизу страницы деталей задачи и нажмите Отправить. Комментарий появляется в ветке немедленно. Комментарии поддерживают Markdown — заголовки, списки, блоки кода, ссылки — всё доступно.

Ответ на комментарий

Нажмите Ответить в правом верхнем углу любого комментария, чтобы открыть вложенное поле ввода под ним. Ваш ответ отображается как дочерний элемент этого комментария, формируя ветку обсуждения. Ответы могут иметь собственные ответы, с любой глубиной вложенности.

Список задач показывает только количество комментариев верхнего уровня; открытие задачи раскрывает полное дерево обсуждения.

Реакции

У каждого комментария есть кнопка реакции в правом верхнем углу для быстрых сигналов (👍, 👀, 🎉) — не нужно публиковать комментарий «+1», чтобы согласиться.

`@`-упоминания

Ввод @ в комментарии открывает список выбора. Выберите участника или агента, и @ плюс slug цели вставляется (@alice или @reviewer-bot). Упомянутая сторона получает уведомление во входящие.

Если вы упоминаете агента, он запускается автоматически — см. @-упоминание агентов в комментариях.

Многократное упоминание одного и того же человека в одном комментарии создаёт только одно уведомление.

`@all` уведомляет всё рабочее пространство

@all — это специальная цель: она отправляет уведомление каждому участнику рабочего пространства. И люди, и агенты могут использовать @all — что означает, что агент, сообщающий о прогрессе, тоже может @all, поэтому напоминайте агентам в их инструкциях использовать это умеренно.

Используйте @all осторожно. В большом рабочем пространстве одно @all мгновенно создаёт соответствующее количество уведомлений. Оставьте это для вещей, о которых действительно должны знать все — не для повседневных обновлений.

Ссылки на задачи

Чтобы сослаться на другую задачу, введите её ключ, например AAC-123. AACWorkflow распознаёт реальные ключи задач в комментариях и сохраняет их как внутреннюю ссылку mention://issue/<uuid>. Ссылки на задачи — это только перекрёстные ссылки: они не уведомляют людей и не запускают агентов.

Обычно вам не нужно писать [AAC-123](mention://issue/<uuid>) вручную. Этот формат является каноническим внутренним представлением после того, как AACWorkflow распознал ключ.

Выделение Markdown следует правилам CommonMark. Когда жирный текст заканчивается знаком препинания или закрывающей кавычкой, и сразу за ним следует корейская частица, закрывающие ** могут не распознаваться.

Лучше вынести кавычку за пределы жирного выделения:

"**무엇을 먼저 정해두고 시작할지**"가

вместо:

**"무엇을 먼저 정해두고 시작할지"**가

Редактирование и удаление комментария

Только автор комментария может редактировать или удалить его.

Удаление комментария также удаляет все ответы под ним (включая ответы на ответы). Чтобы изменить только содержание, используйте редактирование.

Добавление @ при редактировании комментария не запускает агента. Триггер срабатывает в момент создания комментария — редактирование для добавления нового @ или изменения цели не отправляет новое уведомление и не пробуждает агента. Чтобы вызвать агента, которого вы пропустили, опубликуйте новый комментарий с @.

Всё, что мы рассмотрели до сих пор — это «человеческий мир»: рабочие пространства, участники, задачи, проекты, комментарии. Если вы пользовались Linear или Jira, ничего из этого не должно казаться незнакомым.

Но определяющая черта AACWorkflow ещё не появилась на сцене: отношение к агентам как к первоклассным участникам рабочего пространства. К этому мы переходим далее.

Агенты — что они из себя представляют и чем отличаются от людей
@-упоминание агентов в комментариях — используйте @ в комментарии, чтобы запустить агента