Держите цикл Linear под контролем прямо из чата
Подключите Linear к ИИ-агенту: issue, проекты, команды, циклы, лейблы и статусы. Агент заведёт issue, сменит статус и соберёт сводку по циклу.
Как агент работает с Linear
Агент работает с Linear через один GraphQL-эндпоинт api.linear.app/graphql: там же issue, проекты, команды, циклы, лейблы, комментарии, workflow-статусы и участники. Запрос перечисляет нужные поля явно, поэтому за состоянием цикла агент идёт одним обращением, а не собирает картину из десятка выгрузок: что стоит без движения, что просрочено, на кого из команды навешано больше всего.
Важная особенность Linear — workflow-статусы принадлежат командам, а не воркспейсу: у каждой команды свой набор состояний со своими названиями, и одинаково подписанные колонки в двух командах остаются двумя разными статусами. Поэтому агент сначала определяет команду issue и только потом подбирает статус из её набора, а не переносит задачу в состояние соседней команды по совпадению названия.
На запись агент заводит issue в нужной команде и проекте, проставляет лейблы, приоритет и workflow-статус, пишет комментарии и убирает issue в архив — но только если у ключа есть право Write. Ключ без него читает и считает, и об этом агент скажет заранее, а не будет молча упираться в отказ. После изменения он перечитывает issue, чтобы показать её фактическое состояние, а не отправленный запрос.
Границы видимого задаёт сам ключ: если при выпуске доступ сужен до конкретных команд, остальной воркспейс агенту виден не будет, и разговор идёт только о них. Длинные выборки Linear отдаёт страницами по курсору, поэтому список issue агент дочитывает до конца, а не обрывает на первой сотне. Частоту запросов он выдерживает сам, о новых issue и комментариях узнаёт вебхуками, а при нехватке прав говорит прямо, а не показывает пустую таблицу.
Сценарии интеграции
Состояние текущего цикла
Агент покажет по циклу, какие issue стоят без движения, что просрочено и на кого из команды навешано больше всего.
Issue из обсуждения
Агент заведёт issue в нужной команде и проекте, проставит лейблы, приоритет и workflow-статус и добавит комментарий.
Сводка по проектам
Агент соберёт по проектам, что закрыто за неделю, что переехало дальше и какие issue висят дольше срока.
Реакция на новые issue
Агент по вебхукам Linear отследит новые issue, правки и комментарии и сообщит о них сразу, как они появились.
Что на мне на этой неделе
Агент соберёт issue, назначенные на вас во всех доступных командах, разложит их по приоритету и сроку и скажет, что горит сегодня, а что подождёт.
Разбор необработанных issue
Агент найдёт issue без ответственного, лейбла или цикла, покажет их одним списком и, если у ключа есть право Write, проставит лейблы и приоритет.
Примеры: Linear
Закрыто 34 issue из 52, до конца цикла четыре дня.
- 7 issue в In Progress не меняли статус больше пяти дней
- половина оставшегося скоупа — на одном инженере, 9 issue с приоритетом Urgent
Что переносим в следующий цикл?
Ассистент может ошибаться — проверяйте его работу
63 issue лежат вне цикла и без разбора.
- без ответственного — 29
- без лейбла — 24
- без цикла, но с приоритетом Urgent — 10
Проставить лейблы и приоритет смогу, только если у ключа есть право Write: текущий читающий, поэтому список отдаю на ручное разведение.
Ассистент может ошибаться — проверяйте его работу
Как подключить
Перед подключением
- Аккаунт участника воркспейса Linear
- Настройка «Member API keys» включена администратором
- Роль администратора, если ключу нужен доступ Admin
- 1
Откройте Settings → «Security & access»
В Linear нажмите на аватар воркспейса → Settings → «Security & access». Кабинет только на английском, русской локали нет — названия ищите как есть.
- 2
Создайте ключ в «Personal API keys»
В блоке «Personal API keys» нажмите «New API key» и дайте ключу имя. Если кнопки нет, админ выключил «Member API keys» в Settings → Administration → API.
- 3
Выдайте ключу права под задачи агента
Выберите full access или набор Read, Write, Admin, Create issues, Create comments. Без Write агент только читает. Доступ можно сузить до конкретных команд.
- 4
Скопируйте ключ — он показан один раз
Ключ начинается с lin_api_. Linear показывает его единожды: закроете окно — придётся выпускать новый. Скопируйте строку целиком, вместе с префиксом.
Частые вопросы
Персональным API-ключом: в Linear откройте Settings → «Security & access» → «Personal API keys» → «New API key», выдайте ключу права и скопируйте строку, которая начинается с lin_api_ — она показывается только один раз.
Issue, проекты, команды, циклы, лейблы, комментарии, workflow-статусы и участников через GraphQL API — в пределах доступа ключа, который можно сузить до конкретных команд.
Да, если у ключа есть право Write: агент создаёт и обновляет issue, меняет статусы, пишет комментарии и убирает issue в архив. Без Write доступно только чтение.
Администратор воркспейса выключил «Member API keys» в Settings → Administration → API. Попросите включить настройку или выпустить ключ за вас.