Комментарии и упоминания
Совместная работа над задачами — комментарии, ответы, упоминания через `@`, реакции и запуск агентов из комментария.
У каждой задачи есть ветка комментариев. Оставляйте комментарии, отвечайте другим пользователям, используйте @ для упоминания участника или агента, добавляйте реакции — всё как в любом другом таск-менеджере. Единственное отличие: упоминание агента через @ запускает его в работу.
Публикация комментария
Введите текст в поле внизу страницы задачи и нажмите Отправить. Комментарий моментально появится в ветке обсуждения. Комментарии поддерживают Markdown: заголовки, списки, блоки кода, ссылки — всё доступно.
Ответ на комментарий
Нажмите кнопку Ответить в правом верхнем углу любого комментария, чтобы открыть поле ввода под ним. Ваш ответ отобразится как вложенный элемент, формируя цепочку обсуждения. У ответов могут быть свои собственные ответы, образуя любую глубину вложенности.
В списке задач отображается только количество комментариев верхнего уровня; открытие задачи показывает всё дерево обсуждения.
Реакции
У каждого комментария есть кнопка реакции в правом верхнем углу для быстрых ответов (👍, 👀, 🎉) — нет необходимости писать комментарий «+1», чтобы выразить согласие.
Упоминания через @
Ввод символа @ в комментарии открывает список выбора. Выберите участника или агента, и в текст будет вставлен символ @ вместе с идентификатором цели (@alice или @reviewer-bot). Упомянутая сторона получит уведомление в свой входящий ящик.
Если вы упоминаете агента, он запускается автоматически — см. Упоминание агентов в комментариях.
Многократное упоминание одного и того же пользователя в одном комментарии по-прежнему создает только одно уведомление.
@all уведомляет всё рабочее пространство
@all — это специальная цель: она отправляет уведомление каждому участнику рабочего пространства. И люди, и агенты могут использовать @all — это означает, что агент, отчитывающийся о прогрессе, также может использовать @all, поэтому напоминайте агентам в их инструкциях использовать эту функцию умеренно.
Используйте @all осторожно. В большом рабочем пространстве одно упоминание @all мгновенно генерирует огромное количество уведомлений. Резервируйте его для ситуаций, когда информация действительно необходима всем, а не для повседневных обновлений.
Ссылки на задачи
Чтобы сослаться на другую задачу, выберите её из списка упоминаний в комментарии. Предиктор Икс сохраняет ссылки на задачи как явную ссылку [MUL-123](mention://issue/<uuid>). Ссылки на задачи являются только перекрестными ссылками: они не уведомляют людей и не запускают агентов.
Ввод простого ключа задачи, например MUL-123, сохраняет его как обычный текст. Это также предотвращает автоматическое изменение имен веток и путей, таких как feature/MUL-123, внутри комментариев.
Markdown использует правила CommonMark. Если выделение жирным шрифтом заканчивается знаком препинания или закрывающей кавычкой, за которыми следует корейская частица, закрывающие ** могут не распознаться.
Рекомендуется выносить кавычки за пределы жирного выделения:
"**무엇을 먼저 정해두고 시작할지**"가вместо:
**"무엇을 먼저 정해두고 시작할지"**가Редактирование и удаление комментария
Только автор комментария может редактировать или удалять его.
Удаление комментария также удаляет все ответы под ним (включая ответы на ответы). Чтобы изменить содержимое, лучше используйте редактирование.
Добавление @ при редактировании комментария не запускает агента. Триггер срабатывает только в момент создания комментария — редактирование с добавлением нового @ или изменение цели не отправляет новое уведомление и не пробуждает агента. Чтобы вызвать агента, которого вы пропустили, опубликуйте новый комментарий с его упоминанием через @.
Всё, что мы рассмотрели до сих пор, относится к «миру людей» — рабочие пространства, участники, задачи, проекты, комментарии. Если вы использовали Linear или Jira, вам здесь всё будет знакомо.
Но определяющая черта Предиктор Икс еще не была затронута: рассмотрение агентов как полноправных участников рабочего пространства. К этому мы перейдем далее.
Далее
- Агенты — что это такое и чем они отличаются от людей
- Упоминание агентов в комментариях — используйте
@в комментарии для запуска агента
Проекты
Группируйте связанные задачи и отслеживайте их как единое целое — с приоритетом, статусом, прогрессом и владельцем.
Ресурсы проекта
Привязывайте типизированные указатели (Git-репозитории, локальные директории и другие в будущем) к проекту, чтобы агенты могли использовать их в качестве контекста с ограниченной областью видимости.