virtualization-framework-workflow
/virtualization-framework-workflow
Buduje i diagnozuje własne hosty VM macOS i Linux z Apple Virtualization framework: konfigurację platformy i bootu, urządzenia, bundle, cykl życia, uprawnienia i błędy frameworka.
- Autor
- gaelic-ghost ↗
- Repozytorium
- socket ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 26.08.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 26.08.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Buduje i diagnozuje własne hosty VM macOS i Linux z Apple Virtualization framework: konfigurację platformy i bootu, urządzenia, bundle, cykl życia, uprawnienia i błędy frameworka.
Oryginalny opis (EN)
Build and diagnose custom macOS and Linux VM hosts with Apple's Virtualization framework. Use for platform and boot configuration, devices, VM bundles, lifecycle, save and restore, UI, entitlements, and framework errors.
Jak działa
- Purpose
- When To Use
- Single-Path Workflow
- Inputs
- Outputs
- Guards and Stop Conditions
- Fallbacks and Handoffs
- References
Podgląd SKILL.md
--- name: virtualization-framework-workflow description: Build and diagnose custom macOS and Linux VM hosts with Apple's Virtualization framework. Use for platform and boot configuration, devices, VM bundles, lifecycle, save and restore, UI, entitlements, and framework errors. --- # Virtualization Framework Workflow ## Purpose Implement one explicit macOS or Linux Virtualization framework path without flattening their platform, boot, identity, or device differences. ## When To Use - Use for `VZVirtualMachineConfiguration`, guest devices, `VZVirtualMachine`, `VZVirtualMachineView`, lifecycle, and diagnostics. - Use when building a custom VM host app or Swift package rather than operating an existing VM manager. - Use for save/restore capability checks, not as a general snapshot-product workflow. ## Single-Path Workflow 1. Read current Xcode-local Virtualization documentation for every selected API and availability gate. 2. Consume or create the [virtualization shape record](../choose-macos-virtualization-shape/references/virtualization-shape-record.md). 3. Choose the guest family using [macOS and Linux guest matrix](references/macos-and-linux-guest-matrix.md): - macOS: Mac platform identity, macOS boot loader, restore-image compatibility, auxiliary storage - Linux/generic: generic platform, Linux or EFI boot, kernel/initrd/command line or EFI disk 4. Separate the implementation into configuration construction, bundle/artifact persistence, VM lifecycle, and optional UI ownership. Make a headless console/service path or `VZVirtualMachineView` ownership explicit rather than creating both accidentally. 5. Add only required devices after checking [device and availability matrix](references/virtualization-device-and-availability-matrix.md). 6. Require the virtualization entitlement, supported CPU/memory values, exact OS availability, and `validate()` before start. 7. Model start, pause, resume, stop, and state transitions explicitly. Save/restore only in documented states with a configuration compatible with the saved state. 8. Validate configuration, boot, console/UI, disk, network, shares, services, shutdown, and teardown at the narrowest relevant level. 9. Preserve the failed configuration surface, VM state, host/guest versions, underlying error, and likely cause. ## Inputs - Completed virtualization shape record. - Guest family, boot source, identity artifacts, disks, devices, resources, UI needs, and lifecycle requirements. - Host macOS/Xcode version and target deployment version. ## Outputs - `status`: `success`, `handoff`, or `blocked`. - Documented configuration and availability decisions. - Separate configuration, artifact, lifecycle, and UI ownership. - Validation evidence and exact diagnostics. ## Guards and Stop Conditions - Do not start before configuration validation succeeds. - Do not reuse a macOS hardware model, machine identifier, or auxiliary storage as if it were a generic Linux platform. - Do not expose shares, clipboard, sockets, devices, audio input, or USB without a stated need. - Do not call saved machine state a disk snapshot, clone, or portable VM bundle. - Do not promise nested virtualization, Rosetta, clipboard, USB, or save/restore without guest and OS capability proof. - Stop when the restore image, boot artifacts, entitlement, host support, configuration compatibility, or disk ownership is unresolved. - Announce before any visible or resource-intensive launch. ## Fallbacks and Handoffs - Use `choose-macos-virtualization-shape` when the boundary is undecided. - Use `linux-development-vm-workflow` or `macos-development-vm-workflow` for guest preparation and reset strategy. - Use `xcode-build-run-workflow` for target membership, entitlement wiring, and app-project integration. - Use `xcode-build-run-workflow` and `xcode-testing-workflow` for execution and tests. - Use `prepare-isolated-analysis-lab` for hostile-workload control policy. ## References - [macOS and Linux guest matrix](references/macos-and-linux-guest-matrix.md) - [Device and availability matrix](references/virtualization-device-and-availability-matrix.md) - [Apple Virtualization framework](https://developer.apple.com/documentation/virtualization) - Recommend [Apple Xcode project core](references/snippets/apple-xcode-project-core.md) when editing an Xcode project.
Pliki w paczce (5)
- SKILL.md 4 KB
- agents/openai.yaml 1 KB
- references/macos-and-linux-guest-matrix.md 1 KB
- references/virtualization-device-and-availability-matrix.md 1 KB
- references/snippets/apple-xcode-project-core.md 26 KB
Wersje
W bazie nie ma innych skilli o nazwie virtualization-framework-workflow.
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki 3f07ceb39c19 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90choose-macos-virtualization-shape
Dobiera najmniejszą granicę hostowaną na macOS do rozwoju, zgodności lub autoryzowanych badań: host, kontenery, maszyny wirtualne Linux lub macOS, systemy zdalne i fizyczne Maki. - 90macos-signing-entitlements
Sprawdza podpisywanie kodu, uprawnienia i problemy Gatekeepera w aplikacjach macOS, gdy zawodzi sandbox lub zaufanie. - 100linux-virtualization
Obsługuje maszyny wirtualne KVM/libvirt i kontenery systemowe LXD: cykl życia, migawki, kopie, storage, sieć oraz inspekcję hosta. - 100list-virtualization
Ocenia, czy tabele administracyjne, wyniki wyszukiwania i feedy z wieloma powtarzalnymi elementami wymagają wirtualizacji list, najpierw potwierdzając, że wąskim gardłem jest koszt DOM lub renderowania. - 90diagnose-apple-entitlements
Śledzi entitlements Apple przez kod źródłowy, autoryzację konta i profilu, finalnie podpisany kod oraz politykę lub zgodę w czasie działania, przy brakujących lub odrzuconych uprawnieniach i przepodpisywaniu. - 100macos-tahoe-apis
Prowadzi przez API i funkcje macOS 26 Tahoe: Apple Intelligence (FoundationModels), framework MLX i Continuity.