CommunityEscrita e Ediçãogithub.com

Jamie-BitFlight/portabilidade-bash

Esta habilidade deve ser usada quando o usuário perguntar sobre compatibilidade POSIX, scripts portáteis, compatibilidade entre shells, bashismos, seleção de shebang ou mencionar a criação de scripts que funcionam em diferentes shells (bash, sh, dash, zsh) ou sistemas.

O que é portabilidade-bash?

A habilidade 'Bash Portability' fornece orientação abrangente para escrever scripts compatíveis com POSIX que funcionam de forma consistente em vários shells Unix (bash, sh, dash, zsh) e sistemas operacionais. É útil para desenvolvedores que precisam garantir que seus scripts possam ser executados em ambientes mínimos (contêineres, sistemas embarcados) ou que desejam aproveitar recursos específicos do bash quando a portabilidade não é uma preocupação. A habilidade documenta a seleção de shebang adequada (#!/usr/bin/env bash, #!/bin/sh, #!/bin/bash) com base nos requisitos do sistema, fornece uma matriz de comparação de recursos entre POSIX e bash, e mostra padrões portáteis para condicionais, conversão de caso, operações de substring e muito mais. Ela também descreve recursos específicos do bash que melhoram a qualidade do código ([[ ]], arrays, expansão de parâmetros, here strings, substituição de processo) e auxilia na detecção do tipo de shell para evitar armadilhas comuns de portabilidade.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/bash-development/skills/bash-portability

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Portabilidade Bash

Orientações para escrever scripts portáteis e compatíveis com POSIX e entender quando usar recursos específicos do bash.

Seleção de Shebang

Use #!/usr/bin/env bash para scripts Bash

#!/usr/bin/env bash

Por quê: Busca bash no PATH, funciona em sistemas onde o bash pode estar em locais diferentes.

Use #!/bin/sh para scripts POSIX

#!/bin/sh

Por quê: Portabilidade máxima quando recursos do bash não são necessários. Em muitos sistemas, /bin/sh é dash ou outro shell POSIX.

Caminho direto quando necessário

#!/bin/bash

Use apenas quando: Requisitos do sistema garantem o local do bash ou a política de segurança exige caminhos absolutos.

Matriz de recursos POSIX vs Bash

RecursoPOSIXBashRecomendação
[[ ]]NãoSimUse [ ] para POSIX
(( ))NãoSimUse [ ] com -eq etc.
ArraysNãoSimUse parâmetros posicionais ou arquivos
localParcialSimGeralmente seguro
${var,,}Não4+Use tr para POSIX
<<<NãoSimUse `echo
=~ regexNãoSimUse grep ou expr
sourceNãoSimUse . (comando ponto)
function f()NãoSimUse apenas f()
$'...'NãoSimUse printf
{1..10}NãoSimUse seq ou loop while

Padrões compatíveis com POSIX

Condicionais

# POSIX - use [ ] com aspas adequadas
if [ -f "$file" ]; then
    echo "Arquivo existe"
fi

# Comparação de strings
if [ "$var" = "value" ]; then
    echo "Correspondência"
fi

# Comparação numérica
if [ "$num" -gt 10 ]; then
    echo "Maior"
fi

# Condições compostas
if [ -f "$file" ] && [ -r "$file" ]; then
    echo "Arquivo legível"
fi

Conversão de maiúsculas/minúsculas (POSIX)

# Minúsculas
minusculo=$(echo "$string" | tr '[:upper:]' '[:lower:]')

# Maiúsculas
maiusculo=$(echo "$string" | tr '[:lower:]' '[:upper:]')

Operações de substring (POSIX)

# Obter substring - use expr ou cut
substr=$(expr "$string" : '.\{3\}\(.\{5\}\)')  # caracteres 4-8
substr=$(echo "$string" | cut -c4-8)

# Comprimento da string
length=$(expr length "$string")
length=${#string}  # Isso é, na verdade, POSIX

Leitura de arquivos (POSIX)

# Linha por linha
while IFS= read -r line; do
    echo "$line"
done < "$file"

# Ler arquivo inteiro (sem cat)
content=$(cat "$file")  # cat é POSIX

Substituição de comando

# Sintaxe moderna (preferida mesmo em POSIX)
result=$(comando)

# Sintaxe legada (evitar)
result=`comando`

# Aninhamento (por que a moderna é melhor)
result=$(echo $(date))      # Claro
result=`echo \`date\``      # Pesadelo de escapamento

Recursos específicos do Bash que valem a pena usar

Quando a portabilidade não é necessária, esses recursos do bash melhoram a qualidade do código:

Teste estendido [[ ]]

# Correspondência de padrão
[[ "$file" == *.txt ]]

# Correspondência de regex
[[ "$input" =~ ^[0-9]+$ ]]

# Sem preocupações com divisão de palavras
[[ -f $file ]]  # Aspas opcionais (ainda recomendado)

# Operadores lógicos internos
[[ -f "$file" && -r "$file" ]]

Arrays

# Arrays indexados
declare -a files=()
files+=("um.txt")
files+=("dois.txt")
for f in "${files[@]}"; do
    process "$f"
done

# Arrays associativos (Bash 4+)
declare -A config
config[host]="localhost"
config[port]="8080"

Expansão de parâmetros

# Valor padrão
"${var:-default}"

# Conversão de maiúsculas/minúsculas (Bash 4+)
"${var,,}"  # minúsculas
"${var^^}"  # maiúsculas

# Substring
"${var:0:10}"  # primeiros 10 caracteres
"${var: -5}"   # últimos 5 caracteres

# Busca/substituição
"${var//old/new}"

Here Strings

# Bash
read -r var <<< "string de entrada"

# Equivalente POSIX
var=$(echo "string de entrada")

Substituição de processo

# Bash - comparar duas saídas de comando
diff <(sort arquivo1) <(sort arquivo2)

# Equivalente POSIX (com arquivos temporários)
sort arquivo1 > /tmp/ordenado1
sort arquivo2 > /tmp/ordenado2
diff /tmp/ordenado1 /tmp/ordenado2

Detectando o tipo de shell

# Verificar se está rodando no bash
if [ -n "${BASH_VERSION:-}" ]; then
    echo "Rodando no Bash"
fi

# Verificar versão do bash para recursos
if [ "${BASH_VERSINFO[0]:-0}" -ge 4 ]; then
    echo "Bash 4+ disponível"
fi

# Detecção genérica de shell
case "${SHELL##*/}" in
    bash) echo "bash" ;;
    zsh)  echo "zsh" ;;
    *)    echo "outro" ;;
esac

Funções utilitárias portáteis

Exemplos de código

Guia de decisão de portabilidade

Use POSIX quando:

  • O script roda em sistemas mínimos (contêineres, embarcados)
  • O destino inclui dash, ash ou busybox sh
  • Compatibilidade máxima é necessária
  • O script faz parte da inicialização do sistema

Use Bash quando:

  • Os sistemas de destino têm garantia de ter bash
  • Arrays, arrays associativos ou regex são necessários
  • Manipulação complexa de strings é necessária
  • Clareza do código é significativamente melhorada
  • Recursos interativos são necessários

Armadilhas comuns de portabilidade

echo vs printf

# Problemático - comportamento varia
echo -n "sem nova linha"
echo -e "com\ttabs"

# Portátil
printf '%s' "sem nova linha"
printf 'com\ttabs\n'

Atribuição de variável

# Funciona em todos os lugares
var="valor"

# Pode falhar em alguns shells
var = "valor"  # Espaços ao redor de = estão errados

Export com atribuição

# POSIX - comandos separados
var="valor"
export var

# Bash/moderno - combinado (funciona na maioria dos lugares)
export var="valor"

Operações semelhantes a arrays sem arrays

# Use parâmetros posicionais
set -- "item1" "item2" "item3"
for item in "$@"; do
    echo "$item"
done

# Ou divisão baseada em IFS
items="item1:item2:item3"
IFS=':' read -r item1 item2 item3 <<EOF
$items
EOF

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Jamie-BitFlight/agentskill-kaizen-meta-docs

Agentskill kaizen plugin documentation index. Load when needing to read about cross-platform notes, improvement plans, or DuckDB integration.

Jamie-BitFlight/bash-51-features

Bash 5.1 release features and improvements with practical examples. Use when working with Bash 5.1 features, epoch time variables, redirection enhancements, or when user asks about Bash 5.1 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-52-features

Bash 5.2 release features and improvements with practical examples. Use when working with Bash 5.2 features, variable handling enhancements, readline improvements, or when user asks about Bash 5.2 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-53-features

Bash 5.3 release features and improvements with practical examples. Use when working with Bash 5.3 features, new command substitution, GLOBSORT, loadable builtins, or when user asks about Bash 5.3 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-development

This skill should be used when the user asks to "write a bash script", "create a shell script", "implement bash function", "parse arguments in bash", "handle errors in bash", or mentions bash development, shell scripting, script templates, or modern bash patterns.

Jamie-BitFlight/bash-lint

This skill should be used when the user asks to "lint bash script", "run shellcheck", "format shell script", "use shfmt", "fix shellcheck errors", or mentions shell script linting, formatting, code quality, or pre-commit hooks for bash.

Jamie-BitFlight/bash-logging

This skill should be used when the user asks to "add logging to bash script", "colorize output", "implement log levels", "CI/CD sections", "terminal colors in bash", or mentions logging functions, emoji output, collapsible CI sections, or shlocksmith.

Jamie-BitFlight/bash-testing

This skill should be used when the user asks to "test bash script", "write shell tests", "use shunit2", "use shellspec", "create test suite for bash", or mentions unit testing, test frameworks, mocking, or test-driven development for shell scripts.

Jamie-BitFlight/brainstorming-skill

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using research-validated prompt patterns.

Jamie-BitFlight/clang-format

Configure clang-format code formatting. Use when: user mentions clang-format or .clang-format, analyzing code style/patterns, creating/modifying formatting config, troubleshooting formatting, brace styles/indentation/spacing/alignment/pointer alignment, or codifying conventions.

Jamie-BitFlight/commitlint

When setting up commit message validation for a project. When project has commitlint.config.js or .commitlintrc files. When configuring CI/CD to enforce commit format. When extracting commit rules for LLM prompt generation. When debugging commit message rejection errors.

Jamie-BitFlight/conventional-commits

When writing a git commit message. When task completes and changes need committing. When project uses semantic-release, commitizen, git-cliff. When choosing between feat/fix/chore/docs types. When indicating breaking changes. When generating changelogs from commit history.

Jamie-BitFlight/dasel-reference

Use when querying, modifying, or converting JSON, YAML, TOML, XML, CSV, HCL, or INI with dasel v3. Complete reference for selectors, functions, conditionals, variables, spread operator, type casting, and format-specific patterns.

Jamie-BitFlight/data-exploration

Use when exploring unknown structured data files with dasel v3 — discover schema, list keys, find nested values, sample arrays, identify data types across JSON, YAML, TOML, XML, CSV, HCL, INI formats

Jamie-BitFlight/data-transformation

Use when modifying, converting, or transforming structured data with dasel v3 — in-place mutations, format conversion, batch operations, array manipulation, object construction, and merge patterns across JSON, YAML, TOML, XML, CSV, HCL, INI

Jamie-BitFlight/delegate

Decompose substantive work into phases, dispatch each phase to a sub-agent, and adjudicate what comes back. Use whenever a request asks for implementation, investigation, a fix, a review, or any change to files — including small ones — and whenever you are about to read source or run a diagnostic yourself instead of handing it off. Also use when a report from a sub-agent needs judging, when a phase needs re-dispatching, or when a user names one instance of a pattern. Does not apply when your own prompt begins "Your ROLE_TYPE is sub-agent." — then follow references/sub-agent-contract.md instead.

Jamie-BitFlight/enterprise-hibernate-hbm

Dasel v3 query patterns for Hibernate .hbm.xml mapping files — entity-table binding, Java property-to-column extraction, one-to-many set/list/bag relationship tracing, many-to-one foreign key discovery, batch scanning across 60+ HBM files. Use when querying Hibernate ORM class mappings, extracting schema metadata from Java persistence layer, or auditing entity-column relationships in enterprise legacy codebases.

Jamie-BitFlight/enterprise-installanywhere

Dasel v3 query patterns for InstallAnywhere .iap_xml installer definitions — use when querying action sequences, discovering variables, resolving platform conditions, navigating panels, or comparing installer variants. Files are 2.5+ MB, 65,000+ lines — too large for context reads, requires structural dasel queries.

Jamie-BitFlight/enterprise-maven-pom

Dasel v3 selector patterns for Maven POM XML files — use when querying dependency versions, filtering by groupId or scope, extracting module hierarchy from parent POMs, or detecting version conflicts across enterprise multi-module Java projects. Load this skill when working with pom.xml files using dasel.

Jamie-BitFlight/enterprise-spring-xml

Dasel v3 selectors for Spring bean factory XML — use when querying any Spring ApplicationContext XML for bean discovery, dependency wiring, JMS destination mapping, property injection extraction, or cross-bean reference tracing. Load this skill before writing dasel selectors against Spring bean XML files (applicationContext.xml, *_beans.xml, spring-*.xml).

Habilidades Relacionadas