Skill do Herdr TUI

A skill do Herdr TUI orienta o agente a operar workspaces, abas e painéis com o comando herdr. Você pode consultar a saída de outro painel, acompanhar testes e trabalhar com agentes auxiliares.

Prepare o ambiente

Instale o Herdr TUI e abra o agente dentro de um painel do Herdr. Para iniciar outro agente nos exemplos, o programa correspondente também precisa estar instalado no computador.

Os blocos de texto abaixo são instruções para enviar ao agente. Copie o exemplo e ajuste os nomes ao seu projeto. Os blocos com comandos de consulta podem ser executados no terminal para ler a skill instalada.

Consulte a skill do Herdr TUI

No Herdr TUI instalado, este comando imprime a skill incluída no binário:

1
herdr --skill

A saída desse comando apresenta ao agente as instruções correspondentes à versão instalada. A skill orienta o trabalho dentro de um painel do Herdr e verifica a variável HERDR_ENV=1 para identificar esse ambiente. Abra o agente dentro do Herdr TUI para operar os painéis.

Você também pode instalar a skill pela ferramenta Skills:

1
npx skills add herdrdev/herdr --skill herdr -g

Com a opção -g, a ferramenta instala a skill no escopo global. Sem essa opção, a instalação fica no projeto. A skill disponível no repositório pode incluir mudanças que ainda não chegaram à versão instalada do Herdr. Consulte a saída de herdr --skill quando houver diferença entre as instruções.

Uma primeira tarefa pode ser consultar os painéis do workspace atual e identificar o terminal dos testes. Antes de enviar comandos ou iniciar outro agente, confira o destino da operação. A referência de comandos descreve as ações disponíveis.

Entenda os painéis abertos

Use este exemplo quando você voltar ao projeto e precisar localizar as tarefas que ficaram abertas:

1
Leia herdr --skill e confira se estamos dentro do TUI. Liste as abas e os painéis do workspace atual. Leia a saída recente dos painéis e resuma o que cada um está executando. Informe os identificadores encontrados e mantenha as sessões abertas.

Você deve receber a identificação dos painéis e um resumo da saída consultada. Se a leitura não permitir saber se uma tarefa terminou, o agente deve informar essa limitação.

Rode os testes em outro painel

No diretório do projeto, peça uma execução separada para acompanhar os testes enquanto continua trabalhando:

1
Consulte herdr --skill. Identifique o comando de teste documentado neste projeto. Abra um painel no mesmo diretório, sem mudar o foco do painel atual, e execute os testes. Use o identificador retornado ao criar o painel. Acompanhe a saída e informe o resultado e as falhas encontradas.

O resultado esperado é um painel com a execução dos testes e um relato baseado na saída. O recebimento do comando pelo painel, sozinho, não comprova que os testes passaram.

Peça uma revisão a outro agente

Este exemplo depende de um agente compatível instalado no computador:

1
Leia herdr --skill e verifique quais agentes estão disponíveis. Abra um painel para um agente revisor e peça que examine as mudanças locais, sem editar arquivos. Solicite os problemas encontrados com os caminhos e as linhas correspondentes. Acompanhe a resposta e apresente o relatório da revisão.

Se o agente auxiliar solicitar uma aprovação, a tarefa precisa dessa intervenção para continuar. Caso a espera termine antes da resposta, confira o painel antes de reenviar a instrução: o agente pode ainda estar trabalhando.

Encontre outro painel pelo nome

Substitua API, Frontend, Loja e reviewer pelos nomes do seu ambiente. O agente deve localizar o destino e usar o identificador encontrado.

Leia o painel chamado API

No Herdr TUI, envie esta orientação para localizar o painel pelo título e consultar os logs:

1
Leia herdr --skill. No workspace atual, localize o painel cujo título é API. Confirme a aba e o identificador desse painel, leia as últimas 100 linhas disponíveis e resuma os erros. Se houver mais de um resultado, mostre a aba e o identificador de cada um para eu escolher. Mantenha o foco no painel atual e preserve os processos.

A resposta deve identificar o painel consultado e resumir a saída disponível. Se nenhum título corresponder a API, o agente deve informar os painéis encontrados.

Consulte uma aba em outro workspace

Para consultar um teste que está aberto em outra área do Herdr TUI, indique o workspace e a aba:

1
Consulte herdr --skill. Localize o workspace Loja e, dentro dele, a aba Frontend. Liste os painéis dessa aba e identifique qual está executando os testes pela saída recente. Leia o resultado disponível e informe o workspace, a aba e o identificador do painel consultado. Se a saída não permitir identificar o painel dos testes, apresente as opções. Preserve o foco e as sessões existentes.

O agente deve localizar o workspace antes de procurar a aba. Isso evita confundir duas abas chamadas Frontend em projetos diferentes.

Leia a resposta de um agente pelo nome

Para consultar um agente chamado reviewer que já está aberto no Herdr TUI, envie:

1
Leia herdr --skill e localize o agente ativo chamado reviewer nesta sessão. Consulte seu estado e sua saída recente. Resuma a revisão que ele já produziu e informe se ainda está trabalhando ou aguardando uma intervenção. Apenas leia a saída, sem enviar uma nova tarefa.

O nome identifica o agente enquanto ele permanece registrado naquela sessão. Depois que ele sai, o mesmo nome pode deixar de estar disponível. A leitura também depende do histórico que o aplicativo mantém acessível.

Consulte as outras skills

Volte à apresentação das skills ou consulte a skill do herdr-core para trabalhar com os terminais do Herdr Desktop.