Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

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.

Repozytorium
socket ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
26.08.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.08.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. Purpose
  2. When To Use
  3. Single-Path Workflow
  4. Inputs
  5. Outputs
  6. Guards and Stop Conditions
  7. Fallbacks and Handoffs
  8. References
Sekcje z nagłówków SKILL.md, w oryginale · 65 linii, 484 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.