Quem opera o Hermes pode associar uma skill revisada a uma tarefa recorrente para que cada execução comece pelo mesmo procedimento. A verificação útil é saber se uma execução agendada lê a entrada permitida, produz um relatório local aceitável e registra qual modelo e host realmente a processaram. Este guia é para quem controla o perfil do Hermes, a conta do provedor e o host do gateway. A BIG CHANGE analisou o manual oficial de cron e a documentação relacionada em 19 de outubro de 2026; não instalamos o Hermes nem executamos uma tarefa.

A grande mudança

  • O que mudou: O Hermes pode carregar uma skill revisada antes de um prompt agendado, executá-la em um diretório de trabalho escolhido e salvar o resultado localmente. Você pode criar a tarefa pausada, inspecioná-la e retomar o mesmo ID de tarefa.
  • Por que importa: Uma tarefa informativa repetível pode usar um único procedimento revisado. Ainda é preciso conferir uma execução prevista em relação à entrada permitida; um agendamento salvo não comprova qual revisão da skill ou modelo foi usado nem se o relatório está correto.
  • O que observar: A continuidade depende de o host do gateway permanecer disponível e de a primeira execução atender aos critérios do relatório. Confira a tentativa, a saída e as evidências disponíveis de provedor/modelo antes de deixar a tarefa ativa; inspecione seu estado exato novamente após qualquer interrupção.

Antes de agendar qualquer coisa

Escolha um arquivo de entrada pequeno e permitido e um diretório de trabalho existente e isolado. Defina o que um relatório curto correto deve conter, onde deve citar a entrada e quais dados ausentes devem fazê-lo parar. Mantenha a primeira tarefa apenas informativa: sem publicações externas, alterações de registros ou segredos na saída. Obtenha autorização separada para torná-la recorrente. Você também precisa de uma instalação configurada do Hermes, uma conexão utilizável com modelo/provedor e credenciais, além de um host de gateway que possa permanecer disponível para as execuções agendadas. Confira a versão instalada e hermes cron create --help, pois o manual público não informa uma versão para cada opção. O guia de início rápido aborda a configuração; o guia de provedores explica o caminho de inferência. Uma conversa única e inofensiva pode verificar esse caminho antes da recorrência, mas não comprova que uma execução agendada funcionou.

Uma skill é um procedimento revisado em SKILL.md, não um limite de permissões. Coloque skills/local-input-report/SKILL.md no HERMES_HOME real do perfil responsável; ~/.hermes/skills/local-input-report/SKILL.md é o exemplo do perfil padrão. Antes de usar este procedimento mínimo, adapte-o à entrada aprovada e aos critérios do relatório:

Markdown
---
name: local-input-report
description: Report checked facts from one approved local input.
---

Read only <absolute-permitted-input-path> in the job workspace. In a short report, name that file, state only facts supported by it, and cite the relevant part. Flag missing data and stop. Do not send messages or change files or external records.

Inspecione o arquivo real e confirme que o Hermes o encontra com hermes skills list nesse mesmo perfil. Se usar uma skill local do projeto, o manual de skills informa que uma decisão interativa de confiança e verificação deve anteceder uma execução não interativa de cron; o cron não concede confiança por conta própria. Revise separadamente as ferramentas habilitadas e o acesso real aos arquivos. Registre o conteúdo ou a revisão da skill para que o nome não substitua uma análise.

Crie uma tarefa e depois inspecione-a

  1. Execute todos os comandos no mesmo perfil responsável: os exemplos abaixo usam o perfil padrão, enquanto um perfil nomeado precisa de seu seletor, como hermes -p NAME, em todos os comandos. Confira o modelo atual desse perfil com hermes model e a integridade do gateway e do processo de verificação periódica com hermes cron status. Decida se vai fixar explicitamente provedor e modelo ou fixar o modelo principal atual. Uma definição por tarefa tem precedência sobre cron.model e cron.model_provider; essas configurações gerais têm precedência sobre o modelo principal atual. Portanto, uma tarefa sem modelo fixado pode mudar de modelo quando o padrão aplicável mudar. A configuração salva ainda não comprova qual modelo foi usado em uma execução real.
  2. Com a recorrência autorizada, adapte este exemplo de CLI para shell POSIX à skill revisada e a um diretório de trabalho absoluto e existente. Antes, confirme cada opção na ajuda instalada. As continuações de linha com barra invertida são sintaxe de shell POSIX; em outra plataforma, use a sintaxe do seu shell. O prompt é deliberadamente restrito e a entrega local mantém a primeira saída no perfil responsável:
Terminal
   hermes cron create "every 1h" \
     "Use the attached reviewed skill to read only the permitted input. Return a short local report with its source and missing-data note. Do not send or change external records." \
     --skill local-input-report \
     --name "Local input report" \
     --workdir "/absolute/existing/workspace" \
     --pin \
     --paused --paused-reason "Awaiting owner review"

Substitua o caminho do diretório de trabalho, escolha um nome exclusivo para a tarefa e substitua o marcador de entrada no arquivo da skill antes de executar este comando. A CLI usa entrega local por padrão. O manual de cron também documenta --model e --provider para uma definição explícita. Se escolher esse caminho, use os identificadores reais de provedor/modelo da sua instalação. Não coloque credenciais no prompt nem no histórico do shell. --workdir faz o Hermes encontrar as instruções do diretório de trabalho; sem isso, o cron executa separado do repositório. Uma tarefa nova pausada não tem next_run_at até ser retomada.

A entrega local controla onde o relatório final é salvo. O prompt e todo conteúdo de entrada usado na inferência continuam seguindo o caminho de modelo/provedor selecionado; aprove esse fluxo de dados antes de retomar.

  1. Guarde o ID da tarefa retornado. Use hermes cron list para consultar a skill, o diretório de trabalho, a entrega e o estado pausado; use hermes cron status para verificar a integridade do agendador. O código-fonte oficial atual da CLI não mostra os campos salvos de modelo/provedor nas linhas da lista. Inspecione o ID exato em cron/jobs.json em modo somente leitura no perfil responsável, para conferir a definição fixada, o modelo/provedor e as substituições de inferência salvas, ou use uma visualização de detalhes de tarefa realmente compatível com sua versão instalada. Não imprima credenciais. Compare as configurações salvas com o arquivo, os critérios do relatório e o escopo aprovados. Corrija esta tarefa com hermes cron edit <job_id> ... se necessário; não há motivo para criar outra cópia.
  2. Quando puder observar uma execução prevista, use hermes cron resume <job_id>. Consulte o instante real da próxima execução e a última verificação bem-sucedida do gateway. O gateway verifica aproximadamente uma vez por minuto; um gateway em primeiro plano exige que seu host permaneça ligado. hermes cron tick não inicia um gateway para uma tarefa de agente. Um serviço ou processo resistente a reinicializações tem requisitos específicos do host; confira o host escolhido em vez de presumir funcionamento com o notebook desligado ou garantias após reiniciar.
  3. Depois de um horário agendado, inspecione hermes cron runs <job_id> --limit 20 e o arquivo correspondente em cron/output/<job_id>/ no perfil responsável. Compare o relatório com a entrada real e seus critérios de aceitação. Confira os horários agendado e de reserva da tentativa, o estado final e qualquer transcrição ou telemetria disponível para identificar o provedor e modelo realmente usados. Se os registros instalados não expuserem essa identidade, registre-a como desconhecida. Uma verificação do agendador, uma execução admitida ou o estado completed não validam o relatório por si sós.
  4. Pause a tarefa exata com hermes cron pause <job_id> e consulte-a em hermes cron list. Isso interrompe futuros agendamentos automáticos; não encerra uma tentativa em andamento. Uma execução manual explícita é uma intervenção do operador, mesmo durante a pausa. Preserve o histórico e a saída local enquanto decide se a tarefa atendeu aos critérios de aceitação.

Se falhar, recupere a mesma tarefa

Leia primeiro a tentativa exata e sua saída, depois os campos da tarefa last_error, last_fire_error e last_delivery_error quando disponíveis. hermes cron status distingue um processo de verificação parado ou um armazenamento de cron sem permissão de escrita de uma tarefa que executou e falhou. Confira o perfil responsável e o host do gateway antes de mudar as configurações do provedor: um shell interativo e um serviço podem ler credenciais diferentes. Corrija somente a configuração afetada, verifique o estado novamente e retome o mesmo ID apenas se o escopo continuar aprovado. Se a entrega for incerta, inspecione o destino pretendido antes de tentar novamente; o tempo limite pode ocorrer depois que um adaptador aceitou o envio.

A seção de recuperação de admissões do manual de cron informa que uma execução interrompida ou um disparo preparado não encontrado permanece pausado para revisão; a seção de histórico informa que tentativas desconhecidas nunca são executadas novamente de forma automática. Após uma reinicialização, confira o estado pausado da tarefa instalada e a identidade exata da tentativa antes de decidir como recuperá-la. Nunca acione duas vezes uma tentativa ativa para testar sobreposição. O Hermes tem um bloqueio de verificação do agendador, uma proteção contra nova admissão para a mesma tarefa em andamento e um limite configurável de concorrência geral. Esses controles não garantem efeitos exatamente uma vez em um sistema externo.

O uso do provedor e um host sempre disponível podem custar dinheiro. Comece com uma entrada limitada e confira o uso do provedor depois da execução prevista antes de escolher uma frequência contínua. O tempo limite documentado do script anterior à execução não limita uma interação com o modelo orientada por skill nem sua cobrança; os limites de limpeza e inatividade são separados. Um prazo escrito no prompt é uma instrução, não um controle rígido de gastos. Se não puder tolerar uma interação com o modelo sem limite ou um efeito colateral incerto, mantenha a tarefa pausada até ter controles adequados. Este guia relata comportamento documentado, não uma execução medida, um preço, um resultado de confiabilidade ou uma alegação de economia.