SwiftUI macOS

Revisione SwiftUI a livello di runtime per macOS: observation, concurrency, AppKit

di kageroumado · kageroumado/swiftui-macos-skill

Promosso ★ 9.2/10

SwiftUI macOS — Revisione SwiftUI a livello di runtime per macOS: observation, concurrency, AppKit

Cosa fa

Otto reference files on-demand che forniscono a Claude una conoscenza a livello di runtime di SwiftUI su macOS — come l'observation registrar decide di notify, cosa _modify costs rispetto a set, come view identity e NSViewRepresentable updates sono gated. Si attiva quando si chiede di build, review, o debug una macOS SwiftUI view, fix observation o re-render problems, bridge AppKit, o architect state ownership. Esplicitamente escluso da SwiftUI solo per iOS e domande Swift di base.

Rapporto di test

Ho revisionato un file macOS SwiftUI di 79 righe con seeded observation traps due volte — una volta a freddo, una volta con i references caricati — e la skill ha trovato cinque cose che il cold pass aveva perso. La più acuta: poiché Doc è una struct all'interno di un observed array, la mutazione del title di una riga attiva _modify sull'intero array e re-renders l'intera List, cosa che il cold review non aveva mai sospettato. Ha anche sostituito una weak fix con una migliore, conformando la NSViewRepresentable a Equatable per impedire che updateNSView si attivasse del tutto invece di fare guarding al suo interno. Una inconsistenza degna di nota: il concurrency reference ti dice di preferire DispatchQueue.main.async rispetto a Task, ma non ha una regola per il caso più comune di essere già su MainActor e non aver bisogno di alcun hop. Lo install snippet del README funziona verbatim da un bare HOME, e ogni affermazione nella sua reference table corrispondeva ai files on disk.

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

Installazione

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

Comandi e prompt di esempio

/swiftui-macosRevisione SwiftUI a livello di runtime per macOS: observation, concurrency, AppKit

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →