Extensões
Adicione agentes, skills, ferramentas, automações de ciclo de vida e provedores de capacidades mantendo a superfície ativa explícita e revisável.
O Clarvis trata descoberta, instalação e ativação como decisões separadas. Baixar um plugin não torna seu código silenciosamente disponível a um agente. Você escolhe os itens instalados exatos que pertencem a um Extension Profile, revisa tudo o que fornecem e só então ativa um snapshot resolvido para as próximas execuções.
Entenda as quatro camadas
| Camada | O que faz |
|---|---|
| Marketplace | Catálogo que ajuda a descobrir pacotes de plugins. Não ativa nada. |
| Plugin | Pacote instalado que pode fornecer agentes, skills, servidores MCP, hooks ou backends de capacidades. |
| Skill standalone | Pacote de instruções reutilizáveis instalado independentemente de um plugin. |
| Extension Profile | Allow-list completa que seleciona plugins instalados e skills standalone exatos. |
Um plugin é a unidade atômica de ativação: quando selecionado, todas as contribuições declaradas entram juntas. Uma skill standalone pode ser selecionada diretamente. Um Extension Profile nunca escolhe modelo ou perfil de agente, altera permissões de ferramentas ou política de sandbox, guarda credenciais nem fixa versões de pacotes.
Acompanhe o fluxo de ativação
Abra /extensions e pressione Enter para usar o compositor guiado:
- escolha se a definição pertence ao escopo global ou a este workspace;
- edite um perfil, clone o snapshot ativo ou comece com uma allow-list vazia;
- pesquise listagens do marketplace, plugins instalados e skills standalone juntos;
- inspecione o conjunto completo de agentes, skills, MCP, hooks e executáveis;
- revise o delta exato de ativação, aprove conteúdo executável do workspace quando necessário, aplique e reconecte.
A instalação iniciada em uma linha do marketplace acontece antes da ativação. O item é apenas preparado no rascunho; nada fica ativo antes da aprovação do delta final. Uma aplicação bem-sucedida vale para novas execuções. Uma execução em andamento mantém o snapshot imutável com que começou.
Escolha o padrão ou um perfil isolado
builtin:default é um ponto de partida virtual e imutável. Ele usa a lista normal de ativação de plugins e disponibiliza todas as raízes de skills standalone com a precedência padrão.
Crie um Extension Profile customizado quando um workspace precisar de um conjunto exato de capacidades — por exemplo, um perfil de pesquisa com ferramentas de navegador e documentação ou um perfil mínimo que não possa herdar um plugin global sem relação com o projeto. Perfis customizados são allow-lists completas; eles não adicionam itens a builtin:default e não herdam uns dos outros.
Mantenha a ativação local e auditável
As definições podem ter escopo global ou do workspace. Uma definição de workspace pode ser versionada e compartilhada, mas o perfil selecionado é estado local da máquina: clonar um repositório não ativa conteúdo executável sozinho.
Plugins do workspace exigem aprovação do inventário executável exato. O Clarvis calcula o fingerprint dos bytes das contribuições resolvidas e do estado de confiança, registra o id e o fingerprint do perfil em execuções e sessões e falha de forma fechada quando o conteúdo selecionado muda. Use /reconnect após uma alteração intencional para que a próxima execução receba um snapshot novo.
Escolha o guia de extensões certo
| Você quer… | Leia |
|---|---|
| compor e selecionar um conjunto exato de capacidades | Extension Profiles |
| dar aos agentes instruções reutilizáveis sob demanda | Skills |
| conectar um servidor externo de ferramentas ou prompts | Servidores MCP |
| executar automações em eventos do ciclo de vida | Hooks |
| empacotar várias contribuições juntas | Plugins |
| publicar ou consumir catálogos de plugins | Marketplaces |
| inspecionar formatos, limites e estados | Referência de extensões |
| entender escopo e aprovação de executáveis | Escopos e confiança no workspace |