lessan/jobs

Trabalhos (Jobs)

Use runjob para delegar trabalho limitado a um modelo de linguagem headless instalado e manter um livro-razão de execução em toda a máquina. Confirme que runjob está no PATH; se não estiver, oriente o usuário para as etapas de instalação do repositório, em vez de improvisar uma instalação em toda a máquina.

Lançar um trabalho pode consumir cota ou gerar custos do provedor. Trate uma solicitação explícita para despachar ou delegar trabalho como autorização para esse lançamento. Uma solicitação para explicar, inspecionar, rascunhar ou planejar não é autorização de lançamento.

Escolha a forma de execução

• Use runjob run para um trabalho único. Ele executa no diretório de trabalho selecionado e não cria um branch ou worktree. Para trabalho que possa editar ou commitar, use um worktree Git descartável ou o modo de frota.
• Use runjob fleet run para vários trabalhos, ordenação por dependências, worktrees isolados automáticos, sessões retomáveis ou limites de concorrência por motor. Leia references/fleet.md antes de criar arquivos de frota.
• Use runjob log, runjob report e runjob dash para inspecionar trabalhos já em andamento. Estes são somente leitura; runjob repair é uma mutação explícita do livro-razão.

Não substitua esta habilidade por um subagente dentro da sessão quando o usuário pediu delegação dentro da conversa atual.

Trabalhos únicos

Use um arquivo de prompt para instruções substanciais, de forma que o despacho seja revisável:

runjob run --engine codex --effort high \
  --cwd /caminho/absoluto/para/worktree --file /caminho/absoluto/para/prompt.md

Omita --model ou --effort quando o usuário não os selecionou e o motor tem um padrão de CLI sensato. Não invente nomes de modelos atuais. Leia references/engines.md quando flags específicas do motor, autenticação ou comportamento de sandbox forem relevantes.

runjob run retorna após o lançamento, a menos que --wait seja fornecido. Guarde o uid impresso. Inspecione-o com:

runjob log --uid UID
runjob log --active
runjob report UID --json
runjob dash

Logs e prompts podem conter código-fonte ou instruções confidenciais. Eles ficam em ${DEV_JOBS_HOME:-~/.config/dev-jobs}; não publique ou anexe-os sem uma revisão separada.

Conclusão e entrega

Informe o uid, motor/modelo realmente solicitado, diretório de trabalho e se o trabalho foi meramente lançado ou concluído. Não descreva o lançamento de um processo como um resultado bem-sucedido. Ao aguardar, verifique o estado final do livro-razão e resuma a saída real do trabalho, incluindo falhas ou trabalho residual.

Para finais de trabalho legíveis por máquina, use o protocolo exato em references/report-trailer.md. Trate seus campos como as afirmações do trabalho; verifique independentemente commits, testes e caminhos modificados antes de mesclar ou publicar qualquer coisa.