Skills

Swift Concurrency Skill: Zuerst die Nebenläufigkeit im Projekt analysieren, dann über eine Swift-6-Migration sprechen

Für alle, die ein Agent-Skills-Coding-Tool Swift-Nebenläufigkeit, Leistung oder eine Swift-6+-Migration prüfen lassen wollen. Der erste Durchlauf ist nur Analyse; das Nebenläufigkeitsmodell noch nicht ändern.

Official source · Swift Concurrency Agent Skill

Install

npx skills add https://github.com/avdlee/swift-concurrency-agent-skill --skill swift-concurrency

Für wen

Wenn du ein Swift-Projekt pflegst und ein Coding-Assistent sich aus einem Experten-Skill zu sicherer Nebenläufigkeit, Leistung und einer Swift-6+-Migration äußern soll, statt alte Thread-APIs aus dem Gedächtnis zu mischen, passt dieses Skill besser. Es richtet sich an jedes KI-Coding-Werkzeug, das das offene Agent-Skills-Format unterstützt. Die Formatnotizen stehen unter

https://agentskills.io/home

Du brauchst schon ein analysierbares Swift-Projekt und musst akzeptieren, das Skill swift-concurrency mit einem npx-Befehl hinzuzufügen. Wer nur WWDC-Notizen lesen und den Assistenten das Repository nicht lesen lassen will, hat wenig Nutzen. Die Seite nennt einige Produkte mit Client-Namensliste und schreibt zugleich „jedes Werkzeug, das dieses Format unterstützt“. Nimm die Beispiele nicht als geschlossene Namensliste.

Erster Versuch in 3 Minuten

Die offizielle Installation ist diese eine Zeile:

npx skills add https://github.com/avdlee/swift-concurrency-agent-skill --skill swift-concurrency

Es schreibt das Skill in die aktuelle Agent-Umgebung. Bestätige, dass npx lokal da ist und dies die Umgebung des Swift-Projekts ist, das du analysieren willst, dann führe aus. Stelle keinen zweiten Installer daneben.

Nach der Installation die offizielle Vorlage als Nur-Lesen-Analyse nutzen, noch nicht migrieren:

Use the swift concurrency skill and analyze the current project for Swift Concurrency improvements

Das Erfolgssignal folgt dem How to verify der Seite: Der Assistent soll das triage/playbook in skills/swift-concurrency/SKILL.md zitieren und in die reference file springen, die zu deinem error or task passt. Gibt er nur generische async-Tipps und erwähnt dieses playbook nicht, halte an und lass die Skill-Datei öffnen. In der Analysephase keine Änderungen an actor, Isolation oder ein Anheben auf Swift 6 erlauben.

Anwendungsfälle

Fall 1: Das aktuelle Projekt auf Verbesserungen der Nebenläufigkeit prüfen. Nutze die offizielle Vorlage aus dem vorigen Abschnitt. Die Aufgabe ist Analyse, kein Codeändern. Der verfügbare Seitentext sagt nicht, welche Verzeichnisse gescannt werden, und nicht das Berichtsformat. Bestätigen kannst du: Es erklärt, das swift-concurrency-Skill genutzt zu haben, und landet im triage-playbook in SKILL.md. Ist der Rat schon „ich ändere diese Dateien für dich“, zuerst eine Dateimenge verlangen, dann entscheiden.

Fall 2: Eine Referenzseite zu einem konkreten Fehler oder einer Migrationsaufgabe nachschlagen. Der Prüfschritt sagt: zu deinem error or task in die passende reference file springen. Hast du schon eine Compiler-Diagnose zur Nebenläufigkeit oder willst klar eine Swift-6+-Migration, lass den Assistenten zuerst das playbook öffnen, dann die passende Referenz, statt sofort den Sprachmodus zu ändern. Leistungsarbeit steht auch als Fähigkeit da, aber ohne Leistungs-Sonden-Befehl. Eine Leistungsaufgabe beginnt ebenfalls mit der Referenzdatei; fehlt der Befehl, erfinde kein Benchmark-Skript.

Grenzen

Das ist ein Experten-Leit-Skill, kein automatischer Migrator. Sichere Nebenläufigkeit, Leistung und Swift-6+-Migration sind im Rahmen, aber der erste Halt soll Analyse und Zitat sein. Das Repository ist auch als tragbares Agent Plugin (spec 1.0.0) geschrieben; kompatible Clients finden das Skill über das Wurzel-plugin.json und skills/. Das ist Verpackung, kein zweiter Installationsbefehl. Installiert wird weiter nur das npx skills add oben.

Die Plugin-Spezifikation steht unter

https://agent-plugins.org/

Nimm das nicht als Grund für eine ungeschriebene Store-Installation. Eine vollständige Namensliste der Referenzdateien steht nicht im verfügbaren Seitentext; du kannst aus diesem Material keine bestimmte reference nennen.

Der erste Halt ist Analyse. Jede Änderung an Swift-Nebenläufigkeitscode, jede Sprachmodus-Änderung oder jedes Massen-Hinzufügen von @MainActor muss zuerst die zu ändernden Dateien und die zugrunde liegende Referenzseite nennen; du bestätigst, dann geht es weiter.