Skills

Swift Concurrency Skill: primero analiza la concurrencia del proyecto y luego habla de una migración a Swift 6

Para quien quiere que una herramienta de código Agent Skills revise la seguridad de concurrencia Swift, el rendimiento o una migración Swift 6+. El primer paso debe ser solo análisis; aún no cambies el modelo de concurrencia.

Official source · Swift Concurrency Agent Skill

Install

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

Para quién es

Si mantienes un proyecto Swift y quieres que un asistente de código hable de concurrencia segura, rendimiento y una migración Swift 6+ a partir de una skill experta, en vez de mezclar APIs de hilos viejas de memoria, esta skill encaja mejor. Apunta a cualquier herramienta de código IA que admita el formato abierto Agent Skills. Las notas de formato están en

https://agentskills.io/home

Ya necesitas un proyecto Swift analizable y aceptar añadir la skill swift-concurrency con un comando npx. Si solo quieres leer notas de WWDC y no piensas dejar que el asistente lea el repositorio, el beneficio es limitado. La página cita varios productos con un censo de clientes y también escribe «cualquier herramienta que admita este formato», así que no tomes los ejemplos por un censo cerrado.

Primer intento en 3 minutos

La instalación oficial es esta línea:

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

Escribe la skill en el entorno Agent actual. Confirma que tienes npx en local y que este es el entorno del proyecto Swift que quieres analizar, luego ejecuta. No pongas otro instalador al lado.

Tras instalar, usa el ejemplo oficial como análisis de solo lectura; aún no migres:

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

La señal de éxito sigue el How to verify de la página: el asistente debe citar el triage/playbook en skills/swift-concurrency/SKILL.md y entrar en el reference file que coincida con tu error or task. Si solo da consejos async genéricos y no menciona este playbook, páralo y haz que abra el archivo de la skill. En la fase de análisis no dejes que cambie actor, el aislamiento ni suba a Swift 6.

Casos de uso

Caso 1: Revisar mejoras de concurrencia del proyecto actual. Usa la consigna oficial de la sección anterior. La tarea es analizar, no cambiar código. El texto de página disponible no dice qué directorios recorre ni el formato del informe. Puedes confirmar que declara haber usado la skill swift concurrency y que llega al playbook de reparto en SKILL.md. Si el consejo ya es «voy a cambiar estos archivos por ti», pide primero el conjunto de archivos y luego decide.

Caso 2: Consultar una página de referencia ante un error o una tarea de migración concreta. El paso de verificación dice: para tu error or task, entrar en el reference file correspondiente. Cuando ya tienes un diagnóstico de concurrencia del compilador, o quieres con claridad una migración Swift 6+, haz que abra primero el playbook y luego la referencia correspondiente, en vez de cambiar el modo de lenguaje de inmediato. La optimización de rendimiento también figura como capacidad, pero no hay comando de sonda. Una tarea de rendimiento también empieza por el archivo de referencia; si falta el comando, no inventes un script de referencia de rendimiento.

Límites de uso

Esto es una skill de guía experta, no un migrador automático. Concurrencia segura, rendimiento y migración Swift 6+ están en el alcance, pero la primera parada debe ser análisis y cita. El repositorio también está escrito como Agent Plugin portable (spec 1.0.0); los clientes compatibles descubren la skill desde el plugin.json raíz y skills/. Eso es empaquetado, no un segundo comando de instalación. La instalación sigue usando solo el npx skills add de arriba.

La especificación del plugin está en

https://agent-plugins.org/

No lo tomes como motivo para una instalación de tienda no escrita. Un censo completo de archivos de referencia no aparece en el texto de página disponible; no puedes nombrar una reference concreta a partir de este material.

La primera parada es el análisis. Cualquier cambio de código de concurrencia Swift, cambio de modo de lenguaje o añadido masivo de @MainActor debe primero nombrar los archivos que cambiará y la página de referencia; tú confirmas y luego sigue.