swift-concurrency

Descripción general del skill swift-concurrency

Qué hace este skill

El skill swift-concurrency te ayuda a razonar sobre problemas de Swift Concurrency con menos suposiciones: refactors de async/await, aislamiento de actores, Sendable, estructura de tareas, advertencias de concurrencia estricta y problemas de migración a Swift 6. Es una buena opción cuando necesitas ayuda práctica de revisión, no solo definiciones.

Para quién es más adecuado

Usa el skill swift-concurrency cuando estés:

• migrando código a Swift 6 o a comprobaciones más estrictas del compilador
• corrigiendo data races, errores de aislamiento de actor o advertencias de Sendable
• sustituyendo callbacks por async/await
• decidiendo entre @MainActor, actores personalizados, nonisolated o grupos de tareas
• verificando si el código es seguro para concurrencia antes de publicar

Qué lo hace diferente

Este skill swift-concurrency está orientado a la toma de decisiones. Da prioridad al límite de aislamiento, a la concurrencia estructurada y a los ajustes del compilador que cambian los diagnósticos. Eso importa porque el mismo código puede ser válido, generar ruido o estar roto según el modo del lenguaje y la cadena de herramientas.

Cuándo es una mala opción

Si solo necesitas repasar sintaxis rápidamente, quizá te baste con un prompt genérico. El skill swift-concurrency resulta más útil cuando la respuesta depende del contexto del proyecto, del comportamiento del compilador o de una ruta real de migración.

Cómo usar el skill swift-concurrency

Instálalo en el contexto correcto del repositorio

Usa el flujo swift-concurrency install para tu configuración de skills y aplícalo en el lugar donde estés editando código Swift. Un comando de instalación típico es:

npx skills add Joannis/claude-skills --skill swift-concurrency

Si tu entorno usa otro gestor de skills, mantén el mismo slug del skill y apunta al repositorio Joannis/claude-skills.

Dale la forma correcta a la entrada

Un buen uso de swift-concurrency empieza con un objetivo de código concreto, no con un tema vago. Incluye:

• el archivo o tipo que quieres cambiar
• el texto exacto del error o advertencia del compilador
• si el destino es Swift 5.x o Swift 6
• el límite de aislamiento relevante, si se conoce
• si interviene código de interfaz, código de servidor o código de modelos compartidos

Buen prompt:

Refactoriza este código de red basado en callbacks a async/await, pero mantén las actualizaciones de UI en @MainActor solo donde haga falta. Estamos en Swift 6 y el compilador advierte sobre capturas de Sendable.

Mal prompt:

Ayuda con Swift concurrency.

Lee primero los archivos correctos

Para obtener resultados más rápidos y seguros, revisa primero SKILL.md y después las referencias más relevantes:

• references/glossary.md para la terminología
• references/async-await-basics.md para patrones de conversión
• references/actors.md para aislamiento y acceso a actores
• references/sendable.md para problemas de captura y transferencia
• references/performance.md para paralelismo y contención

Si estás trabajando en arquitectura de producción o pruebas, consulta también references/production-patterns.md y references/testing.md.

Flujo de trabajo que suele funcionar

1. Identifica la advertencia, el error o el objetivo exacto del refactor.
2. Determina el dominio de aislamiento: main actor, actor personalizado o nonisolated.
3. Decide si el cambio es de concurrencia estructurada, no solo de limpieza de sintaxis.
4. Pide primero la corrección más pequeña y segura.
5. Luego solicita una segunda pasada para rendimiento, testabilidad o limpieza para Swift 6.

Preguntas frecuentes sobre el skill swift-concurrency

¿Es solo un prompt mejorado para Swift Concurrency?

No. El skill swift-concurrency es una guía reutilizable con convenciones respaldadas por el repositorio para manejar aislamiento, Sendable y decisiones de migración. Es mejor que un prompt genérico cuando la respuesta depende del modo del compilador o de cómo están estructuradas las tareas y los actores.

¿Necesito saber ya async/await?

No. El skill también ayuda a principiantes, pero resulta más útil si puedes compartir el código y el error. Si solo conoces el comportamiento deseado, aporta un ejemplo mínimo y deja que el skill defina el modelo de concurrencia.

¿Funciona para Swift del lado del servidor y para apps?

Sí. Sirve para ambos, pero el consejo debería ser distinto. El código de UI suele necesitar @MainActor; el código de servidor o de librería normalmente requiere un aislamiento más estrecho y más cuidado con Sendable y la estructura de tareas.

¿Cuándo no debería usarlo?

No uses swift-concurrency para APIs asíncronas no relacionadas en otros lenguajes, ni cuando el problema sea puramente lógica de negocio sin ningún ángulo de actor, tarea o concurrencia del compilador. Tampoco es una buena opción si no puedes compartir suficiente contexto para identificar el límite de aislamiento.

Cómo mejorar el skill swift-concurrency

Aporta primero los datos del compilador

La mayor mejora de calidad llega cuando indicas al skill qué modo de lenguaje y qué cadena de herramientas estás usando. Swift 5.10, Swift 6 y los ajustes de concurrencia estricta pueden dar respuestas distintas. Incluye el texto exacto de la advertencia siempre que sea posible.

Muestra el límite, no solo el síntoma

El skill funciona mejor cuando explicas dónde vive el estado y quién lo toca. Por ejemplo:

• “Esta caché se comparte entre tareas de petición”
• “Este view model actualiza estado de UIKit”
• “Este parser debe seguir fuera del main actor”

Eso ayuda al skill swift-concurrency a decidir entre aislamiento de actor, nonisolated, @MainActor o agrupación de tareas.

Pide primero el cambio más pequeño y seguro

Una buena solicitud para swift-concurrency guide pide la corrección menos invasiva que compile sin problemas. Si luego necesitas ayuda más profunda, pide una segunda pasada sobre rendimiento, cancelación o arquitectura. Así evitas sobrerreaccionar con un @MainActor generalizado o con Task.detached innecesario.

Itera con la siguiente advertencia, no con una reescritura

Después de la primera respuesta, devuelve el siguiente diagnóstico del compilador o la siguiente preocupación en tiempo de ejecución. Los mejores flujos de trabajo de swift-concurrency for Code Editing son incrementales: corrige un problema de aislamiento, recompila y luego ajusta Sendable, la cancelación o la estructura de tareas a partir de la nueva salida.