Skills

Skills são instruções reutilizáveis que você pode anexar a uma mensagem do agente.

Use uma skill quando quiser que o agente siga um processo específico, checklist, guia de estilo, rotina de testes ou definição de pronto. Uma skill é uma orientação para o agente. Ela não altera as permissões do Buildprint, as permissões de colaborador do Bubble, o branch selecionado ou se o chat está no modo Plan ou no modo Build.

Escopos de skills

O Buildprint suporta três escopos de skills.

Skills oficiais

As skills oficiais são gerenciadas pelo Buildprint e estão disponíveis automaticamente.

A lista exata pode mudar com o tempo. Abra Skills para ver as skills oficiais disponíveis atualmente no seu workspace.

As skills oficiais são somente leitura.

Skills do workspace

As skills do workspace estão disponíveis em todos os chats do workspace.

Use skills do workspace para instruções de toda a equipe, como checklists de revisão, estilo de escrita, padrões de QA ou regras comuns de entrega.

Administradores do workspace podem criar e gerenciar skills do workspace.

Skills do projeto

As skills do projeto estão disponíveis quando o projeto proprietário está selecionado no chat.

Use skills do projeto para instruções específicas do app, como convenções de nomenclatura, contas de teste, regras de workflow ou restrições de produto que se aplicam apenas a um app Bubble.

Usuários com acesso ao projeto podem criar ou gerenciar skills do projeto, sujeitos às permissões atuais do produto.

Criar uma skill

Abra Skills.

Escolha se deseja criar uma skill de workspace ou uma skill de projeto. Para uma skill de projeto, selecione o projeto ao qual ela pertence.

Adicione:

• Um nome claro.

• Instruções da skill.

O Buildprint gera um slug de skill no estilo barra (/) a partir do nome, como /bug-triage.

Clique em Create skill.

Use uma skill no chat

No editor do chat, digite / ou @ para abrir o menu de comandos. Você também pode usar o botão de adicionar contexto no editor.

Selecione uma skill na seção Skills.

A skill selecionada aparece como um chip no editor. Envie sua mensagem como de costume.

Uma skill é anexada apenas àquela mensagem. Anexe-a novamente se quiser que o agente a siga em uma interação posterior.

O que colocar em uma skill

Boas skills são específicas. Elas dizem ao agente o que fazer, o que evitar e qual resultado você espera.

Uma skill útil geralmente inclui:

• O objetivo da skill.

• As etapas que o agente deve seguir.

• Verificações que o agente deve executar.

• Restrições, regras de estilo ou casos de borda.

• O que a resposta final deve incluir.

Exemplo:

Goal: Review a Bubble workflow change before it is merged.

Steps:
- Inspect the changed workflow and related data types.
- Look for privacy, authentication, payment, and error-handling risks.
- Suggest tests for the development branch.

Constraints:
- Do not recommend schema changes unless they are required.
- Keep comments focused on issues that could affect users.

Output:
- List blockers first.
- Then list non-blocking suggestions.
- End with tests to run before merging.

Editar ou arquivar uma skill

Em Skills, abra uma skill que você possa gerenciar.

Use Save changes para atualizar o nome ou as instruções.

Use Archive quando a skill não deve mais aparecer no chat.

Mantenha as skills seguras

Não coloque segredos em skills.

Evite adicionar:

• Chaves privadas.

• Tokens de API.

• Senhas.

• Cookies.

• Dados de clientes.

• Credenciais internas.

• Qualquer coisa que você não queira que seja enviada ao provedor de modelo selecionado.

Se um segredo for exposto em uma skill, rotacione-o no provedor original.