Documentação

MCP Fusion/Operate and integrate/Skills

Skills

Pergunte à IA sobre a Vinkius

SKILL.md é um contrato de arquitetura executável que seu agente de codificação com IA segue: você é o arquiteto, o agente escreve código MVA e o @mcpfusion/skills distribui as instruções progressivamente.

O MCP Fusion traz um contrato de arquitetura legível por máquinas chamado SKILL.md. Ele diz aos agentes de codificação com IA como é o código MCP Fusion correto: toda ferramenta precisa de um Presenter com .returns(), campos sensíveis precisam de .redactPII(), ferramentas vêm de f.query, f.mutation e f.action. Você é o arquiteto. A IA escreve o código, e o contrato mantém tudo dentro do padrão.

O que o scaffold faz

O npx @mcpfusion/core create escreve o SKILL.md no seu projeto e o injeta nos arquivos de regras que seus agentes já leem:

  • .cursorrules para Cursor
  • .windsurfrules para Windsurf
  • .clinerules para Cline

A partir daí, pedir ao seu agente "uma ferramenta que lista faturas não pagas" produz código MVA: um builder, um Presenter, redação quando necessário, nada de JSON.stringify cru. O contrato é explícito sobre a falha: qualquer ferramenta sem um Presenter com .returns() é saída errada, e o agente se corrige.

Peça ao seu agente para ler o contrato antes de escrever qualquer coisa: é um único arquivo, e ele codifica cada convenção desta seção da documentação. Atualize-o conforme as convenções da sua equipe evoluem.

Divulgação progressiva com @mcpfusion/skills

Enfiar uma arquitetura inteira em um prompt de sistema desperdiça contexto e enterra as regras que importam para a tarefa em mãos. O @mcpfusion/skills distribui as instruções em três camadas:

  1. A camada de contrato. Um resumo curto, sempre carregado, das regras MVA.
  2. A camada de receitas. Instruções por tarefa, carregadas quando a tarefa corresponde: adicionar uma ferramenta, compor Presenters, escrever testes.
  3. A camada de referência. A superfície completa da API, carregada sob demanda.

O agente carrega a camada dois só quando toca naquela tarefa, e a camada três só quando precisa de uma assinatura exata. Sessões longas de codificação guardam o orçamento de contexto para o próprio código.

bash
npm install @mcpfusion/skills

O que o contrato impõe

RegraPor que existe
Toda ferramenta anexa um Presenter com .returns()A camada de percepção é o firewall de saída
Campos sensíveis passam por .redactPII()PII nunca chega ao modelo
Ferramentas vêm de f.query, f.mutation, f.actionAs anotações MCP continuam verdadeiras
Nada de respostas JSON.stringify cruasDado que ninguém moldou é dado que ninguém revisou
Handlers retornam Result para falhas esperadasErros com que o agente pode agir

Próximos passos