Skills e Rules

Ao conectar o MCP a um agente LLM, o agente passa a poder chamar a API do WEEGLOO diretamente. No entanto, poder chamar a API é diferente de usá-la com exatidão, da forma pretendida pelo WEEGLOO. Por exemplo, em que situação usar a CMA e em que situação usar a CDA, como projetar os campos de um Content Type ou quais permissões vincular a um Delivery Access Token para que seja seguro são coisas que não dá para saber apenas pelo método de chamada.

Skills e Rules são dois tipos de orientação que preenchem essa lacuna. As Skills são guias com o método para executar bem uma tarefa específica, e as Rules são as regras que devem ser seguidas ao longo de todo o trabalho. A ferramenta de instalação (npx weegloo@latest) pode instalar ambas junto com a conexão do MCP.

Diferença entre Skills e Rules

As duas são iguais no sentido de que são informações fornecidas ao agente, mas têm papéis diferentes.

Skills são guias que organizam, em etapas e padrões, como executar uma tarefa específica. Há uma para cada tarefa, e o agente lê e segue a Skill correspondente quando inicia essa tarefa. Por exemplo, há uma Skill para cada tarefa, como projetar um Content Type, escolher a arquitetura do serviço ou emitir um Delivery Access Token. Assim, o agente passa a seguir um método verificado em vez de adivinhar.

Rules são regras que devem ser sempre seguidas, independentemente do tipo de tarefa. Por exemplo, o endereço base da API do WEEGLOO, a forma de obter listas de recursos página a página ou o fato de que é preciso enviar a informação de versão ao modificar um recurso. O agente aplica essas regras como pano de fundo durante todo o trabalho.

Resumindo, as Skills são orientações por tarefa que dizem "esta tarefa se faz assim", e as Rules são regras comuns que dizem "qualquer que seja a tarefa, isto se cumpre".

Instalar

Skills e Rules são instaladas em conjunto pela ferramenta de instalação do MCP. Basta executar o seguinte no terminal.

npx weegloo@latest

Ao executar, ele pergunta em sequência o ambiente (agente) a conectar e o Personal Access Token e, junto com o servidor MCP, instala as Skills e Rules nesse ambiente. O processo de instalação e a configuração por ambiente são tratados em Conectar.

Ao usar @latest, a versão mais recente é sempre instalada. A forma de se manter atualizado depois de já ter instalado é tratada em Manter atualizado.

Manter atualizado

Skills e Rules não se resumem a instalar uma vez e pronto. Sempre que surge um recurso novo no WEEGLOO e a forma recomendada muda, essas orientações também são atualizadas. Já o que está instalado no seu computador é uma cópia do momento da instalação, e por isso permanece parado ali.

Quando a instalação fica desatualizada, acontecem duas coisas. As Skills e Rules recém-adicionadas simplesmente não existem na sua instalação, então o agente não sabe como lidar com esses recursos. E, se o conteúdo de um item que já existia mudou, o agente segue a orientação antiga do mesmo jeito. Em qualquer dos casos, o agente trabalha tomando como referência o WEEGLOO do momento da instalação, e não o WEEGLOO de agora. A qualidade do resultado que o agente entrega se decide aí, então convém manter as Skills e Rules atualizadas.

O que precisa ser mantido atualizado são as Skills e Rules instaladas no seu computador. O servidor MCP não tem nada a atualizar à parte.

Quando sai uma nova versão, o agente avisa. Ao iniciar um trabalho relacionado ao WEEGLOO, o agente verifica a versão instalada e, se estiver atualizada, não exibe nada. Só quando há algo a atualizar é que ele mostra um aviso como o seguinte, junto com o comando a executar.

Terminal
📦 A Weegloo update is available (installed a1688fbfc979 → latest 6df28e82525f). To update, run the command below.

Essa atualização não é executada automaticamente. Como é um trabalho que reescreve os arquivos instalados, ela só acontece depois da confirmação do usuário. Quando o aviso aparecer, convém não adiar e executar o comando ali mesmo. Basta executar no terminal, tal como está, o comando exibido no aviso.

Terminal
npx weegloo@latest --agent claude --location global --update

Nos lugares de --agent e --location entram o ambiente e o local escolhidos na instalação, então o comando varia conforme o estado da instalação. Se você usar exatamente o comando exibido no aviso, os valores corretos já estarão nele.

Em vez de digitar o comando você mesmo, também pode pedir ao agente: "atualize o weegloo". O agente já sabe qual comando executar, então você não precisa procurar qual comando usar.

O que uma atualização preserva e o que ela muda

A atualização não refaz a instalação do zero. Ela mantém as escolhas feitas na primeira instalação e apenas deixa o conteúdo na versão mais recente.

  • A seleção de Skills e Rules feita na instalação é mantida como está. Se você instalou apenas uma parte, ela permanece assim.
  • As Skills e Rules adicionadas desde a última instalação são instaladas automaticamente junto. Os itens que você excluiu de propósito na instalação continuam excluídos.
  • Os itens removidos do repositório também são removidos do seu computador.
  • A versão escolhida na instalação é mantida.
  • As configurações do servidor MCP não são alteradas. Por isso, a atualização não exige um Personal Access Token.

Se você apagou à mão um arquivo de Skill ou Rule instalado, a atualização instala esse arquivo de novo. Para remover um item, não apague o arquivo: execute de novo o comando de instalação e desmarque o item na tela de seleção.

O conteúdo atualizado passa a valer a partir de uma nova conversa. Como o agente lê as Skills e Rules ao iniciar a conversa, uma conversa em andamento continua usando o conteúdo anterior.

Consultar diretamente

Skills e Rules estão num repositório público. Para abrir diretamente o conteúdo instalado ou verificar qual orientação existe para cada tarefa, consulte o repositório.

Skills e Rules estão sob plugins/weegloo/ no repositório, respectivamente nos diretórios skills/ e rules/.

Mesmo ao fazer a integração diretamente, sem usar a ferramenta de instalação, basta pegar os arquivos do caminho latest acima e usá-los como estão.

Próximos passos

  • Conectar: trata de como instalar o servidor MCP, as Skills e as Rules em cada ambiente (agente).
  • MCP: trata de como o servidor MCP é configurado, dos grupos de servidores e do servidor de upload de arquivos.