Swift Concurrency Skill: primeiro analise a concorrência do projeto e só então fale de uma migração Swift 6

Para quem é

Se você mantém um projeto Swift e quer que um assistente de código fale de concorrência segura, desempenho e uma migração Swift 6+ a partir de uma skill especialista, em vez de misturar APIs de thread antigas de memória, esta skill cabe melhor. Mira qualquer ferramenta de código de IA que suporte o formato aberto Agent Skills. As notas de formato estão em

https://agentskills.io/home

Você já precisa de um projeto Swift analisável e de aceitar acrescentar a skill swift-concurrency com um comando npx. Se só quer ler notas da WWDC e não pretende deixar o assistente ler o repositório, o ganho é limitado. A página cita vários produtos com um rol de clientes e também escreve «qualquer ferramenta que suporte este formato», então não trate os exemplos como um rol fechado.

Primeira tentativa em 3 minutos

A instalação oficial é esta linha:

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

Ela grava a skill no ambiente Agent atual. Confirme que tem npx no local e que este é o ambiente do projeto Swift que quer analisar, depois execute. Não coloque outro instalador ao lado.

Depois de instalar, use o exemplo oficial como análise somente leitura; ainda não migre:

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

O sinal de sucesso segue o How to verify da página: o assistente deve citar o triage/playbook em skills/swift-concurrency/SKILL.md e entrar no reference file que corresponde ao seu error or task. Se só der conselhos async genéricos e não mencionar este playbook, pare e faça-o abrir o arquivo da skill. Na fase de análise não deixe mudar actor, isolamento nem subir para Swift 6.

Casos de uso

Caso 1: Verificar melhorias de concorrência do projeto atual. Use o prompt oficial da seção anterior. A tarefa é analisar, não alterar código. O texto de página disponível não diz quais diretórios percorre nem o formato do relatório. Você pode confirmar que declara ter usado a skill swift concurrency e que chega ao playbook de triagem em SKILL.md. Se o conselho já for «vou alterar estes arquivos para você», peça primeiro o conjunto de arquivos e então decida.

Caso 2: Consultar uma página de referência diante de um erro ou tarefa de migração concreta. O passo de verificação diz: para o seu error or task, entrar no reference file correspondente. Quando você já tem um diagnóstico de concorrência do compilador, ou quer com clareza uma migração Swift 6+, faça o assistente abrir primeiro o playbook e depois a referência correspondente, em vez de mudar o modo de linguagem na hora. Otimização de desempenho também aparece como capacidade, mas não há comando de sonda. Uma tarefa de desempenho também começa pelo arquivo de referência; se o comando falta, não invente um script de benchmark.

Limites de uso

Isto é uma skill de orientação especialista, não um migrador automático. Concorrência segura, desempenho e migração Swift 6+ estão no âmbito, mas a primeira parada deve ser análise e citação. O repositório também está escrito como Agent Plugin portátil (spec 1.0.0); clientes compatíveis descobrem a skill a partir do plugin.json na raiz e de skills/. Isso é empacotamento, não um segundo comando de instalação. A instalação continua usando só o npx skills add acima.

A especificação do plugin está em

https://agent-plugins.org/

Não use isso como motivo para uma instalação de loja não escrita. Um inventário completo dos arquivos de referência não aparece no texto de página disponível; você não pode nomear uma reference específica a partir deste material.

A primeira parada é a análise. Qualquer alteração de código de concorrência Swift, mudança de modo de linguagem ou acréscimo em massa de @MainActor deve primeiro nomear os arquivos que vai alterar e a página de referência; você confirma e só então continua.