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
• obtenha habilidades recomendadas com base em seus projetos e repositórios atuais
• 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, descobrir recomendações, 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 Recommendation e 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á quatro guias principais:

• Local Skills
• Recommendation
• 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.

:::caução[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. Obtenha habilidades recomendadas

Recommendation cria uma lista de candidatos a partir de seus projetos e repositórios atuais. É útil quando você sabe que tipo de trabalho está fazendo, mas ainda não decidiu quais habilidades instalar.

Uma ordem de leitura prática é:

1. Verifique os seletores de heróis na parte superior para entender qual contexto impulsiona a recomendação
2. Clique Generate recommendations
3. Revise os chips de consulta para ver por que esses candidatos foram escolhidos
4. Compare os cartões candidatos antes de abrir o painel de detalhes

Rótulos comuns em cartões de recomendação significam:

• Recommended: atualmente sugerido pelo sistema
• Installed: já instalado
• Installed locally: já está disponível no ambiente local e geralmente não precisa ser reinstalado

O que installed locally significa

Este rótulo significa “você já o possui”. Não é um aviso dizendo para você instalá-lo agora.

4. 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.

5. 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.

6. 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 Recommendation e 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 Recommendation para encontrar candidatos que se encaixem no seu trabalho atual
3. Usar Gallery para pesquisar e comparar fontes
4. Abra o painel de detalhes para verificar o estado de confiança e instalar o comando
5. Se necessário, revise ou ajuste as regras de confiança em Trusted Providers

Leitura relacionada

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

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

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