Fluxo de Trabalho de Script Bash

Visão Geral

Fluxo de trabalho especializado para criar scripts bash robustos e prontos para produção com padrões de programação defensiva, tratamento abrangente de erros e testes automatizados.

Quando Usar Este Fluxo de Trabalho

Use este fluxo de trabalho quando:

• Criar scripts de automação
• Escrever ferramentas de administração de sistemas
• Construir scripts de implantação
• Desenvolver soluções de backup
• Criar scripts de CI/CD

Escopo e Execução

Escolha as fases que correspondem à tarefa do usuário; este documento é um índice, não uma instrução para executar todas as habilidades listadas. Leia uma habilidade selecionada antes de usá-la. Respeite as restrições do repositório e do usuário. Chamadas na nuvem, configuração de host, publicação, operações destrutivas e gastos exigem autorização aplicável; um checklist de fluxo de trabalho não a concede.

O modelo é um ponto de partida, não um script completo: ele não implementa análise de argumentos ou rollback. Valide caminhos, coloque expansões entre aspas, teste em um diretório descartável e torne as tentativas limitadas e seguras para o comando específico. Nunca registre credenciais ou implique que o modo estrito captura todas as falhas.

Fases do Fluxo de Trabalho

Fase 1: Design do Script

Habilidades a Invocar

• bash-pro - Script profissional
• bash-defensive-patterns - Padrões defensivos

Ações

1. Definir o propósito do script
2. Identificar entradas/saídas
3. Planejar o tratamento de erros
4. Projetar a estratégia de log
5. Documentar os requisitos

Prompts de Copiar e Colar

Use @bash-pro to design production-ready bash script

Fase 2: Estrutura do Script

Habilidades a Invocar

• bash-pro - Estrutura de script
• bash-defensive-patterns - Padrões de segurança

Ações

1. Adicionar shebang e modo estrito
2. Criar função de uso
3. Implementar análise de argumentos
4. Configurar o log
5. Adicionar manipuladores de limpeza

Prompts de Copiar e Colar

Use @bash-defensive-patterns to implement strict mode and error handling

Fase 3: Implementação Principal

Habilidades a Invocar

• bash-linux - Comandos Linux
• linux-shell-scripting - Scripting Shell

Ações

1. Implementar funções principais
2. Adicionar validação de entrada
3. Criar funções auxiliares
4. Lidar com casos extremos
5. Adicionar indicadores de progresso

Prompts de Copiar e Colar

Use @bash-linux to implement system commands

Fase 4: Tratamento de Erros

Habilidades a Invocar

• bash-defensive-patterns - Tratamento de erros
• error-handling-patterns - Padrões de erro

Ações

1. Adicionar manipuladores de trap
2. Implementar lógica de tentativa
3. Criar mensagens de erro
4. Configurar códigos de saída
5. Adicionar capacidade de rollback

Prompts de Copiar e Colar

Use @bash-defensive-patterns to add comprehensive error handling

Fase 5: Log

Habilidades a Invocar

• bash-pro - Padrões de log

Ações

1. Criar função de log
2. Adicionar níveis de log
3. Implementar timestamps
4. Configurar rotação de log
5. Adicionar modo de depuração

Prompts de Copiar e Colar

Use @bash-pro to implement structured logging

Fase 6: Testes

Habilidades a Invocar

• bats-testing-patterns - Testes Bats
• shellcheck-configuration - ShellCheck

Ações

1. Escrever testes Bats
2. Executar ShellCheck
3. Testar casos extremos
4. Verificar tratamento de erros
5. Testar com diferentes entradas

Prompts de Copiar e Colar

Use @bats-testing-patterns to write script tests

Use @shellcheck-configuration to lint bash script

Fase 7: Documentação

Habilidades a Invocar

• documentation-templates - Documentação

Ações

1. Adicionar cabeçalho do script
2. Documentar funções
3. Criar exemplos de uso
4. Listar dependências
5. Adicionar seção de solução de problemas

Prompts de Copiar e Colar

Use @documentation-templates to document bash script

Modelo de Script

#!/usr/bin/env bash
set -euo pipefail

SCRIPT_NAME=$(basename -- "$0")
readonly SCRIPT_NAME
SCRIPT_DIR=$(cd -- "$(dirname -- "$0")" && pwd)
readonly SCRIPT_DIR

log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"; }
error() { log "ERROR: $*" >&2; exit 1; }

usage() { cat <<EOF
Usage: $SCRIPT_NAME [OPTIONS]
Options:
    -h, --help      Show help
    -v, --verbose   Verbose output
EOF
}

main() {
    log "Script started"
    # Implementation
    log "Script completed"
}

main "$@"

Portões de Qualidade

• ShellCheck passa
• Testes Bats passam
• Tratamento de erros funciona
• Log funcional
• Documentação completa

Pacotes de Fluxo de Trabalho Relacionados

• os-scripting - Scripting de SO
• linux-troubleshooting - Solução de problemas Linux
• cloud-devops - Automação DevOps

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.

…