qt-qml-test-run — скилл для Claude Code: что делает и как установить
Собирает проект на Qt 6 и запускает тесты Qt Quick Test через qmltestrunner или CTest, после чего формирует отчёт в Markdown. Пригодится для проверки компонентов QML в проектах на CMake.
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a claude-codeЧто делает qt-qml-test-run
Скилл находит установку Qt 6 в системе, обнаруживает файлы tst_*.qml и запускает их. Если тесты используют простые относительные пути, утилита может вызвать qmltestrunner напрямую без изменения файлов сборки. Для проектов со статическими библиотеками QML прямой запуск не сработает: в этом случае флаг --wire-up генерирует обвязку tests/CMakeLists.txt и tests/main.cpp, добавляя нужные строки в корневой CMake.
После выполнения тестов скилл парсит полученный JUnit XML с помощью внутреннего скрипта Python и сохраняет итоговый отчёт в формате Markdown. Флаг --no-build позволяет пропустить этап компиляции, а --no-report отключает запись файлов отчёта при частых циклах отладки.
Инструмент рассчитан только на CMake и требует доступ к терминалу с настроенным окружением сборки. Проекты на qmake или кросс-компиляция для внешних устройств здесь не поддерживаются.
Какие задачи решает
- запустить тесты QML через qmltestrunner без ручной настройки CMake
- сформировать тестовую обвязку QUICK_TEST_MAIN для CTest с помощью флага --wire-up
- получить отчёт Markdown по результатам прогона тестов Qt Quick
- проверить исправления в тестах QML без повторной сборки проекта через ключ --no-build
Примеры запросов агенту
- Запусти тесты QML в проекте и подготовь отчёт в Markdown
- Выполни qmltestrunner для файлов tst_*.qml с флагом --wire-up
- Прогони тесты QML без пересборки проекта с аргументом --no-build
Как установить qt-qml-test-run
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a claude-code2Вручную: положить файлы
~/.claude/skills/qt-qml-test-run/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qt-qml-test-run/
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a codex2Вручную: положить файлы
.agents/skills/qt-qml-test-run/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a cursor2Вручную: положить файлы
.cursor/skills/qt-qml-test-run/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install TheQtCompanyRnD/agent-skills qt-qml-test-run2Вручную: положить файлы
.github/skills/qt-qml-test-run/SKILL.md1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a gemini-cli2Командой платформы
gemini skills install https://github.com/TheQtCompanyRnD/agent-skills --path skills/qt-qml-test-runВручную: положить файлы
.devin/skills/qt-qml-test-run/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора8
Похожие
Рядом в теме «Тесты и QA»
Всё по теме «Тесты и QA» →Вопросы о qt-qml-test-run
Как установить qt-qml-test-run в Claude Code?
Выполните команду npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a claude-code. Также можно вручную поместить файл SKILL.md по пути ~/.claude/skills/qt-qml-test-run/SKILL.md.
Что делает скилл qt-qml-test-run?
Он обнаруживает файлы tst_*.qml, собирает проект на CMake с Qt 6, запускает исполняемый бинарник или qmltestrunner и формирует отчёт Markdown на основе JUnit XML.
Зачем нужен флаг --wire-up для статических модулей QML?
Статические библиотеки QML не имеют динамических плагинов, поэтому прямой запуск qmltestrunner завершается ошибкой импорта модулей. Флаг --wire-up создаёт обвязку C++ и настраивает таргеты CMake для корректной линковки.
