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, saber 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 não dá para descobrir só com o método de chamada.

Skills e Rules são dois tipos de orientação que preenchem essa lacuna. Skills são guias com o método para executar bem uma tarefa específica, e 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 ambos junto com a conexão do MCP.

Diferença entre Skills e Rules

Os dois 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á um 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. 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 instalados 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 (IDE) a conectar e o Personal Access Token e, junto com a conexão do MCP, instala as Skills e Rules nesse ambiente. O processo de conexão do MCP e a configuração por ambiente são tratados em MCP.

Ao usar @latest, a versão mais recente é sempre instalada. Como a API do WEEGLOO e os padrões recomendados continuam a ser atualizados, é recomendável executar este comando periodicamente para manter as Skills e Rules atualizadas.

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.

• Repositório: github.com/weeglooapi/weegloo-mcp-plugin

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

• Diretório de Skills: plugins/weegloo/skills
• Diretório de Rules: plugins/weegloo/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

• MCP: trata do método de conexão do MCP e da configuração por ambiente. Skills e Rules também são instalados durante esse processo de conexão.