К основному содержанию
скилл CX Codex

windows-sandbox-app-test — скилл для Claude Code

Скилл windows-sandbox-app-test для Claude Code проверяет Windows-приложения и пакеты MSIX в чистой Windows Sandbox. Запускается, когда нужно выяснить, работает ли сборка без сред разработки и установленных рантаймов.

MIT ★ 494 обновлён 2026-11-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add shanselman/sandbox-mcp --skill windows-sandbox-app-test -a claude-code
Открыть на GitHub

Что делает windows-sandbox-app-test

Скилл запускает приложение в одноразовой Windows Sandbox, проверяет сбои и делает скриншот. До запуска sbx deps <path> сканирует зависимости на хосте; затем sbx run <app.exe|folder> копирует приложение в песочницу, запускает его и сохраняет отчёт. Для папки с несколькими .exe нужно указать исполняемый файл.

Можно передать тестовый .ps1, собрать файлы из песочницы или оставить её запущенной для проверки. Для .msix, .msixbundle, .appx и .appxbundle скилл устанавливает пакет и активирует приложение; для манифеста с несколькими приложениями нужен appId. Windows Sandbox очищается после остановки. Отсутствующий рантайм считается найденной проблемой: установка рантайма меняет результат на проверку с подготовленной средой, а не на чистой машине.

Какие задачи решает

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

Примеры запросов агенту

  • Проверь, запустится ли build\MyApp.exe в чистой Windows Sandbox.
  • Найди зависимости для dist\MyApp.exe и проверь запуск без установки рантаймов.
  • Запусти app.msix с тестом smoke.ps1 и сохрани отчёт.

Как установить windows-sandbox-app-test

1Через Skills CLI (Vercel)

npx skills add shanselman/sandbox-mcp --skill windows-sandbox-app-test -a claude-code

2Вручную: положить файлы

~/.claude/skills/windows-sandbox-app-test/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/windows-sandbox-app-test/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о windows-sandbox-app-test

Как установить windows-sandbox-app-test в Claude Code?

Выполни npx skills add shanselman/sandbox-mcp --skill windows-sandbox-app-test -a claude-code. Файл скилла появится по пути ~/.claude/skills/windows-sandbox-app-test/SKILL.md.

Что делает windows-sandbox-app-test?

Запускает Windows-приложение или MSIX-пакет в чистой Windows Sandbox, ищет сбои, делает скриншот и формирует отчёт. Можно добавить тестовый скрипт.

Что нужно для работы windows-sandbox-app-test?

Для запуска через командную строку используется sbx; также можно подключить необязательный MCP-адаптер. Проверка проходит в Windows Sandbox, а приложение и тестовый скрипт передаются с хоста.

Исходный текст

SKILL.md · MIT
---
name: windows-sandbox-app-test
description: Check that a Windows desktop or console app, or an MSIX package, runs on a fresh, throwaway Windows machine (Windows Sandbox) in one call, with dependency diagnosis, a screenshot, crash check, optional test script and report. Use when asked to "try my build on a clean machine", check that an exe runs without the dev box's installed runtimes, find which runtimes an app needs, smoke-test a build, or reproduce "works on my machine" bugs, using sbx or the optional MCP adapter.
---

# Test an app on a clean machine

This skill documents v1.2.0. Older ZIPs don't contain every tool below.

Windows Sandbox is a clean Windows 11 VM that boots in about 15-20 s and is **destroyed on stop**. Only **one** can run at a time. Nothing from the host is installed in it: no dev tools, no Store apps (no Notepad, Calculator, Terminal) and no winget. It has Windows PowerShell 5.1 and .NET Framework 4.8. Treat it like a brand-new customer PC.

If shell access is available, use the `sbx` CLI; the optional MCP adapter uses the same engine and is not required.

Use a different skill for other jobs:

- Testing an installer or uninstaller: windows-sandbox-installer-test
- Running a file you don't trust: windows-sandbox-detonate
- Multi-step UI work or a warm deploy loop: windows-sandbox-interactive
- "Windows Sandbox isn't ready" or missing tools: windows-sandbox-setup

## 1. Diagnose dependencies first

Run `sbx deps <path>` or call `sandbox_deps` with `path`. It's a host-only static scan that doesn't boot a sandbox, run the app or install anything. Its output includes the scan's limits and any uncertain optional components, so report those too.

## 2. Run it

Run `sbx run <app.exe|folder>` or call `sandbox_run` with `app` set to a host path. Both use the same workflow: boot the sandbox, copy the app in, run it, capture a screenshot, check the event log for crashes, optionally run a test script, copy files out, destroy the sandbox and write `report.md`. The MCP adapter can return the screenshot inline; the CLI writes it to the report folder. Measured GUI samples take roughly 40-50 s.

- **`app`** is an `.exe` (its whole folder is copied), a folder, or a package. Pass `exe` if a folder has more than one `.exe`.
- **`console: true`** is for console apps. It runs to completion and captures stdout. Without it, the app is launched as a GUI app and given `waitSec` (default 5) to settle.
- **`args`** passes command-line arguments.
- **`collect`** lists sandbox paths to copy back to the host, such as logs or output files.
- **`record: true`** records the desktop at 2 fps for up to 120 s, and the report links the recording.
- **`network`** is `on` by default. Use `off` to prove the app works with no network at all.
- **`keep: true`** leaves the sandbox running so you can investigate with the windows-sandbox-interactive tools. Call `sandbox_stop` when you're done.

## Missing runtimes are findings

A missing prerequisite is often exactly the bug being hunted. **Don't install one to get a pass unless the user explicitly asks.** Report which runtime is missing, and suggest bundling it or publishing self-contained.

If the user does ask, pass `provision: "auto"` or a list such as `desktop:10.0:x64,vcredist:x64` (CLI: `--provision auto`). The host downloads and verifies official Microsoft installers and copies them in, so guest networking can stay off. Always label that result **provisioned, not a clean-machine pass**.

## Packaged apps

For `.msix`, `.msixbundle`, `.appx` or `.appxbundle`, `sandbox_run` installs offline dependencies and activates the app, then follows the same screenshot, UI Automation and report flow. No Store or package download is attempted.

- `cert` is a public `.cer`, trusted only in the disposable guest.
- `deps` is a folder of dependency packages. It defaults to a `deps` folder beside the package.
- `appId` is required if the manifest has several applications.

```powershell
sbx run app.msix --cert devcert.cer --deps Dependencies\x64 --app-id App --network off
```

Tests for packages get `$env:SBX_APP_AUMID`. The package's install folder is read-only, so write files to `$env:SBX_OUT` or app data.

## Read the result

The run fails when the app exits non-zero, a console app times out, the test script fails, or the event log has a crash or error mentioning the exe.

**PASS doesn't prove the app works.** It means the app started and nothing crashed. A GUI app that shows an error dialog and keeps running can still pass. Always look at the returned screenshot, and describe what it shows. Add a test script to check real behavior.

Artifacts stay on the host after the sandbox is gone: `report.md`, `report.json`, screenshots and collected files in the run's `out` folder.

## Add a test script

`test` is a host `.ps1` that runs **inside** the sandbox after launch. Throw or exit non-zero to fail. It gets:

- `$env:SBX_APP_PID`, `$env:SBX_APP_DIR` and `$env:SBX_APP_EXE`
- `$env:SBX_OUT`; anything written there comes back to the host
- `Get-SbxUiTree`, `Invoke-SbxUi` and `Wait-SbxUi`, already imported

```powershell
$ErrorActionPreference = 'Stop'
$app = @{ ProcessId = $env:SBX_APP_PID }
Invoke-SbxUi @app -AutomationId NameBox -Action setvalue -Value 'Sandbox'
Invoke-SbxUi @app -Name Greet -Action click
Wait-SbxUi @app -Name 'Hello, Sandbox!' -TimeoutSec 5 | Out-Null
```

UI Automation works for WinForms, WPF, Win32 and WinUI. To find control names, start with `keep: true` and read them with `sandbox_ui_tree`.

## Common errors

- **`A sandbox is already running`:** one-shot runs don't queue. See the windows-sandbox-setup skill.
- **`Say which exe to run`:** the folder has several `.exe` files or none. Pass `exe`, or point at the right folder.

© Scott Hanselman · MIT · shanselman/sandbox-mcp

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
sandbox-self-test tomgranot Скилл sandbox-self-test проверяет набор HubSpot-скиллов в отдельном тестовом аккаунте: создаёт фикстуры, запускает сценарии, формирует отчёт и удаляет данные. CX Codex +1 ★ 81звёзд репо conducting-mobile-app-penetration-test mahipal Скилл conducting-mobile-app-penetration-test помогает проверять безопасность iOS- и Android-приложений: анализировать бинарники, сетевой трафик, хранение данных и аутентификацию. Используйте его для авторизованного тестирования. CX Codex +1 315установок test-slack-app slackapi Скилл test-slack-app для Claude Code проверяет, что Slack-приложение на Bolt или Slack CLI действительно работает. CX Codex +1 1 300установок test-mac-app daveebbelaar Скилл test-mac-app для Claude Code помогает проверять macOS-приложение на нескольких уровнях — от Swift-тестов до управления запущенной программой. Активируется при добавлении логики, исправлении ошибок и проверке перед релизом. CX Codex +1 1 000установок windows-app-storage-inspector-cleanup официальный Daniel Scott-Raynsford Плагин windows-app-storage-inspector-cleanup для GitHub Copilot анализирует место, занятое приложениями Windows, и переносит одобренные файлы в корзину для безопасной очистки диска. ★ 41 430звёзд репо test-macos-app официальный OpenAI Команда test-macos-app для Codex выбирает узкий сценарий тестирования macOS и распределяет сбои по категориям. Проверяет Xcode- и Swift-проекты. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо

Из того же набора6

windows-sandbox-detonate Скилл windows-sandbox-detonate для Claude Code запускает подозрительные файлы в изолированной Windows Sandbox без сети. Агент показывает процессы, изменения системы и сетевую активность. CX Codex +1 ★ 494звёзд репо windows-sandbox-installer-test Скилл windows-sandbox-installer-test для Claude Code проверяет установщики и деинсталляторы Windows в чистой Windows Sandbox. Запускается по запросу проверить тихую установку .exe или .msi, зависание либо следы после удаления. CX Codex +1 ★ 494звёзд репо windows-sandbox-setup Скилл windows-sandbox-setup для Claude Code проверяет и настраивает Windows Sandbox для работы через CLI или MCP. Запускается перед первым использованием, при ошибке готовности или когда уже открытая песочница мешает создать новую. CX Codex +1 ★ 494звёзд репо windows-sandbox-interactive Скилл windows-sandbox-interactive для Claude Code управляет приложением в работающей Windows Sandbox. Он помогает пройти UI-сценарий, воспроизвести ошибку или сравнить состояние системы до и после действия. CX Codex +1 ★ 494звёзд репо sandbox-mcp Запускает приложения в отдельной Windows Sandbox и даёт агенту управлять их интерфейсом. Он помогает проверить установщик, приложение или подозрительный файл в чистой среде. ★ 494звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой