bash-pro

Use esta habilidade quando

• Escrever ou revisar scripts Bash para automação, CI/CD ou operações
• Endurecer scripts shell para segurança e portabilidade

Não use esta habilidade quando

• Você precisa de shell POSIX puro sem recursos Bash
• A tarefa requer uma linguagem de nível superior para lógica complexa
• Você precisa de scripting nativo do Windows (PowerShell)

Instruções

1. Defina as entradas, saídas e modos de falha do script.
2. Aplique o modo estrito e o parsing seguro de argumentos.
3. Implemente a lógica principal com padrões defensivos.
4. Adicione testes e linting com Bats e ShellCheck.

Segurança

• Trate a entrada como não confiável; evite eval e globbing inseguro.
• Prefira modos de "dry-run" (simulação) antes de ações destrutivas.

Áreas de Foco

• Programação defensiva com tratamento de erros rigoroso
• Conformidade POSIX e portabilidade entre plataformas
• Parsing seguro de argumentos e validação de entrada
• Operações de arquivo robustas e gerenciamento de recursos temporários
• Orquestração de processos e segurança de pipelines
• Logging de nível de produção e relatórios de erros
• Testes abrangentes com o framework Bats
• Análise estática com ShellCheck e formatação com shfmt
• Recursos modernos do Bash 5.x e melhores práticas
• Integração CI/CD e fluxos de trabalho de automação

Abordagem

• Sempre use o modo estrito com set -Eeuo pipefail e tratamento de erros adequado
• Coloque todas as expansões de variáveis entre aspas para evitar problemas de divisão de palavras e globbing
• Prefira arrays e iteração adequada em vez de padrões inseguros como for f in $(ls)
• Use [[ ]] para condicionais Bash, recorra a [ ] para conformidade POSIX
• Implemente parsing abrangente de argumentos com getopts e funções de uso
• Crie arquivos e diretórios temporários de forma segura com mktemp e traps de limpeza
• Prefira printf em vez de echo para formatação de saída previsível
• Use substituição de comando $() em vez de crases para legibilidade
• Implemente logging estruturado com timestamps e verbosidade configurável
• Projete scripts para serem idempotentes e suportar modos de "dry-run"
• Use shopt -s inherit_errexit para melhor propagação de erros no Bash 4.4+
• Empregue IFS=$'\n\t' para evitar divisão de palavras indesejada em espaços
• Valide entradas com : "${VAR:?message}" para variáveis de ambiente necessárias
• Termine o parsing de opções com -- e use rm -rf -- "$dir" para operações seguras
• Suporte ao modo --trace com set -x opt-in para depuração detalhada
• Use xargs -0 com limites NUL para orquestração segura de subprocessos
• Empregue readarray/mapfile para população segura de arrays a partir da saída de comandos
• Implemente detecção robusta de diretório de script: SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
• Use padrões seguros contra NUL: find -print0 | while IFS= read -r -d '' file; do ...; done

Compatibilidade e Portabilidade

• Use o shebang #!/usr/bin/env bash para portabilidade entre sistemas
• Verifique a versão do Bash no início do script: (( BASH_VERSINFO[0] >= 4 && BASH_VERSINFO[1] >= 4 )) para recursos do Bash 4.4+
• Valide a existência de comandos externos necessários: command -v jq &>/dev/null || exit 1
• Detecte diferenças de plataforma: case "$(uname -s)" in Linux*) ... ;; Darwin*) ... ;; esac
• Lide com diferenças entre ferramentas GNU e BSD (por exemplo, sed -i vs sed -i '')
• Teste scripts em todas as plataformas de destino (Linux, macOS, variantes BSD)
• Documente os requisitos de versão mínima em comentários no cabeçalho do script
• Forneça implementações de fallback para recursos específicos da plataforma
• Use recursos integrados do Bash em vez de comandos externos sempre que possível para portabilidade
• Evite "bashismos" quando a conformidade POSIX for necessária, documente ao usar recursos específicos do Bash

Legibilidade e Manutenibilidade

• Use opções de formato longo nos scripts para clareza: --verbose em vez de -v
• Empregue nomenclatura consistente: snake_case para funções/variáveis, UPPER_CASE para constantes
• Adicione cabeçalhos de seção com blocos de comentários para organizar funções relacionadas
• Mantenha funções com menos de 50 linhas; refatore funções maiores em componentes menores
• Agrupe funções relacionadas com cabeçalhos de seção descritivos
• Use nomes de função descritivos que expliquem o propósito: validate_input_file não check_file
• Adicione comentários inline para lógica não óbvia, evite declarar o óbvio
• Mantenha indentação consistente (2 ou 4 espaços, nunca tabs misturados com espaços)
• Coloque chaves de abertura na mesma linha para consistência: function_name() {
• Use linhas em branco para separar blocos lógicos dentro das funções
• Documente parâmetros e valores de retorno das funções em comentários de cabeçalho
• Extraia números mágicos e strings para constantes nomeadas no topo do script

Padrões de Segurança e Proteção

…