steelmorgan/vanessa-diagnostics
framework/skills/tool-usage/vanessa/vanessa-diagnostics/SKILL.md
MUST use WHEN feature-сценарий не прошёл, артефакты не создались или нужно классифицировать сбой после запуска. Provides алгоритм разбора артефактов прогона и классификации типа ошибки.
$ install --global
skillsauthnpx skillsauth add steelmorgan/1c-agent-based-dev-framework vanessa-diagnosticsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 13, 2026, 5:48 AM106.0s1 file scanned
SKILL.md
- name:
- vanessa-diagnostics
- description:
- MUST use WHEN feature-сценарий не прошёл, артефакты не создались или нужно классифицировать сбой после запуска. Provides алгоритм разбора артефактов прогона и классификации типа ошибки.
Диагностика Vanessa Automation
Запуск Vanessa делается через v8-runner test va (см. навык v8-runner → references/testing.md). Этот навык — про то, как разобрать упавший прогон.
Артефакты прогона
Слоя два — не путать:
| Слой | Что пишет | Где лежит |
|------|-----------|-----------|
| Артефакты Vanessa | сам VA-плеер (va-status.json, vanessa-execution.log, отчёты junit/junit.xml, cucumber/CucumberJson.json) | по путям из активного профиля tests.va / va-params, обычно project-local (<project_root>/vanessa-tests/reports/…, .../logs/…) |
| Run-артефакты v8-runner | сам v8-runner (внутренние логи запуска, stdout/stderr 1cv8c, метаданные run-id) | workPath/temp/<runner-id>/runs/<run-id>/ (workPath берётся из v8project.yaml) |
При падении прогона не очищать обе локации до завершения диагностики. Точные пути Vanessa-отчётов читать из активного профиля.
Мониторинг прогресса во время прогона
Для длительных операций v8-runner test va (обычно несколько минут) используй инструмент Monitor вместо слепого опроса файлов:
- Запусти v8-runner в фоне:
Bash run_in_background: true, перенаправь stdout в файл лога (напримерv8-runner test va 2>&1 | tee /tmp/va-stdout.log). - Подпишись на этот файл через инструмент Monitor с фильтром:
ERROR:|\\[artifact\\]|passed|Failed:— каждая совпавшая строка придёт как уведомление. - Завершай ожидание при выполнении любого условия:
va-status.logпоявился в каталоге прогона (создаётся при успехе И при ошибке — в отличие отva-status.json);- процесс
1cv8c.*vanessa-automationзавершился; - в stdout появилась строка
ERROR:(напримерERROR: runtime error: test run reported failures).
- Не используй
va-status.jsonкак единственное условие выхода. Он создаётся только при штатном завершении сценария; при раннем падении (ошибка шага, краш клиента) файл отсутствует и ожидание по его наличию зависнет навечно.
После завершения прогона переходи к порядку диагностики ниже.
Когда применять
| Триггер | Действие |
|---------|----------|
| va-status.json не создан | Считать запуск аварийным, идти в диагностику |
| va-status.json != 0 | Читать артефакты и классифицировать падение |
| vanessa-execution.log содержит ошибку | Определить класс ошибки |
| Подозрение на блокировку GUI | Визуальная диагностика |
| Прогон «зелёный», но 0 шагов выполнено / шаги undefined/skipped | Ложный успех — классифицировать как step_resolution_error/scenario_error |
Обязательный порядок диагностики
- Проверить
va-status.json. - Проверить
vanessa-execution.log. - Проверить
event-log: сначала последниеError; если пусто — без фильтра уровня. - Если сигнал на модальное окно / security warning —
gui-control/screenshot. - Только если недостаточно —
tech-log-analysis.
Special-case: Предупреждение безопасности
Если в event-log запись о Предупреждение безопасности для bddRunner.epf или плагинов:
- Считать триггером на визуальную проверку.
- Открыть реальный экран через noVNC или снять скриншот (не полагаться на заголовки X11-окон).
- Только после визуального подтверждения трактовать повторный запуск.
Классы ошибок
| Класс | Когда ставить |
|-------|---------------|
| scenario_error | Сценарий неверно сформулирован или использует неподходящий поток |
| step_resolution_error | Нужный шаг не найден или не резолвится |
| assertion_error | Шаги выполнились, проверка результата не совпала |
| test_data_error | Зависит от отсутствующих/неподходящих данных |
| environment_error | Проблема в X11, окружении, runner, запуске клиента |
| product_ui_error | Ошибка видимого поведения формы или UI-потока |
| product_logic_error | Бизнес-логика даёт неверный результат при корректном сценарии |
Быстрая эвристика
| Сигнал | Класс |
|--------|-------|
| Нет va-status.json, GTK/X11 error | environment_error |
| Не найден шаг | step_resolution_error |
| Форма открылась, ожидание не совпало | assertion_error / product_ui_error |
| Ошибка из бизнес-модуля в ЖР | product_logic_error |
| Документ/объект не найден | test_data_error |
Результат диагностики
Агент должен сообщить: класс ошибки, главный источник сигнала, следующий контур действий.
failure_type = test_data_error
main_signal = document not found in event log / form flow
next_action = choose another fixture or prepare stable test data
depends_on:
- framework/rules/vanessa-diagnostics-policy.mdc
- framework/rules/vanessa-security-warning.mdc
- framework/skills/tool-usage/v8-runner/SKILL.md
- framework/skills/tool-usage/diagnostics/event-log-analysis/SKILL.md
- framework/skills/tool-usage/diagnostics/tech-log-analysis/SKILL.md
- framework/skills/tool-usage/browser-ui/gui-control/SKILL.md
- framework/skills/tool-usage/browser-ui/screenshot/SKILL.md
Related Skills
steelmorgan/source-of-truth
testing
VerifiedTrustedCommunity
MUST use BEFORE making a judgment about the cause of a conflict, a test failure, or an artifact dispute. Defines the end-to-end verification method L1→L6 and the classification of the first broken link.
69SKILL.mdUpdated Jun 13, 2026
steelmorgan/skill-learning
development
VerifiedTrustedCommunity
MUST use AFTER a work cycle with ≥2 iterations (wrote → error → fixed → success). Provides the retrospective procedure and the format for recording practice/anti-patterns in references/learned-patterns.md or {project}/.context/learned-patterns.md.
69SKILL.mdUpdated Jun 13, 2026
steelmorgan/rlm-workflow
tools
VerifiedTrustedCommunity
MUST use WHEN you are writing reusable knowledge into RLM (pattern / architectural decision / stable domain fact) OR reading it before a non-trivial task/solution in the domain. Provides the breakdown of native-push vs RLM-pull, tools for writing and reading RLM, H-MEM levels, and hygiene.
69SKILL.mdUpdated Jun 13, 2026
steelmorgan/quick-fix
testing
VerifiedTrustedCommunity
MUST use WHEN the task is classified as simple (< 20 lines, 1 file, no new metadata objects, no architectural decisions). Provides a short cycle of 3 steps with a guard on the self path and mandatory verify.
69SKILL.mdUpdated Jun 13, 2026