Pacote de Fluxo de Trabalho para Solução de Problemas de OS/Shell Scripting

Visão Geral

Fluxo de trabalho abrangente para solução de problemas de sistema operacional, shell scripting e administração de sistemas em Linux, macOS e Windows. Este pacote orquestra habilidades para depurar problemas do sistema, criar scripts robustos e automatizar tarefas administrativas.

Quando Usar Este Fluxo de Trabalho

Use este fluxo de trabalho quando:

• Depurar erros de shell script
• Criar scripts bash prontos para produção
• Solucionar problemas do sistema
• Automatizar tarefas de administração do sistema
• Gerenciar processos e serviços
• Configurar recursos do sistema

Fases do Fluxo de Trabalho

Fase 1: Avaliação do Ambiente

Habilidades a Invocar

• bash-linux - Padrões bash do Linux
• bash-pro - Scripting bash profissional
• bash-defensive-patterns - Scripting defensivo

Ações

1. Identificar o sistema operacional e a versão
2. Verificar ferramentas e comandos disponíveis
3. Verificar permissões e acesso
4. Avaliar recursos do sistema
5. Revisar logs e mensagens de erro

Comandos de Diagnóstico

# System information
uname -a
cat /etc/os-release
hostnamectl

# Resource usage
top
htop
df -h
free -m

# Process information
ps aux
pgrep -f pattern
lsof -i :port

# Network status
netstat -tulpn
ss -tulpn
ip addr show

Prompts de Copiar e Colar

Use @bash-linux to diagnose system performance issues

Fase 2: Análise de Script

Habilidades a Invocar

• bash-defensive-patterns - Scripting defensivo
• shellcheck-configuration - Linting com ShellCheck
• bats-testing-patterns - Testes com Bats

Ações

1. Executar ShellCheck para linting
2. Analisar a estrutura do script
3. Identificar problemas potenciais
4. Verificar tratamento de erros
5. Verificar uso de variáveis

Uso do ShellCheck

# Install ShellCheck
sudo apt install shellcheck  # Debian/Ubuntu
brew install shellcheck      # macOS

# Run ShellCheck
shellcheck script.sh
shellcheck -f gcc script.sh

# Fix common issues
# - Use quotes around variables
# - Check exit codes
# - Handle errors properly

Prompts de Copiar e Colar

Use @shellcheck-configuration to lint and fix shell scripts

Fase 3: Depuração

Habilidades a Invocar

• systematic-debugging - Depuração sistemática
• debugger - Especialista em depuração
• error-detective - Detecção de padrões de erro

Ações

1. Habilitar modo de depuração
2. Adicionar instruções de log
3. Rastrear o fluxo de execução
4. Isolar seções com falha
5. Testar componentes individualmente

Técnicas de Depuração

# Enable debug mode
set -x  # Print commands
set -e  # Exit on error
set -u  # Exit on undefined variable
set -o pipefail  # Pipeline failure detection

# Add logging
log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >> /var/log/script.log
}

# Trap errors
trap 'echo "Error on line $LINENO"' ERR

# Test sections
bash -n script.sh  # Syntax check
bash -x script.sh  # Trace execution

Prompts de Copiar e Colar

Use @systematic-debugging to trace and fix shell script errors

Fase 4: Desenvolvimento de Script

Habilidades a Invocar

• bash-pro - Scripting profissional
• bash-defensive-patterns - Padrões defensivos
• linux-shell-scripting - Shell scripting

Ações

1. Projetar a estrutura do script
2. Implementar funções
3. Adicionar tratamento de erros
4. Incluir validação de entrada
5. Adicionar documentação de ajuda

Modelo de Script

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

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

# Logging
log() {
    local level="$1"
    shift
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [$level] $*" >&2
}

info() { log "INFO" "$@"; }
warn() { log "WARN" "$@"; }
error() { log "ERROR" "$@"; exit 1; }

# Usage
usage() {
    cat <<EOF
Usage: $SCRIPT_NAME [OPTIONS]

Options:
    -h, --help      Show this help message
    -v, --verbose   Enable verbose output
    -d, --debug     Enable debug mode

Examples:
    $SCRIPT_NAME --verbose
    $SCRIPT_NAME -d
EOF
}

# Main function
main() {
    local verbose=false
    local debug=false

    while [[ $# -gt 0 ]]; do
        case "$1" in
            -h|--help)
                usage
                exit 0
                ;;
            -v|--verbose)
                verbose=true
                shift
                ;;
            -d|--debug)
                debug=true
                set -x
                shift
                ;;
            *)
                error "Unknown option: $1"
                ;;
        esac
    done

    info "Script started"
    # Your code here
    info "Script completed"
}

main "$@"

…