Código de saída Bash, saída do script e diffs em um cartão de chat

O que o agente pode fazer

• Arquivosread_file, write_file, edit_file, grep, glob e list_dir operam na pasta de trabalho do chat, e edit_file mostra o diff de cada alteração. Um contador indica quantos arquivos foram criados, editados e lidos.
• Shellexecuta um comando no ambiente escolhido, como Windows, WSL ou um servidor que você possui via SSH, e relata o código de saída real. Comandos perigosos são bloqueados.
• Webweb_search pesquisa informações e http_get busca uma página de documentação, para que você possa ler o que um comando faz antes de usá-lo.
• Capturas de tela e imagensocr lê texto de uma captura de tela salva, como uma mensagem de erro, e gen_image salva arquivos de imagem.
• Orquestraçãotask inicia subagentes em paralelo, run_on_model envia uma etapa crítica para um modelo maior, e skills são playbooks reutilizáveis.
• Modos de aprovaçãoAuto-run executa imediatamente, Ask first pausa antes de ações que alteram algo, e Plan only gera um plano sem executar nada.
• Cronexecuta um prompt em um agendamento, por exemplo, uma execução diária de teste do seu script em uma máquina que você possui.
• Modelosum provedor de IA na nuvem por meio de um endpoint de API, um modelo no seu PC ou o modelo integrado, que está pronto sem necessidade de seu próprio endpoint.

Quatro tarefas com códigos de saída e argumentos

Verificar o código de saída quando falta um argumento

Você pede ao agente para descobrir o que acontece quando check.sh é executado sem argumentos. read_file abre o script, e Shell executa bash check.sh sem nada após o nome. O cartão mostra a saída real e o código de saída, que é 2 se o script imprimir sua linha de uso no erro padrão e terminar com exit 2. O código de saída do último comando fica em $?, e o chamador vê apenas esse número; portanto, um script que termina com um código claro é mais fácil de testar do que um que sempre retorna 1. Shell então executa o script novamente com dois valores, e o cartão deve mostrar 0. Se os códigos surpreenderem, leia o cartão, deixe edit_file propor uma correção no modo Ask first e revise o diff.

Analisar opções com getopts

Você digita “explique getopt para mim” e o agente responde em linguagem clara: getopts é um built-in do Bash para opções curtas como -v ou -f arquivo, enquanto getopt é um comando separado que também lida com opções longas como --file e se comporta de maneira diferente entre sistemas. Em seguida, read_file abre seu script, edit_file adiciona um loop getopts e você vê o diff. Shell executa o script com -v, com -f e com uma opção inválida, e cada cartão tem seu próprio código de saída. Uma opção inválida deve terminar com 2, o código usual para uso incorreto. Para poucas opções, um loop while com case e shift é suficiente; solicite essa versão se preferir. Aceite o diff apenas após lê-lo.

Preservar valores com espaços

Passar argumentos com espaços para um script falha quando os valores não estão entre aspas, pois o shell os divide em palavras separadas. O agente lê o arquivo com read_file, identifica o $1 e $@ sem aspas, e edit_file propõe o uso de aspas duplas ao redor deles. Shell então executa o script com um valor como "duas palavras", e a saída mostra se ela chega como uma linha ou como duas. Uma das técnicas para gerenciar argumentos de linha de comando é shift, que remove o primeiro valor para que um loop possa percorrer o restante; o agente pode adicioná-lo no mesmo diff. No modo Ask first, a edição aguarda sua confirmação. Revise o diff, execute o teste novamente e compare as duas saídas.

Parar em erros com set -eu

Quem pesquisa por “bash exit script” geralmente procura pelo builtin exit: exit N termina o script com status N, enquanto return N apenas encerra uma função. O agente pode adicionar set -eu e set -o pipefail no início, para que o script pare em erros e em variáveis não definidas, e então executa o arquivo com bash -n para verificar a sintaxe e com bash -x para imprimir cada comando. Se return não estiver fornecendo o status do último comando, outro comando provavelmente foi executado entre meio, pois $? armazena apenas o código de saída do comando mais recente. O cartão Shell mostra o trace. Leia-o do início, compare-o com o script e decida se mantém a edição.