Skills

Module Federation agora expõe uma skill mf unificada.

Você não precisa escolher uma lista longa de skills separadas nem ler a documentação primeiro para depois repassá-la ao agente. A abordagem mais simples é instalar esta única skill e deixar o agente decidir se deve ler documentação, inspecionar configuração ou solucionar um problema.

Quando o problema existe apenas no runtime da página, a skill usa a extensão MF do Divebell para obter evidências estruturadas de Remote, Shared, Bridge e performance dos módulos. O navegador é apenas a entrada e o gatilho do carregamento. Divebell é instalado na máquina do agente, não na aplicação.

Se ainda não leu, comece pelo início rápido com AI.

Instalação

npx skills add module-federation/agent-skills --skill mf -y

Depois disso, a entrada principal é:

/mf <sub-command or question>

Se você não puder usar a CLI, também pode copiar manualmente o diretório do GitHub:

https://github.com/module-federation/agent-skills/tree/main/skills/mf

Como usar

mf tem um único ponto de entrada, mas contém várias capacidades. Você pode informar um subcomando explícito ou simplesmente pedir em linguagem natural.

Com subcomandos explícitos:

/mf docs How do I use Module Federation in Modern.js?
/mf integrate
/mf type-check
/mf runtime-error RUNTIME-008
/mf observability

Com linguagem natural:

/mf What's the difference between singleton and requiredVersion in shared?
/mf Help me figure out why this project is not pulling remote types
/mf Add Module Federation to the current project
/mf I saw a Module Federation console error with traceId mf-...

O que mf oferece

SubcomandoUse para
docsLer a documentação mais recente antes de responder perguntas sobre configuração, APIs e conceitos
contextInspecionar a configuração de MF do projeto atual
module-infoInspecionar URLs de módulos remotos, módulos expostos e metadados relacionados
integrateAdicionar Module Federation a um projeto existente
type-checkSolucionar problemas relacionados a tipos
shared-depsSolucionar conflitos de dependências compartilhadas e bundling duplicado
perfSolucionar lentidão no desenvolvimento local e no HMR
config-checkSolucionar erros de configuração, arquivos ausentes e incompatibilidades de plugin
bridge-checkSolucionar problemas de integração com Bridge
runtime-errorSolucionar códigos explícitos de erro em runtime, especialmente RUNTIME-001 e RUNTIME-008
observabilityDiagnosticar falhas de runtime, cadeias de carregamento e gargalos de performance com Divebell, ou ler relatórios

Fluxos de trabalho mais comuns

1. Leia a documentação antes de responder

Esse é o caso de uso mais comum e o melhor lugar para começar:

/mf docs What's the difference between singleton and requiredVersion in shared?

Isso faz o agente ler a documentação mais recente primeiro, em vez de tentar adivinhar com base em memória desatualizada.

2. Deixe o agente integrar por você

Se quiser adicionar Module Federation a um projeto existente:

/mf integrate

O agente vai inspecionar seu projeto atual e decidir o que fazer em seguida.

3. Deixe o agente depurar diretamente

Se você já tem um problema concreto:

/mf type-check
/mf shared-deps
/mf config-check
/mf runtime-error RUNTIME-008
/mf observability

Nesse ponto, o objetivo não é você investigar manualmente primeiro. O objetivo é deixar o agente começar o diagnóstico imediatamente.

4. Deixe o agente depurar uma página MF real

Para uma investigação pontual, forneça a URL e o fluxo à skill:

/mf observability
Open https://example.com with Divebell, reproduce the failing checkout flow,
and inspect the Remote and Shared loading chain.

A skill descobre as Skills instaladas da CLI e da extensão MF, abre a página com divebell open <url> --mf e escolhe o menor comando divebell mf relevante. Interações servem apenas para acionar o lazy load; as conclusões devem usar evidências estruturadas de Remote, Shared, Bridge ou performance.

Consulte Solucionar problemas de runtime para instalação, comandos, proxy de Remote e limites das evidências.

5. Deixe o agente ler observabilidade retida

Instale o Observability Plugin na aplicação quando os relatórios precisarem de coleta contínua, upload em produção ou gravação por Node/SSR. Quando o console imprimir uma traceId e um comando read:, forneça à skill uma fonte de relatório ainda acessível:

/mf observability
I saw this Module Federation console error:

[Module Federation] Observability report generated
traceId: mf-...
read: window.__FEDERATION__.__OBSERVABILITY__["runtime_host"].getReport("mf-...")

Please read the report and fix the issue.

Para Node, SSR ou uploads de produção:

/mf observability
Read .mf/observability/latest.json and explain the likely owner and fix.

A única coisa que você realmente precisa lembrar

Você não precisa ler a documentação primeiro e depois dizer ao agente o que fazer.

Instale mf; depois deixe o agente ler, inspecionar, decidir e agir.