SwiftUI macOS

Przegląd SwiftUI na poziomie runtime dla macOS: obserwacja, współbieżność, AppKit

Autor: kageroumado · kageroumado/swiftui-macos-skill

Testowano · Działa ★ 9.2/10

SwiftUI macOS — Przegląd SwiftUI na poziomie runtime dla macOS: obserwacja, współbieżność, AppKit

Co robi ten skill

Osiem plików referencyjnych na żądanie, które dostarczają Claude'owi wiedzy na poziomie runtime o SwiftUI na macOS — jak rejestrator obserwacji decyduje o powiadomieniu, jakie są koszty `_modify` w porównaniu do `set`, jak bramkowane są aktualizacje tożsamości widoku i `NSViewRepresentable`. Uruchamia się, gdy poprosisz o zbudowanie, przegląd lub debugowanie widoku SwiftUI na macOS, naprawienie problemów z obserwacją lub ponownym renderowaniem, mostkowanie AppKit lub architekturę własności stanu. Wyraźnie wyłączono z zakresu SwiftUI tylko dla iOS i podstawowe pytania dotyczące Swift.

Raport z testu

Przejrzano 79-liniowy plik macOS SwiftUI z zasianymi pułapkami obserwacji dwukrotnie — raz na zimno, raz z załadowanymi referencjami — a umiejętność znalazła pięć rzeczy, które zimne przejście pominęło. Najostrzejsze: ponieważ `Doc` jest strukturą wewnątrz obserwowanej tablicy, mutacja tytułu jednego wiersza wywołuje `_modify` na całej tablicy i ponownie renderuje całą `List`, czego zimny przegląd nigdy nie podejrzewał. Zastąpiła również słabe rozwiązanie lepszym, dostosowując `NSViewRepresentable` do `Equatable`, aby całkowicie zatrzymać wywoływanie `updateNSView`, zamiast chronić się wewnątrz niego. Jedna niespójność warta uwagi: referencja współbieżności mówi, aby preferować `DispatchQueue.main.async` nad `Task`, ale nie ma reguły dla bardziej powszechnego przypadku, gdy już jesteśmy na `MainActor` i nie potrzebujemy żadnego przeskoku. Fragment instalacyjny README działa dosłownie z pustego HOME, a każde twierdzenie w jego tabeli referencyjnej odpowiadało plikom na dysku.

Testowano: 2026-08-10 · Claude Code 2.x (agent harness)

Instalacja

git clone https://github.com/kageroumado/swiftui-macos-skill.git
mkdir -p ~/.claude/skills
cp -r swiftui-macos-skill/skills/swiftui-macos ~/.claude/skills/

Komendy i przykładowe prompty

/swiftui-macosPrzegląd SwiftUI na poziomie runtime dla macOS: obserwacja, współbieżność, AppKit

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

Review this SwiftUI macOS file for observation and identity bugs
Check this NSViewRepresentable code for update-gating issues
Debug why this macOS SwiftUI sidebar view re-renders too often

Pełny raport →