Правила команды говорят ИИ-агентам, чего ждёт ваша дизайн-система: какие компоненты не брать, какие брать в первую очередь и чего не должно быть в коде. Агенты получают правила через MCP-сервер FISYCO ещё до того, как начнут писать код. А отчёт об агентах показывает, как они пользовались дизайн-системой и чего в ней не нашли.
Перед началом
- Для проекта настроена дизайн-система в коде: откройте проект и найдите Дизайн-система в коде в разделе Из кода. См. Подключение дизайн-системы.
- Разработчики подключили своих агентов к FISYCO. См. Подключение ИИ-агентов через MCP.
Как агенты получают правила
Правила не лежат в файле, который агент может и не открыть. Они меняют сами ответы MCP-сервера:
- Поиск. Когда агент ищет компонент, поиск не предлагает скрытые компоненты и ставит предпочтительные первыми.
- Правила и руководство. Инструмент
get_design_system_rulesи руководство по дизайн-системе пересказывают агенту правила целиком. - Проверка кода.
check_ui_codeставит нарушения правил первыми и показывает сообщение вашей команды.
Проверка pull request применяет те же правила. Поэтому агент и ревьюер видят к одному коду одно и то же замечание.
Где живут правила
У правил два уровня.
Правила пространства действуют во всех его проектах. Проект может добавить к ним свои, но ослабить их не может. Списки с обоих уровней складываются, а переключатель, включённый хотя бы на одном уровне, остаётся включённым. Карточка проекта показывает, сколько правил пространства действует и в нём.
Как добавить правило в проект
- Откройте проект, затем Дизайн-система в коде → Настройки.
- Найдите карточку Правила для ИИ-агентов.
- Включите переключатель или впишите строки в список: одна запись на строку.
- Нажмите Сохранить правила. Кнопка становится активной, как только что-то изменилось.
Какими бывают правила
Строка в Запрещено в коде выглядит так:
!important | Используйте вариант компонентаТекст до черты ищется буквально, без регулярных выражений. Строки комментариев и импортов не проверяются. Сообщение после черты увидят и агент, и ревьюер pull request.
Как читать отчёт об агентах
Откройте проект, затем Дизайн-система в коде → ИИ-агенты. Отчёт охватывает не больше последних 30 дней, даты периода указаны вверху.
Под показателями строка с оценкой здоровья дизайн-системы из 100 и тем, как она изменилась с начала периода. Подробнее см. Здоровье дизайн-системы. В списке Агенты каждый агент назван по имени, рядом его вызовы и число разработчиков.
Недостающие компоненты
В списке Недостающие компоненты собраны поиски, которые не нашли в дизайн-системе ничего близкого, и сколько раз о каждом спрашивали. Показывается до 20 запросов, частые сверху. Запрос, который повторяется снова и снова, подсказывает, какой компонент стоит добавить в ui-kit. Если список пуст, агенты нашли всё, что искали.
Когда отчёт пуст
Пока ничей агент не обратился к FISYCO по проекту, вкладка сообщает, что агенты ещё не обращались к этой дизайн-системе. Кнопка Подключить агента открывает страницу «ИИ-агенты» в настройках аккаунта.
Письмо раз в месяц
Владельцы пространства получают этот же отчёт письмом раз в месяц, за прошедший месяц. Письмо приходит только по проектам, к которым агенты обращались в этом месяце.
FISYCO считает вызовы инструментов: какой агент, какой инструмент и чем закончился вызов. Исходный код он не хранит, и код, отправленный в check_ui_code, тоже не сохраняется. Из текста поисков остаётся только короткая фраза из поиска компонента, который ничего не нашёл. Всё, что похоже на код, отбрасывается, а фраза удаляется через 30 дней.