Скиллы

Скилл — это знание о том, как правильно делать задачи в Пачке. Агент читает скилл сам, когда просьба подходит под его описание, поэтому вызывать скилл не нужно. Скиллы работают при любом способе подключения: через MCP-сервер, CLI или API.

Скиллы приходят вместе с плагином «Пачка», а в другие агенты ставятся отдельно, как в разделе Скиллы без плагина. Пересказ треда и слежение за тредом запускают командами плагина. Как вызвать команду в вашей программе, сказано в разделе Команды плагина.

С чего начать

Скилл pachca — вход в Пачку для агента. С него агент начинает, когда подключается или не знает, какой скилл взять, и переходит к нужному: переписке, поиску, администрированию, ботам или API. Сам скилл отвечает за подключение: агент выбирает способ входа и токен, говорит, от чьего имени работает, и объясняет, почему не хватает прав или инструмента.

Агент берёт скилл по таким просьбам:

Подключи ПачкуНастрой MCP Пачки

Подскажет способ входа для вашей программы и проверит подключение

Войди в Пачку через CLI

Попросит выполнить вход в вашем терминале и проверит его

Каким токеном подключить агента?

Подберёт токен под задачу: персональный (вход через браузер, в CLI или готовый токен), токен бота или авторизацию бота от имени сотрудника

Что это за экран входа MCP?

Объяснит экран согласия и какое пространство получит доступ

Агент получил 403 insufficient_scope

Разберёт отказ и скажет, что поможет

Почему нет инструмента экспорта?

Назовёт роль, тариф или тип токена, которых не хватает

Что умеет Пачка?

Расскажет о возможностях и перейдёт к нужному скиллу

Что агент знает из скилла:

Когда агент сам спрашивает подтверждение в чате и как обращается с чужим текстом и секретами, описано в разделах Подтверждение действий и Безопасность. Подробнее — на страницах Подключение к MCP и Агенты и MCP в пространстве.

Сообщения

Скилл pachca-messaging агент читает всякий раз, когда что-то пишет в Пачку: сообщение, комментарий в треде, личное сообщение, черновик, отложенное сообщение, файл, реакцию, закрепление, отметку «Важное», правку или удаление. Аргументы описаны в самих инструментах, а скилл добавляет то, чего там нет: куда писать, когда сначала спросить и что ломает сообщение.

Агент берёт скилл по таким просьбам:

Напиши в чат «Релизы», что сборка готова

Найдёт чат по названию и отправит сообщение

Ответь Анне в треде, что макет готов

Ответит в тред, а не в общий чат

Напиши Максиму в личку, что встреча переносится на 15:00

Отправит личное сообщение, личный чат появится сам

Напиши в тред, что релиз готов, и упомяни Анну

Упомянет Анну, а если её нет в треде, сначала спросит: упоминание пригласит её в тред

Создай тред с Анной и Максимом про загрузку файлов

Покажет участников и текст первого сообщения, а после вашего «да» создаст самостоятельный тред

Подготовь черновик, я отправлю сам

Оставит черновик в поле ввода чата и скажет, в каком он чате

Напоминай в канал «Команда» каждый понедельник

Покажет текст, время и повтор, а после вашего «да» создаст отложенное сообщение

Отправь отчёт файлом .mdПриложи файл

Приложит файл к сообщению

Перешли сообщение в чат «Дизайн»

Отправит ссылку на сообщение или перепостит его от вашего имени

Поставь реакциюЗакрепи сообщение

Поставит реакцию или закрепит сообщение в шапке чата

Отметь как важное

Добавит сообщение в ваш раздел «Важное»

Исправь сообщениеДопиши к сообщению

Поправит сообщение, а если его уже прочитали, напишет дополнение ответом

Ты написал не то

Сразу исправит своё сообщение по тем же правилам и скажет, что поменял, не спрашивая заново

Что агент знает из скилла:

Если в просьбе есть текст и адресат, агент отправляет сразу, а разрешение спрашивает программа. Отправленное не вернуть: уведомление уже ушло, а удаление оставляет пометку «Сообщение удалено». Поэтому агент покажет адресат и итоговый текст и дождётся вашего «да», если:

• текст или адресат не заданы точно, или агент открыл бы тред, о котором вы не просили
• сообщение уходит многим сразу или большему числу адресатов, чем вы назвали, в том числе с @all или @here, которых вы не просили
• упоминание в треде пригласит сотрудника, которого там нет, даже если вы его назвали
• текст, время или повтор отложенного сообщения агент заполнил сам
• нужно исправить или удалить сообщение, на которое вы не дали ссылку
• сообщение из закрытого чата или личной переписки переносится в чат с другими читателями
• чтобы написать в открытый чат, агенту нужно в него вступить

Кнопки, формы и нажатия агент делает по скиллу pachca-bots, напоминания и чтение «Важного» по pachca-search, загрузку файлов из кода по pachca-api. Подробнее — на страницах Черновик вместо отправки, Оформление ответов и Треды.

Поиск, пересказ и напоминания

Скилл pachca-search агент читает, чтобы найти обсуждение, чат или сотрудника, пересказать тред, собрать дайджест и поставить напоминания себе или коллегам. В Пачке несколько поисков и лент, и каждый охватывает свою часть пространства. Чаще всего ответ выходит неверным из-за неподходящего поиска, чтения только первой страницы или неверного id треда, и скилл учит агента этого избегать.

Агент берёт скилл по таким просьбам:

Найди, где обсуждали переезд на новый сервер

Поищет по сообщениям и даст ссылку на каждое найденное

Кто писал про релиз?

Найдёт сообщения по теме и назовёт авторов

Где меня упоминали?

Поищет упоминания по вашему имени, нику и тегам

Найди чат «Продажи»Найди Максима из отдела продаж

Найдёт чат по названию или сотрудника по имени, должности и отделу

Перескажи тред

Прочитает тред целиком и перескажет решения, открытые вопросы и задачи

Что было в канале за неделю?Дайджест

Соберёт дайджест за период со ссылками на сообщения

Какие решения приняли?Поставь задачи по итогам

Выделит решения и поручения, а напоминания коллегам поставит после вашего «да»

Напомни мне завтра в 9:00

Поставит напоминание, и Пачка уведомит вас в срок

Мои напоминания

Покажет напоминания, где исполнитель вы

Что у меня в «Важном»?

Покажет сообщения, которые вы отметили

Кто в теге «Дизайн»?Кто в чате?

Покажет сотрудников тега или участников чата

Что агент знает из скилла:

Одно напоминание, которое вы продиктовали, агент ставит сразу. Сначала он спросит, если:

• из обсуждения получилось несколько напоминаний для коллег: агент покажет список (что, кто, к какому сроку) и поставит их после вашего «да»
• ответственный не назван или под имя подходят два сотрудника: молча назначать такое напоминание вам агент не станет
• под название подходят два тега
• напоминание нужно удалить: агент назовёт его и предложит отметить выполненным, потому что удаление окончательное
• напоминание нужно перенести в другой чат: для этого его приходится удалить и создать заново

Публикует результат агент по скиллу pachca-messaging, теги и участников меняет по pachca-admin, а файл, чтобы прочитать его, скачивает по pachca-api. Подробнее — на страницах Треды и Теги.

Администрирование

Скилл pachca-admin нужен Владельцу и Администраторам: сотрудники, теги, участники чатов, роли, доступ к API, журнал аудита, экспорт и защита данных. Каждое такое действие меняет, что видят и могут другие сотрудники, поэтому скилл прежде всего учит агента, кто что может и когда сначала спросить.

Агент берёт скилл по таким просьбам:

Пригласи anna@example.com

Пригласит сотрудника с ролью, которую вы назовёте

Удали Максима из ПачкиУволь сотрудника

Найдёт сотрудника и спросит, удалить насовсем или приостановить

Сделай Анну администратором

Сменит роль и напомнит, что роли в чатах не изменятся

Добавь Максима в тег «Дизайн»

Добавит тег и сохранит остальные теги сотрудника

Добавь Анну в чат «Продажи»Удали участника чата

Добавит или удалит участника

Кто в закрытом канале, где я не состою?

Покажет участников, если вы Владелец

Доступ к API ограничен

Назовёт настройку пространства, которую нужно переключить

Отзови доступ сотрудника к API

Подскажет, где отозвать доступ на вкладке Все токены

Покажи журнал аудита за неделю

Подберёт типы событий и запросит их

Выгрузи переписку канала за сентябрь

Запросит экспорт за период

Составь правило DLP

Составит и проверит правило, а вставит его Владелец

Что агент знает из скилла:

Ясную просьбу, например «сделай Анну администратором», агент выполняет сразу, а разрешение спрашивает программа. В чате агент сначала назовёт, кого и что затронет изменение, и дождётся вашего «да», если:

• сотрудника или объект агент выбрал сам, например из нескольких найденных
• шаг нельзя отменить, хотя подошёл бы обратимый, как удаление вместо приостановки
• изменение затрагивает многих сразу: нескольких сотрудников, тег, который убирают из чата или удаляют, или участников нескольких чатов
• сотрудника переводят в гости: он сразу теряет теги, все токены и все беседы и каналы, кроме одного

Одно «да» относится к одному действию, а не к пакету, которого вы не видели. О последствиях остальных действий агент пишет в отчёте: например, что приглашение уже ушло на почту или что при архивации чата из него удалены гости.

Отсутствующий инструмент и общие отказы 401 и 403 агент разбирает по скиллу pachca, состав тега или чата смотрит по pachca-search, а собственные токены бота меняет по pachca-bots. Подробнее:

• Права и роли
• Теги
• Агенты и MCP в пространстве
• Журнал аудита событий
• Экспорт сообщений
• DLP-система
• Шифрование и безопасный контур

Боты и интеграции

Скилл pachca-bots помогает выбрать, на чём построить интеграцию, и настроить бота так, чтобы он получал события и отвечал. Бот в Пачке — служебный участник пространства: он состоит в чатах, пишет и получает события от своего имени, и на нём построена любая интеграция. Подробнее — на странице Боты.

Агент берёт скилл по таким просьбам:

Сделай, чтобы уведомления из CI приходили в чат

Предложит входящий вебхук и предупредит, что он пишет во все беседы и каналы бота, а для одного чата понадобится токен бота

Бот не получает сообщения

Проверит по порядку адрес вебхука, событие Новые сообщения, режим сообщений и участие бота в чате, а по истории событий поймёт, дело в настройках или в обработчике

Как проверить подпись вебхука?

Посчитает подпись по исходному телу запроса до разбора JSON и добавит проверку свежести webhook_timestamp

Добавь в сообщение бота кнопки и форму

Напомнит, что кнопки отправляются токеном бота, нужно событие Нажатие кнопок, а форма открывается в первые 3 секунды после нажатия, поэтому нужен обработчик: агент в разговоре с вами в это окно не успевает

Сделай превью для ссылок на наш сервис

Скажет, что событие разворачивания ссылок и его домены включает только Администратор или Владелец

Какие права дать токену бота?

Предложит отдельный токен на каждый сервис с минимальным набором прав

Токен бота утёк

Перевыпустит токен и предупредит, что старое значение перестаёт работать сразу и каждому сервису с этим токеном нужен новый

Опубликуй бота в витрине

Подскажет, что для витрины нужны включённая авторизация и сохранённое описание, а публикация не даёт писать боту, поэтому опубликованного бота делают ещё и публичным

Что агент знает из скилла:

Когда агент спрашивает, о чём предупреждает и чего не делает:

Соседние задачи агент ведёт по другим скиллам: AI-агента, который отвечает в тредах, по pachca-ai-agent, работу от имени сотрудника по pachca-oauth, скрипты, пагинацию и ошибку 429 по pachca-api.

Подробнее — на страницах Доступы к чатам и сообщениям, Токены бота, Настройка и типы событий, Безопасность и обработчик, Обработка форм и Витрина.

AI-агент в Пачке

Скилл pachca-ai-agent помогает сделать AI-агента, который живёт в Пачке в виде бота. Его зовут упоминанием в чате или треде либо пишут ему в личный чат, а он собирает контекст, показывает, что работает, и отвечает там же. В этом разделе такой агент называется агентом-ботом, чтобы не путать его с агентом, который читает скилл.

Агенту, который работает в Пачке от вашего имени из программы на вашем компьютере, нужны скиллы pachca, pachca-messaging и pachca-search. Как устроен агент-бот — на странице Взаимодействие с агентом.

Агент берёт скилл по таким просьбам:

Сделай AI-агента, который отвечает, когда его упоминают в треде

Предложит настройку бота: исходящий вебхук, событие Новые сообщения в режиме Любые сообщения, права токена и проверку, к агенту-боту ли обращаются

Агент не слышит упоминание

Проверит, публичный ли бот: упоминание в треде не добавляет непубличного бота, а новый бот непубличный

Как агенту собрать контекст треда?

Покажет, что читать: историю треда по chat_id из события, родительское сообщение, сообщение, на которое ответили, и вложения

Как показать, что агент работает?

Предложит реакцию agent-thinking: вместо счётчика Пачка покажет таймер

Пусть длинный ответ приходит карточкой .md

Объяснит, как загрузить файл .md и что он должен быть единственным документом сообщения

Бот или MCP?

Сравнит, от чьего имени пишет агент и что он видит, и выберет бота, если агента зовут в Пачке

Пусть агент отвечает в личных сообщениях

Скажет, что написать боту сотрудник может, если бот публичный, у них есть общий чат не в архиве или бот написал первым

Что агент знает из скилла:

Токену агента-бота скилл даёт права messages:create, threads:create, reactions:write, messages:read, chats:read, profile:read, users:read, files:read и uploads:write. Токен с вкладки API создаётся без прав, поэтому каждое отмечают вручную, а права для самой работы агента-бота добавляют к этому набору.

Когда агент-бот оставляет решение сотруднику, переспрашивает или предупреждает:

Подпись вебхука, повторы, защиту от дублей, токены, кнопки и формы агент берёт из скилла pachca-bots, авторизацию от имени вызвавшего сотрудника из pachca-oauth, а черновики с собственным входом сотрудника из pachca-messaging.

Подробнее — на страницах Общение с ботом, Доступы к чатам и сообщениям, Оформление ответов и Черновик вместо отправки.

Работа от имени сотрудника

Скилл pachca-oauth помогает сделать бота, который работает от имени каждого сотрудника с его согласия. Сотрудник разрешает доступ на экране согласия, а бот получает токен этого сотрудника и вызывает API от его имени в пределах набора прав бота и роли сотрудника. Своё такое приложение в Пачке всегда делают ботом и настраивают на вкладке OAuth в карточке бота. Подробнее — на странице Авторизация от имени сотрудника.

Агент берёт скилл по таким просьбам:

Пусть бот ставит напоминания от имени сотрудника

Предложит авторизацию от имени сотрудника: у каждого сотрудника свой токен с набором прав из настроек бота

Включи OAuth у моего бота

Включит вкладку OAuth через pachca_update_bot с адресом возврата и минимальным набором прав в oauth_client.scopes

Как обменять код на токен?

Напишет обмен кода с тем же redirect_uri и code_verifier: на сервере бота с client_secret или в приложении на устройстве сотрудника без секрета, и учтёт, что код живёт 10 минут и срабатывает один раз

Сотрудник видит отказ вместо экрана согласия

Проверит настройку Кто может создавать персональные токены: по умолчанию в ней стоит Только администраторы, и остальные сотрудники видят отказ

Бот не присылает кнопку для авторизации

Пройдёт проверки перед запуском: может ли сотрудник написать боту, узнаёт ли бот о сообщении, есть ли у токена бота право messages:create

Токен сотрудника вернул 401 или 403

Разберёт код: после 401 токен удаляют, 403 role_forbidden повторная авторизация не исправит, а insufficient_scope исправит

Сотрудник отозвал доступ

Научит бота удалять токен после 401 и присылать кнопку снова, когда сотрудник ему напишет

Что агент знает из скилла:

Когда агент спрашивает, о чём предупреждает и что советует:

Бота, который работает от своего имени, вебхуки и витрину агент делает по скиллу pachca-bots, вход MCP-клиента и отказ инструмента разбирает по pachca, свой токен в скрипте выбирает по pachca-api, а отзыв доступа на вкладке Все токены берёт из pachca-admin.

Подробнее — на страницах Чек-лист запуска, Настройка авторизации, Получение токена и Согласие и отзыв.

API в скриптах и сервисах

Скилл pachca-api нужен, когда агент пишет код, который вызывает API Пачки: скрипт, сервис, задание CI, клиент на SDK или команды pachca в shell-скрипте. Справочник по методам скилл не повторяет: метод, его право и тело запроса агент находит в описании инструмента MCP, через pachca api или на странице метода. Подробнее — на странице Обзор API.

Агент берёт скилл по таким просьбам:

Напиши скрипт, который выгружает всех сотрудников

Сделает выгрузку в терминале, например pachca users list --all -o csv > users.csv, а не цепочкой вызовов инструментов

Какой токен дать заданию в CI?

Предложит токен бота: задание продолжит работать, даже если сотрудник, который его настроил, уйдёт

Мой код получает 403

Определит, о чём отказ: о правах токена, роли сотрудника, доступе к API вообще или доступе к чату

Упёрлись в 429

Добавит ожидание не меньше Retry-After, а при паузе больше минуты остановит задание

Поиск вернул 504 timeout, повторить?

Не станет повторять тот же запрос и сузит его: меньше чатов, короче период или конкретный автор

Обойди все страницы

Напишет цикл по курсору с явным limit и остановкой по has_next: false

Загрузи файл из кода

Сделает три шага загрузки: параметры загрузки, форма с файлом последним полем, ключ файла в сообщении

Какой метод API это делает?

Найдёт метод через pachca api ls или индекс документации и не станет придумывать путь

Что агент знает из скилла:

Ясную просьбу агент выполняет сразу. Когда он спрашивает и чего не делает без вашей просьбы:

Подключение агента и отказ инструмента MCP агент разбирает по скиллу pachca, а сообщение или файл в чат прямо сейчас отправляет по pachca-messaging. Ботов и события агент делает по pachca-bots, OAuth для сотрудников по pachca-oauth, а политику токенов и экспорт переписки ведёт по pachca-admin.

Подробнее — на страницах Авторизация, Пагинация, Ошибки, Лимиты, Файлы, SDK и Флаги и скрипты.