инженерные навыки и плагин aictrl.dev

Основные универсальные навыки для инженерных процессов с AI собраны в одном

каноническом дереве. Установите только навыки или установите плагин aictrl.dev,

чтобы получить те же навыки и управляемое выполнение рабочих процессов с подключением

через OAuth.

MCP-сервер aictrl

Размещённый MCP-сервер aictrl предоставляет агентам для программирования доступ к

контексту проекта, задачам в бэклоге, результатам проверки кода и управляемому

выполнению рабочих процессов. Подключитесь к https://aictrl.dev/mcp по протоколу

Streamable HTTP и войдите через OAuth. API-ключ и локальный процесс сервера не нужны.

Для работы потребуется учётная запись aictrl и членство в

организации aictrl. Для работы с репозиторием также необходимо подключить его через

GitHub App aictrl. Доступ определяется членством в организации, а выполнение рабочих

процессов — разрешениями и условиями подтверждения, заданными для опубликованного

рабочего процесса.

GitHub Copilot в VS Code:

• Откройте палитру команд и выполните команду MCP: Add Server.

• Выберите HTTP (HTTP or Server-Sent Events) и укажите

https://aictrl.dev/mcp. Назовите сервер aictrl и выберите место для

конфигурации.

• Запустите сервер в элементах управления MCP в VS Code и, когда появится запрос,

войдите через браузер.

Информацию о местах хранения конфигурации и управлении серверами см. в [руководстве

по настройке MCP в VS Code](https://code.visualstudio.com/docs/agent-customization/mcp-servers).

В других MCP-клиентах добавьте тот же удалённый URL и пройдите OAuth-аутентификацию,

когда появится запрос.

Плагины Claude Code и Codex, описанные ниже, уже содержат конфигурацию MCP.

Инструкции по проверке подключения и устранению неполадок см. в файле

SETUP.md.

После подключения попробуйте такие запросы:

• «Проверь, готова ли моя учётная запись aictrl к работе».

• «Какие организации aictrl мне доступны?»

• «Покажи задачи в бэклоге моей организации».

• «Перечисли опубликованные рабочие процессы, которые я могу запустить».

Этот открытый репозиторий содержит навыки, конфигурацию клиентов и метаданные

реестра для размещённого сервиса. Исходный код размещённого сервера закрыт.

Установка

Только навыки — для Codex, Claude Code, OpenCode и совместимых агентов

npx skills add aictrl-dev/skills

Плагин Claude Code

/plugin marketplace add aictrl-dev/skills
/plugin install aictrl@aictrl-public

Плагин Codex

codex plugin marketplace add aictrl-dev/skills --ref main
codex plugin add aictrl@aictrl-public

OpenCode — установите навыки с помощью npx skills add aictrl-dev/skills, затем

добавьте сервер подключённых рабочих процессов в opencode.json и войдите:

{ "mcp": { "aictrl": { "type": "remote", "url": "https://aictrl.dev/mcp", "enabled": true } } }

opencode mcp auth aictrl

Cursor / навыки для OpenCode напрямую — навыки соответствуют стандарту Agent Skills, совместимому с разными инструментами:

git clone https://github.com/aictrl-dev/skills && cd skills
./scripts/install.sh cursor       # or: opencode | all

…или скопируйте skills/* в каталог навыков своего инструмента (~/.cursor/skills, ~/.config/opencode/skills).

Затем опишите задачу обычным языком или вызовите поддерживаемую slash-команду, например

/create-issue, /implement-code-change, /code-review, /create-workflow,

или /execute-workflow.

Навыки

Навык	Назначение	Попробуйте
create-issue	Неясный запрос на новую функцию или техническую задачу → описание задачи с учётом кода, границами работ, критериями приёмки, тестами, рисками и открытыми вопросами.	/create-issue
create-bug	Симптомы или регрессия → воспроизводимое описание ошибки, подкреплённое фактами, с требованием добавить регрессионный тест.	/create-bug
spec-review	Задача или спецификация → оценка готовности с учётом репозитория и конкретные рекомендации по устранению пробелов.	/spec-review
implement-code-change	Задача → протестированный, проверенный и готовый к слиянию PR — локально или через дополнительный подключённый рабочий процесс.	/implement-code-change
create-pr	Точная версия кода и подтверждающие данные → лаконичные заголовок и описание PR, готовые для проверки; сведения о выпуске и проверках изложены без преувеличений.	/create-pr
code-review	Точная версия PR → конкретные замечания по корректности, безопасности, надёжности и тестам; без изменений кода.	/code-review
judge-review-findings	Замечания к текущей версии кода → оценка TRUE/FALSE/UNCERTAIN и решения FIX/DEFER/IGNORE.	/judge-review-findings
reply-to-code-review	Принятые замечания по результатам проверки кода → исправления, проверка, ответы с подтверждающими данными и ограниченная повторная проверка.	/reply-to-code-review
root-cause-analysis	Инцидент или повторяющийся сбой → анализ причин на основе фактов, карта связанных уязвимых участков и набор мер по предотвращению.	/root-cause-analysis
create-workflow	Описание желаемого рабочего процесса → проверенный YAML рабочего процесса aictrl.dev v2 с переносимыми встроенными узлами задач.	/create-workflow
execute-workflow	Опубликованный рабочий процесс → запуск с явным разрешением и защитой от повторного выполнения, безопасный мониторинг, контрольные точки, отмена и надёжная передача управления.	/execute-workflow
design-review	Передайте HTML-макет или снимок экрана и получите чёткий разбор с указанием проблемных элементов: IA, ценностное предложение, иерархия, доверие и препятствия, a11y. В конце — список «Сначала исправьте эти 3 проблемы».	/design-review path/to/mock.html
measurement-plan	Функция → структурированный план измерений: цели обучения, таблица метрик, события продуктовой аналитики, изменения в хранилище данных и конвейер событий.	/measurement-plan
recording-product-demo	Укажите репозиторий с веб-интерфейсом — инструмент запустит приложение, подготовит демонстрационные данные и авторизацию, запишет озвученную демонстрацию в Playwright с фиксированным таймингом и синхронизацией с голосовой дорожкой ElevenLabs, а затем соберёт комплект для публикации (MP4 + субтитры + встраиваемый материал).	/recording-product-demo
explain-change	PR, диапазон коммитов или проектный документ → техническое объяснение, основанное на фактах, с разбором архитектуры, сложных компромиссов и реального состояния выпуска.	/explain-change
ui-polish	Укажите экран — инструмент отобразит его на телефоне и компьютере, измерит то, что не видно на снимках экрана (выравнивание колонок, ширину полей, подписи, области нажатия, контрастность, пустое пространство), исправит исходный код и повторит измерения, пока проверки не пройдут.	/ui-polish
ux-testing	Укажите страницу или прототип и несколько задач — AI-тестировщики проверят их как новые пользователи, используя дерево доступности или снимки экрана. Успех проверяется по состоянию страницы, а не по словам тестировщика. Затем цикл проверки дизайна и исправлений запускает повторное тестирование и формирует сравнительную оценку. При необходимости можно задействовать симулированных пользователей для проверки гипотез о макете.	/ux-testing path/to/page.html

Как работает design-review

Входные данные: макет целевой страницы SaaS-продукта.

Value Proposition — WEAK
  Заголовок в первом экране «Workflows made simple» ничего не говорит о назначении продукта.
  Fix: замените его одной строкой, которая называет пользователя, проблему и результат.

Actionability — BROKEN
  В первом экране конкурируют три призыва к действию: Start free, Book demo и Watch video.
  Fix: оставьте в первом экране один основной призыв к действию, остальные переместите ниже.

В каждом замечании указан конкретный элемент. Каждое исправление можно выполнить. Никаких общих рекомендаций вроде «сделать понятнее».

Как работает ux-testing

При проверке дизайна внутренней очереди задач начинающие пользователи-агенты получили

задание начать наиболее важную доступную работу, но вместо этого одобрили проверку

безопасности (v5: 2 из 2). После того как в ходе цикла исправлений доступную работу

переместили выше запросов на утверждение, все 3 из 3 агентов выбрали нужную задачу.

Симулированные пользователи повторили ту же ошибку: 72% нажали «Approve». Проверки

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

не создал. Подробнее:

Тестирование удобства использования с помощью AI для дизайна бэклога.

Зачем они нужны

Эти навыки бесплатны и доступны отдельно. aictrl.dev

добавляет управляемое удалённое выполнение, согласование действий, политики, историю,

интеграции и ограничения расходов. implement-code-change может использовать

подключённый рабочий процесс, если он настроен, а execute-workflow безопасно

работает с уже опубликованным рабочим процессом. Для всех навыков запуска, кроме

execute-workflow, который работает только в подключённом режиме, доступен локальный

режим.

Плагины Claude и Codex, а также установка через skills.sh используют каталог

skills/ в корне репозитория напрямую. Отдельных копий для разных поставщиков,

которые нужно было бы обновлять или редактировать вручную, нет. Подключённое

выполнение всегда использует идентификатор MCP aictrl по адресу

https://aictrl.dev/mcp; OAuth запрашивается только при использовании подключённого

рабочего процесса.

Конфиденциальность, условия использования и поддержка

Навыки работают локально и не отправляют данные на aictrl.dev. Встроенный сервер

MCP aictrl используется только после подключения через OAuth. Информация о том,

какие данные он собирает и хранит, приведена в политике конфиденциальности и

условиях использования. Поддержка: aictrl.dev/support

или info@aictrl.dev. Сообщения об уязвимостях:

security.txt. Инструкции по настройке

подключения MCP приведены в SETUP.md.

Необязательные сторонние сервисы и ключи

Два навыка могут отправлять данные стороннему сервису — только на указанных ниже

этапах и только при запуске этих навыков. При установке ничего не запускается.

Ключ считывается только для соответствующего этапа, отправляется только сервису,

указанному в той же строке, и никогда не выводится на экран, не записывается в

журнал и не сохраняется. Каждый ключ передаётся только тому сервису, которому он

принадлежит: ключ ElevenLabs отправляется только в ElevenLabs, учётные данные

Google — только в Google, ключ TypeSafe — только в TypeSafe, а ключ пользовательского

симулятора — только на заданную для него конечную точку. Встроенный сервер MCP

aictrl не получает ни один из этих ключей.

Другие навыки не отправляют данные сторонним сервисам; навыки, работающие в браузере

(ui-polish, ux-testing), загружают только указанный вами URL приложения.

Навык	Этап	Сервис и передаваемые данные	Читаемые переменные среды
recording-product-demo	Озвучивание и проверка клипов (tts-oneshot.cjs, --verify-clip-starts); split-narration.py разделяет текст локально	ElevenLabs (api.elevenlabs.io): текст озвучивания, созданное аудио для синхронизации распознавания речи и первые четыре секунды каждого клипа сцены для проверки границ	Предоставленный пользователем ELEVENLABS_API_KEY; необязательные ELEVENLABS_VOICE_ID, ELEVENLABS_MODEL, ELEVENLABS_STT_LANG. Файлы с учётными данными не считываются.
recording-product-demo	Загрузка на YouTube (publish.cjs --upload с publish.upload.type youtube; включается по желанию)	Google (oauth2.googleapis.com, www.googleapis.com): готовый MP4, заголовок и описание; материалы загружаются на ваш канал	YT_CLIENT_ID, YT_CLIENT_SECRET, YT_REFRESH_TOKEN
recording-product-demo	Загрузка в хранилище (publish.cjs --upload с publish.upload.type gcs или s3; включается по желанию)	Google Cloud Storage или Amazon S3 — через вашу команду gcloud storage cp или aws s3 cp: весь комплект публикации (MP4-файлы, постер, субтитры, страница для встраивания, PUBLISH.md) загружается в заданный вами путь хранилища	Нет: CLI использует собственные учётные данные пользователя
ux-testing	Симуляция пользователей (необязательно; для тестирования агентами ключ не нужен)	TypeSafe (api.typesafe.ai) или указанная вами конечная точка: состояние страницы и возможные действия для каждого шага симуляции	TYPESAFE_API_KEY (UX_SIM_MODEL позволяет задать модель вместо используемой по умолчанию) либо UX_SIM_ENDPOINT + UX_SIM_API_KEY + UX_SIM_MODEL

Без этих переменных навыки всё равно работают: recording-product-demo остановится

перед озвучиванием или загрузкой и сообщит, какого ключа не хватает, а

ux-testing продолжит работу только с тестированием агентами. UX_VERIFY_TOKEN —

локальный токен для обмена данными между скриптами ux-testing и их локальным

сервером; он никогда не передаётся за пределы компьютера.

Участие в разработке

Мы приветствуем PR с новыми навыками — подробности см. в CONTRIBUTING.md.

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