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

skillshare-windows-utm — скилл для Claude Code: запуск и тесты

Скилл skillshare-windows-utm проверяет работу skillshare на гостевой Windows в UTM: собирает коммит в devcontainer, передаёт бинарники в виртуалку и запускает E2E-тесты путей и симлинков.

MIT ★ 3 269 обновлён 2026-10-29

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

Что делает skillshare-windows-utm

Скилл управляет локальной виртуальной машиной Windows через scripts/windows/utm.sh. Тесты на Linux не воспроизводят поведение Windows-ссылок, поэтому бинарники ss.exe и UI собираются из конкретного коммита в devcontainer и копируются в гостевую систему.

Запуск выполняется через utm.sh task от имени обычного пользователя, потому что вызов через utmctl exec идёт с правами SYSTEM и всегда разрешает создавать симлинки. Для проверки фоллбэка на копирование используется токен базового пользователя (--basic), лишённый прав на симлинки. Все тестовые данные изолируются в C:\Users\Public\sstest\.

Без залогиненного пользователя в окне UTM интерактивные задачи не запустятся вовсе.

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

  • проверить создание джанкшенов и симлинков в гостевой Windows
  • протестировать сценарий fallback-копирования без прав на симлинки
  • собрать бинарники skillshare под нужную архитектуру в devcontainer
  • развернуть изолированное окружение для ручной проверки на Windows

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

  • Проверь симлинки в Windows UTM для коммита HEAD в автоматическом режиме
  • Запусти ручную проверку Windows UTM для ветки main
  • Проверь гостевую систему UTM и протестируй токен базового пользователя

Как установить skillshare-windows-utm

1Через Skills CLI (Vercel)

npx skills add runkids/skillshare --skill skillshare-windows-utm -a claude-code

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

~/.claude/skills/skillshare-windows-utm/SKILL.md

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

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

Вопросы о skillshare-windows-utm

Как установить skillshare-windows-utm в Claude Code?

Выполните команду npx skills add runkids/skillshare --skill skillshare-windows-utm -a claude-code.

Зачем нужен skillshare-windows-utm?

Тесты на Linux не показывают работу с путями, джанкшенами и симлинками Windows. Скилл прогоняет сценарии на реальной гостевой системе в UTM с проверкой прав доступа.

Почему тесты не запускаются через utmctl exec напрямую?

Команда utmctl exec выполняется от имени SYSTEM с безусловным правом на создание симлинков. Для проверки поведения реального пользователя скрипты запускаются как интерактивные задачи через utm.sh task.

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

SKILL.md · MIT
---
name: skillshare-windows-utm
description: >-
  Verify skillshare on a real Windows guest running in local UTM: build a pinned
  commit in the devcontainer, push it into the VM, and either run the Windows E2E
  runbook with full and basic-user tokens or hand the maintainer a one-line
  hands-on setup. Use this whenever a change touches Windows links, junctions,
  file symlinks, Developer Mode, copy fallback, Windows paths, or the dashboard on
  Windows, or when the user asks to test or accept something on Windows / UTM.
argument-hint: "[auto | manual] [git-ref]"
metadata:
  targets: [claude, universal]
---

Linux tests cannot show Windows link behavior. This skill drives the local UTM guest with
`scripts/windows/utm.sh`. Before acting, run `python3 scripts/ai-context.py testing` and follow its
"Windows Verification" section; it is the source of truth for the rules below.

## Rules

- Build in the devcontainer from a **pinned commit** (`utm.sh build <ref>`), never from the working
  tree: other work may be editing it. Report the commit hash with every result.
- The host only drives the VM (`utmctl`). Never run `ss`, `go` or `pnpm` on the host.
- `utmctl exec` runs as SYSTEM, which can always create symlinks. Product behavior must run as the
  desktop user through `utm.sh task` (Interactive scheduled task). Use `--basic` for the basic-user
  token (`runas /trustlevel:0x20000`), which has no symlink right. Never switch to S4U: its token
  differs from a real user's.
- Isolate automated runs under `C:\Users\Public\sstest\`. Clean up with `utm.sh clean`, which uses
  `rmdir` (it does not follow junctions).
- Report which token (full or basic) and architecture each result came from.

## 1. Preflight

```sh
scripts/windows/utm.sh probe
```

| Output | Meaning and action |
|---|---|
| `stopped` | `utmctl start Windows`, then probe again after boot. |
| `OSStatus -1712` | macOS Automation permission for the terminal app is missing; ask the user to allow it. |
| `OSStatus -2700` / guest agent error | Guest still booting or agent not up. Wait, then retry. |
| `desktopUser=` empty | Nobody is logged in; Interactive tasks will not start. **Ask the user to log in** in the UTM window. Restarting the VM logs the user out. |
| `arch=ARM64` / `AMD64` | Use it as the build arch (`arm64` / `amd64`). |
| `devMode=1` | Developer Mode is on; the basic token may still create symlinks. Say so in the report. |

## 2. Build and push

```sh
scripts/windows/utm.sh build <ref> <arm64|amd64>   # ss.exe, ss-ui-dist.zip, ss-version.txt in $OUT
```

The UI zip is unpacked into `%APPDATA%\skillshare\ui\<version>` so `ss ui` never downloads it.
`utmctl file push` needs an existing guest folder; create one with `utm.sh ps` first, or push to
`C:\Users\Public\`.

## 3a. Automated acceptance (`auto`)

1. Create `C:\Users\Public\sstest\` (via `utm.sh ps`), push `ss.exe` and
   `scripts/windows/e2e-file-links.ps1` into it.
2. Run the runbook script once per token:
   ```sh
   scripts/windows/utm.sh task sstest-full  'C:\Users\Public\sstest\e2e-file-links.ps1' -- \
     -Exe C:\Users\Public\sstest\ss.exe -Root C:\Users\Public\sstest\run-full -Out C:\Users\Public\sstest\out-full.txt -Extended
   scripts/windows/utm.sh task sstest-basic 'C:\Users\Public\sstest\e2e-file-links.ps1' --basic -- \
     -Exe C:\Users\Public\sstest\ss.exe -Root C:\Users\Public\sstest\run-basic -Out C:\Users\Public\sstest\out-basic.txt -Extended
   ```
3. Poll `utm.sh pull 'C:\Users\Public\sstest\out-full.txt'` until the last line is `DONE`
   (`pull` exits 0 even when the file is missing).
4. For scenarios the script does not cover, write a small `.ps1`, push it, and run it with
   `utm.sh task`. Check reparse tags with `fsutil reparsepoint query` (`0xa0000003` junction,
   `0xa000000c` symlink) and read the file back.
5. `utm.sh clean`, then report per token: pass/fail, commit, arch, exact failing output.

## 3b. Hands-on test for the maintainer (`manual`)

```sh
scripts/windows/utm.sh push-manual
```

Give the user exactly one line to run in a **normal (non-admin) PowerShell** on the guest. A normal
shell tests the copy fallback that users without Developer Mode get; an admin shell can create
symlinks:

```powershell
powershell -ExecutionPolicy Bypass -File C:\Users\Public\ss-setup.ps1
```

It works in an isolated home, `C:\Users\Public\sstest\manual` (it overrides `USERPROFILE`, `HOME`,
`APPDATA`, `LOCALAPPDATA`), so the real profile is never touched. It installs `ss.exe` and the UI,
creates sample `.claude\CLAUDE.md` and `.codex\AGENTS.md` there, runs `init`, and opens the
dashboard. Tell the user which files to inspect under that folder, then list 4–6 things to try for
the change under test, each with what they should see. Cleanup removes only that folder:

```powershell
powershell -ExecutionPolicy Bypass -File C:\Users\Public\ss-setup.ps1 -Clean
```

Keep the instructions short. Do not paste multi-line setup blocks for the user to type.

## On a Windows host (no UTM)

The same scripts run natively; only the transport changes.

1. Build with the devcontainer (Docker Desktop) as in step 2, or run the `docker exec` part of
   `utm.sh build` directly, then copy `ss.exe`, `ss-ui-dist.zip` and `ss-version.txt` into one folder.
2. Hands-on: `powershell -ExecutionPolicy Bypass -File scripts\windows\manual-setup.ps1 -Dir <that folder>`.
   It stays isolated under `-Root`, so it is safe on a real profile.
3. Automated: run `scripts\windows\e2e-file-links.ps1` directly (it isolates under `-Root` too). For the
   basic-user token, launch it through `runas /trustlevel:0x20000 "powershell ..."` from a normal shell.
4. A developer machine often has Developer Mode on, which lets even the basic token create
   symlinks. Check `whoami /priv` and state it in the report; the no-symlink fallback needs it off.

## Gotchas

- Call `~/Applications/UTM.app/Contents/MacOS/utmctl` directly; the Homebrew symlink reports
  "Application not found". `utm.sh` does this.
- zsh `echo` eats backslashes in Windows paths; write guest scripts with a quoted heredoc.
- Under x64 emulation on ARM64, `$env:PROCESSOR_ARCHITECTURE` and .NET both say x64. `probe`
  reads the native value from the registry.
- A PowerShell 5 script without a BOM is read as the system code page; keep `.ps1` files ASCII.

© runkids · MIT · runkids/skillshare

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

Все скиллы по теме «Тесты и QA» →
windows-desktop-e2e affaan-m Скилл windows-desktop-e2e для Claude Code помогает писать и отлаживать E2E-тесты нативных Windows-приложений через pywinauto и Windows UI Automation, включая WPF, WinForms, Win32 и Qt. CX Codex +1 6 400установок testing-windows-desktop raylee-ai Скилл testing-windows-desktop для Claude Code запускает E2E-тестирование десктопного приложения pi-gui на Windows. Проверяет запуск сервера, выбор папок и встроенный терминал. CX Codex +1 ★ 364звёзд репо utm-parameter-generator OneWave-AI Скилл utm-parameter-generator для Claude Code создаёт UTM-параметры кампаний и поддерживает единый стиль меток. Запускается по запросу на трекинговую ссылку или отчёт по UTM. CX Codex +1 338установок utm-link-generator OneWave-AI Скилл utm-link-generator генерирует UTM-ссылки с едиными правилами именования, следит за дубликатами и создаёт варианты для LinkedIn, email, соцсетей и рекламы. CX Codex +1 249установок utm-builder manojbajaj95 Скилл utm-builder генерирует размеченные UTM-ссылки по единым правилам нейминга для Google Analytics и HubSpot. Пригодится при запуске рекламы, рассылок и A/B-тестов. CX Codex +1 228установок windows-git-bash-testing JosiahSiegel Скилл windows-git-bash-testing разбирает падения тестов Vitest, Playwright и MSW, которые случаются только на Windows и в Git Bash: пути, снимки, браузеры. CX Codex +1 164установок

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

Весь набор →
skillshare-update-docs Скилл skillshare-update-docs синхронизирует документацию проекта skillshare с кодом на Go и сверяет флаги CLI с исходниками. Пригодится после добавления новых команд или опций. CX Codex +1 ★ 3 269звёзд репо skillshare-code-review Скилл skillshare-code-review для Claude Code проверяет изменения в skillshare до создания PR или в открытом pull request. Запускается по просьбе разобрать diff, ветку, диапазон коммитов или PR. CX Codex +1 ★ 3 269звёзд репо skillshare-changelog Скилл skillshare-changelog собирает запись в CHANGELOG.md из коммитов в conventional-формате и переносит её на страницу changelog сайта. CX Codex +1 ★ 3 269звёзд репо skillshare-implement-feature Скилл skillshare-implement-feature ведёт реализацию Go-фичи от спецификации до проверок по TDD. Подходит для новых CLI-команд, флагов и внутренних пакетов. CX Codex +1 ★ 3 269звёзд репо skillshare-devcontainer Скилл skillshare-devcontainer гоняет команды ss, Go-тесты и веб-интерфейс skillshare внутри devcontainer, чтобы на macOS не получить тихо неверный результат. CX Codex +1 ★ 3 269звёзд репо skillshare-release Скилл skillshare-release помогает готовить и проверять релизы skillshare: сверяет PR от Release Please, обновляет документацию и инспектирует черновики. CX Codex +1 ★ 3 269звёзд репо skillshare Управляет ресурсами Skillshare CLI: синхронизирует скиллы и настройки между инструментами, проверяет конфигурацию и работает с общей памятью. CX Codex +1 ★ 3 269звёзд репо skillshare-ui-website-style Скилл skillshare-ui-website-style для Claude Code держит дизайн-систему Skillshare в React-дашборде и сайте на Docusaurus. Покрывает правку стилей и добавление компонентов без расхождения с токенами. CX Codex +1 ★ 3 269звёзд репо

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

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