Guia de habilidades

Este guia cobre o Skills painel no HagiCode.

Abra habilidades quando quiser:

• veja quais habilidades já estão instaladas nesta máquina
• pesquise na biblioteca de habilidades mais ampla
• confirme a origem, o estado de confiança e o comando de instalação real antes de instalar
• gerenciar quais fontes são rotuladas como confiáveis

Para que servem as habilidades

Skills é o painel de navegação e instalação de habilidades integrado do HagiCode. Ele oferece um local para revisar as habilidades disponíveis localmente, pesquisar na galeria e inspecionar os detalhes da instalação antes de instalar qualquer coisa.

Use-o quando:

• você é novo no HagiCode e quer ver o que já está disponível
• você conhece o tipo de trabalho que está fazendo e deseja melhores habilidades de ajudante
• você deseja instalar uma nova habilidade, mas precisa primeiro verificar a fonte
• você deseja evitar reinstalar algo que já está disponível localmente

Ordem de leitura recomendada

Numa primeira passagem, comece com Local Skills, depois vá para Gallerye só então revise o painel de detalhes antes de instalar.

1. Habilidades Abertas

Na barra de navegação superior da área de trabalho do HagiCode, clique no botão Skills botão para abrir o painel.

A seta vermelha na captura de tela destaca o ponto de entrada.

Após abrir o painel, você verá três guias principais:

• Local Skills
• Gallery
• Trusted Providers

Quando abrir habilidades

Você não precisa sair do seu projeto, sessão ou fluxo de integração atual. As habilidades são abertas na barra superior dentro do mesmo espaço de trabalho.

2. Revise as habilidades instaladas localmente

Local Skills responde a duas perguntas comuns: O que já está instalado? e Quais destas habilidades podem ser atualizadas agora?

As áreas mais importantes desta página são:

• Caixa de pesquisa: filtre habilidades locais por nome, ID, caminho ou agente
• Refresh inventory: verifique novamente o que está atualmente instalado nesta máquina
• Update all: execute atualizações em lote para habilidades que suportam atualizações gerenciadas
• Batch update summary: revise o resultado do lote mais recente e o registro de status

Cada linha geralmente mostra:

• o nome da habilidade
• agentes compatíveis
• o caminho de instalação local
• ações disponíveis

Se uma linha avisar que faltam metadados de instalação gerenciados por backend, essa habilidade não poderá usar atualizações com um clique e deverá ser revisada manualmente.

A atualização em lote ainda precisa de revisão humana

Update all significa apenas que o fluxo de atualização é executado em massa. Isso não significa que as habilidades listadas já tenham sido revisadas em termos de segurança para o seu caso de uso.

3. Pesquise e compare na galeria

Se você já sabe o que procura ou deseja comparar habilidades semelhantes de fontes diferentes, use Gallery.

Gallery é o melhor lugar para:

• pesquisar por palavra-chave
• filtre primeiro para fontes confiáveis
• comparar habilidades semelhantes de fontes diferentes
• verifique a contagem de instalações e o estado da instalação local

Comece com três campos:

• Source: quem fornece a habilidade
• Installs: a contagem de instalações, que pode funcionar como um sinal de apoio
• Installed locally: se a habilidade já está disponível em sua máquina

Verifique a fonte antes da contagem de instalações

A popularidade pode ajudar, mas não deve substituir a revisão da fonte. Comece com Source, então use Installs como contexto extra.

4. Revise os detalhes das habilidades antes de instalar

Ao abrir uma habilidade, o HagiCode mostra o painel de detalhes. Esta é a tela mais importante a ser revisada antes da instalação.

Preste atenção especial a:

• nome, fonte e contagem de instalações: certifique-se de abrir o item pretendido
• Trust status: por que esta fonte é considerada confiável
• Managed command: o comando real HagiCode está preparado para ser executado
• Status: se o espaço de trabalho atual pode instalar esta habilidade
• Overview: identificadores de suporte, como ID de habilidade, slug, origem e contagem de instalações

Managed command é importante porque é o comando de instalação real, não o texto decorativo.

trusted não significa “pular a revisão”

Mesmo quando uma fonte está marcada trusted, você ainda deve ler ambos Trust status e Managed command antes de instalar.

5. Gerencie provedores confiáveis

Trusted Providers controla quais fontes recebem o trusted rótulo. Abra-o quando quiser saber por que uma fonte é confiável ou quando precisar ajustar suas regras de confiança.

Nesta página:

• Rule format explica como as regras são escritas
• Add provider permite adicionar um conjunto de regras de provedor
• Reset defaults restaura as predefinições padrão
• o Rules, Status, e Source examples colunas mostram as regras de correspondência, estado atual e exemplos de correspondências

Os estilos de regras comuns incluem:

• prefix:owner/ para confiança baseada em prefixo
• exact:owner/repo para uma única fonte exata

Trusted Providers não é uma página de credenciais

Esta página decide apenas quais fontes são rotuladas como confiáveis. Não armazena tokens, senhas ou outros segredos.

Verifique estas 4 coisas antes de instalar

Antes de instalar uma habilidade, revise pelo menos estes quatro sinais:

Verifique	Onde procurar	O que isso te diz
Se a fonte é confiável	Trusted Providers, mais Trust status no painel de detalhes	Por que esta fonte é rotulada como confiável
Se já está instalado	rótulos de status em Gallery	Se diz installed locally, geralmente não é necessário reinstalá-lo
Resultado da atualização em lote	Batch update summary em Local Skills	Se a última atualização em massa foi bem-sucedida e se algo precisa de revisão manual
Comando de instalação real	Managed command no painel de detalhes	O que o HagiCode realmente vai executar

Um caminho de usuário comum

Um fluxo inicial comum é:

1. Abrir Local Skills e revise o que já está disponível
2. Usar Gallery para pesquisar e comparar fontes
3. Abra o painel de detalhes para verificar o estado de confiança e instalar o comando
4. Se necessário, revise ou ajuste as regras de confiança em Trusted Providers

Leitura relacionada

Product OverviewSee where Skills fits in the larger HagiCode workspace and workflow.

Wizard SetupIf you are just getting started, review the current onboarding flow before returning to Skills.

Desktop Installation GuideIf you are still finishing installation or first launch, continue with the desktop setup guide.