Verificar antes de publicar
MCP Abilities – Check Runner: uma verificação concluída nem sempre está aprovada
Zero erros também pode significar reprovação. O Check Runner liga o assistente de IA ao Plugin Check oficial do WordPress e considera os avisos motivo de reprovação. Use o resultado para decidir o que corrigir antes de publicar um plugin.
Um só aviso impede a aprovação
Imagine uma versão candidata sem erros detetados, mas com dois avisos. A verificação terminou, mas o Check Runner indica que não foi aprovada. Tanto o número de erros como o de avisos têm de ser zero.
O executor utiliza todas as verificações disponíveis no motor oficial, incluindo as experimentais. Os pedidos para reduzir a lista ou as categorias são ignorados. A versão instalada do Plugin Check determina quais as verificações disponíveis.
As ocorrências incluem ficheiro, linha, coluna, mensagem e código de diagnóstico quando o Plugin Check fornece esses dados. Use-os para localizar o problema, corrigir o código e voltar a verificar o plugin.
Um aviso amarelo também obriga a parar. Só zero erros e zero avisos permitem aprovar a verificação.
Uma referência de tarefa confirma a receção, não a aprovação
Para executar em segundo plano, indique async: true. O Check Runner devolve uma referência enquanto o WordPress agenda a verificação. Por predefinição, a chamada é síncrona.
Consulte a mesma tarefa com plugin-check/job-status. Pending significa que ainda não começou; running, que ainda não terminou. Uma tarefa complete pode conter um resultado aprovado, ocorrências que levam à reprovação ou um erro de execução.
A execução em segundo plano depende do cron do WordPress e dos recursos PHP permitidos pelo servidor. Uma referência não garante que a tarefa possa começar ou terminar. Investigue uma tarefa bloqueada ou interrompida antes de pedir outra.
O comprovativo acompanha uma tarefa. Leia o resultado guardado antes de avaliar o plugin.
Do candidato instalado a um resultado útil
1. Selecione o plugin exato
Instale o candidato num site WordPress de testes adequado, com o Plugin Check oficial ativo. Indique ao assistente o slug ou o nome base do ficheiro do plugin e escolha o modo de plugin novo ou atualização conforme a análise pretendida.
2. Execute a verificação completa
Peça a verificação completa e escolha a execução em segundo plano quando necessário. Guarde a referência e consulte o estado. Um agendamento bem-sucedido não é uma verificação aprovada.
3. Leia as contagens e as ocorrências em conjunto
Confirme primeiro se a execução terminou. Leia depois o estado de aprovação e as contagens de erros e avisos. Se a lista estiver truncada, não apresenta todas as ocorrências, embora as contagens cubram o resultado completo da verificação.
4. Corrija, volte a verificar e teste
Corrija os problemas indicados e execute uma nova verificação completa do plugin alterado. Teste também as funções e integrações reais. Um resultado limpo do Plugin Check não prova que o plugin funciona corretamente nem garante a aceitação pelo WordPress.org.
A resposta tem um limite de tamanho
Por predefinição, a resposta apresenta no máximo 100 ocorrências. max_results permite aumentar o limite para 500. Os erros aparecem antes dos avisos. Uma lista longa de erros pode, por isso, deixar os detalhes dos avisos fora da resposta.
Não existe paginação para consultar as restantes ocorrências. Se truncated for true, utilize a interface oficial do Plugin Check para examinar mais detalhes. Não apresente esta resposta como uma lista completa de ocorrências.
Duas ações com permissões diferentes
plugin-check/run inicia uma verificação e exige a permissão do WordPress para ativar plugins. plugin-check/job-status lê uma tarefa guardada e exige a permissão para gerir as opções do site.
Use uma conta autorizada para ambas as ações quando trabalhar com tarefas em segundo plano. O Check Runner não corrige ficheiros de código-fonte, não instala o candidato nem publica versões. Esta versão não tem uma ação para cancelar ou eliminar tarefas.
Prepare a ligação ao WordPress
O Check Runner declara WordPress 6.9 ou posterior e PHP 8.0 ou posterior como requisitos mínimos. O WordPress 6.9 inclui a Abilities API. Use uma versão de PHP com manutenção e suportada pelo site.
O plugin oficial Plugin Check tem de estar instalado e ativo. Ligue um cliente MCP autenticado através do WordPress MCP Adapter e confirme que as ações necessárias são detetadas.
Consoante a configuração MCP, pode ser necessária uma camada de exposição como MCP Expose Abilities para tornar a ação de execução detetável. Verifique a ligação antes de iniciar uma verificação.
Saiba o que a próxima verificação realmente demonstra
Instale o Check Runner, confirme que ambas as ações estão disponíveis e peça uma verificação completa do candidato instalado. Leia o resultado final e os seus limites antes de decidir publicar.