Skill do herdr-core

A skill do herdr-core orienta o agente a trabalhar com terminais pelo comando hc. Você pode acompanhar processos, consultar logs e coordenar agentes. Para localizar espaços e abas ou personalizar a janela do Herdr Desktop, o agente também consulta herdr-app --skill.

Prepare o ambiente

O herdr-core e o agente precisam estar instalados. Para os exemplos que usam espaços, abas ou layouts, abra também o Herdr Desktop. O agente precisa de acesso aos terminais ou aos arquivos envolvidos na tarefa.

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-core

Para trabalhar com os terminais mantidos pelo core, use:

1
hc --skill

A skill descreve como listar os terminais e iniciar um processo. Também explica como ler a saída de um terminal e enviar texto para ele. O core identifica o terminal atual pela variável HC_TERMINAL_ID. Fora desse ambiente, a instrução orienta o agente a confirmar com você antes de controlar terminais existentes.

Você pode começar solicitando que o agente liste os terminais e encontre o processo de desenvolvimento pelo nome. Para acompanhar uma execução conhecida, a referência inclui hc wait e hc read. Use a identificação retornada pelo core para selecionar o terminal que você pretende acompanhar.

Acompanhe uma tarefa demorada

No projeto que você pretende testar, envie:

1
Consulte hc --skill. Identifique o comando de teste deste projeto e execute-o em um terminal do core chamado testes. Guarde o endereço retornado e acompanhe a execução até obter o resultado. Se a espera terminar enquanto o processo continua ativo, retome a leitura desse mesmo terminal. Informe o resultado dos testes.

O core pode encerrar uma espera e manter o programa em execução. O endereço retornado permite consultar o mesmo processo sem iniciar outra execução.

Consulte um servidor que já está rodando

Use o nome do seu servidor no lugar de web:

1
Leia hc --skill e liste os terminais. Localize o servidor chamado web e leia as últimas 100 linhas de saída. Resuma os erros encontrados e informe o endereço do terminal consultado. Preserve o processo em execução. Se houver mais de um terminal com esse nome, apresente as opções antes de enviar comandos.

Você deve receber um resumo dos logs disponíveis. No core, o estado de um agente depende do que o programa informa pelo protocolo OSC 7501. Um programa que não envia esse estado pode continuar executando normalmente.

Encontre um terminal pelo espaço e pela aba

O nome exibido na janela pode ser diferente do nome do terminal no core. Indique o espaço, a aba e, quando necessário, a máquina para localizar o destino.

Consulte um terminal em outro espaço do Herdr Desktop

No Herdr Desktop, indique o espaço e a aba para o agente relacionar a janela ao terminal correto:

1
Leia herdr-app --skill e hc --skill. Na janela do Desktop, localize o espaço Loja e a aba Frontend. Identifique os terminais associados a essa aba e encontre o servidor de desenvolvimento pela saída recente. Leia as últimas 100 linhas disponíveis e resuma os erros. Informe o nome do espaço, a aba, a máquina e o endereço do terminal consultado. Se houver mais de um candidato, mostre as opções antes de continuar. Preserve a seleção atual da janela e os processos.

O resultado deve informar tanto a localização na janela quanto o endereço do terminal no core. Se existirem espaços chamados Loja em máquinas diferentes, acrescente ao texto o nome da máquina desejada.

Oriente alterações no Herdr Desktop

Uma mudança visual começa pela leitura do arquivo de instruções do aplicativo. Um exemplo de orientação para o agente é:

Leia o arquivo ~/.config/herdr-app/AGENTS.md e explique como acrescentar um indicador de tempo à aba atual. Preserve o layout que uso e apresente os arquivos que serão alterados.

Depois de conferir a proposta, acompanhe a mudança na janela. Os mods e layouts usam arquivos locais e podem incluir código. A instrução instalada explica a API disponível e os comandos para conferir o resultado.

Personalize uma cópia do layout

Para experimentar um indicador de tempo sem substituir o arquivo original, envie:

1
Leia herdr-app --skill e ~/.config/herdr-app/AGENTS.md. Identifique o layout atual e crie uma cópia com outro nome. Nessa cópia, acrescente um indicador do tempo decorrido na aba ativa. Confira as APIs disponíveis na versão instalada, valide os arquivos e explique como selecionar o novo layout e voltar ao anterior.

O agente deve entregar os arquivos da personalização e orientar a seleção do layout. Confira o indicador na janela do aplicativo, incluindo a troca entre abas.

Experimente um layout do catálogo

O Board exibe as abas em colunas. Para instalar o layout, envie:

1
Consulte herdr-app --skill e o AGENTS.md do Desktop. Registre o layout que estou usando. Leia as instruções oficiais do layout Board, confira a compatibilidade e instale os arquivos necessários. Explique como selecioná-lo na janela e como retornar ao layout anterior.

Depois da instalação, confira se as abas aparecem no Board e se você consegue voltar ao layout anterior. A skill orienta o trabalho do agente, mas a instalação dos arquivos e a seleção na janela continuam sendo etapas da tarefa.

Consulte as outras skills

Volte à apresentação das skills ou consulte a skill do Herdr TUI para operar os painéis dessa edição.