CommunityRedacción y edicióngithub.com

James-BitFlight/bash-portabilidad

Esta habilidad debe usarse cuando el usuario pregunte sobre 'compatibilidad POSIX', 'scripts shell portables', 'compatibilidad entre shells', 'bashismos', 'selección de shebang' o mencionar escribir scripts que funcionen en diferentes shells (bash, sh, dash, zsh) o diferentes sistemas.

¿Qué es bash-portabilidad?

Esta habilidad (skill) para asistentes de codificación como Claude Code, Cursor o Codex proporciona una guía completa para escribir scripts de shell portables, centrándose en la compatibilidad POSIX frente a las características específicas de Bash. Es útil para desarrolladores que necesitan scripts que funcionen de manera confiable en múltiples shells (bash, sh, dash, zsh) y en diversos sistemas, desde contenedores minimalistas hasta entornos de escritorio completos. El skill cubre la selección de shebang (#!/usr/bin/env bash frente a #!/bin/sh), una matriz detallada de características POSIX vs Bash (por ejemplo, [[ ]] frente a [ ], arrays, local, <<<, ${var,,}), y proporciona ejemplos de código POSIX para condicionales, conversión de mayúsculas/minúsculas, operaciones de subcadenas y lectura de archivos. También recomienda cuándo utilizar funciones específicas de Bash que mejoran la calidad del código (arrays, expansión de parámetros, sustitución de procesos) y advierte sobre trampas comunes de portabilidad como echo vs printf o la asignación de variables con export. La guía de decisión ayuda a elegir entre POSIX y Bash según el entorno objetivo y los requisitos del script.

Compatible con~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 Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Portabilidad Bash

Guía para escribir scripts portables compatibles con POSIX y comprender cuándo aprovechar las características específicas de Bash.

Selección de Shebang

Usar #!/usr/bin/env bash para Scripts Bash

#!/usr/bin/env bash

Por qué: Busca bash en el PATH, funciona en sistemas donde bash puede estar en diferentes ubicaciones.

Usar #!/bin/sh para Scripts POSIX

#!/bin/sh

Por qué: Máxima portabilidad cuando no se necesitan características de Bash. En muchos sistemas, /bin/sh es dash u otro shell POSIX.

Ruta Directa Cuando Sea Necesario

#!/bin/bash

Usar solo cuando: Los requisitos del sistema garanticen la ubicación de bash, o la política de seguridad exija rutas absolutas.

Matriz de Características POSIX vs Bash

CaracterísticaPOSIXBashRecomendación
[[ ]]NoSíUsar [ ] para POSIX
(( ))NoSíUsar [ ] con -eq, etc.
ArraysNoSíUsar parámetros posicionales o archivos
localParcialSíGeneralmente seguro
${var,,}No4+Usar tr para POSIX
<<<NoSíUsar `echo
=~ regexNoSíUsar grep o expr
sourceNoSíUsar el comando . (punto)
function f()NoSíUsar solo f()
$'...'NoSíUsar printf
{1..10}NoSíUsar seq o bucle while

Patrones Compatibles con POSIX

Condicionales

# POSIX - usar [ ] con comillas adecuadas
if [ -f "$file" ]; then
    echo "El archivo existe"
fi

# Comparación de cadenas
if [ "$var" = "valor" ]; then
    echo "Coincidencia"
fi

# Comparación numérica
if [ "$num" -gt 10 ]; then
    echo "Mayor"
fi

# Condiciones compuestas
if [ -f "$file" ] && [ -r "$file" ]; then
    echo "Archivo legible"
fi

Conversión de Mayúsculas/Minúsculas (POSIX)

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

# Mayúsculas
mayusculas=$(echo "$cadena" | tr '[:lower:]' '[:upper:]')

Operaciones con Subcadenas (POSIX)

# Obtener subcadena - usar expr o cut
subcadena=$(expr "$cadena" : '.\{3\}\(.\{5\}\)')  # caracteres 4-8
subcadena=$(echo "$cadena" | cut -c4-8)

# Longitud de cadena
longitud=$(expr length "$cadena")
longitud=${#cadena}  # Esto en realidad es POSIX

Lectura de Archivos (POSIX)

# Línea por línea
while IFS= read -r linea; do
    echo "$linea"
done < "$archivo"

# Leer archivo completo (sin cat)
contenido=$(cat "$archivo")  # cat es POSIX

Sustitución de Comandos

# Sintaxis moderna (preferida incluso en POSIX)
resultado=$(comando)

# Sintaxis heredada (evitar)
resultado=`comando`

# Anidada (por qué la moderna es mejor)
resultado=$(echo $(date))      # Claro
resultado=`echo \`date\``      # Pesadilla de escapes

Características Específicas de Bash Que Vale la Pena Usar

Cuando la portabilidad no es necesaria, estas características de Bash mejoran la calidad del código:

Test Extendido [[ ]]

# Coincidencia de patrones
[[ "$archivo" == *.txt ]]

# Coincidencia regex
[[ "$entrada" =~ ^[0-9]+$ ]]

# Sin preocupaciones por división de palabras
[[ -f $archivo ]]  # Las comillas son opcionales (pero aún recomendadas)

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

Arrays

# Arrays indexados
declare -a archivos=()
archivos+=("uno.txt")
archivos+=("dos.txt")
for f in "${archivos[@]}"; do
    procesar "$f"
done

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

Expansión de Parámetros

# Valor por defecto
"${var:-predeterminado}"

# Conversión de mayúsculas/minúsculas (Bash 4+)
"${var,,}"  # minúsculas
"${var^^}"  # mayúsculas

# Subcadena
"${var:0:10}"  # primeros 10 caracteres
"${var: -5}"   # últimos 5 caracteres

# Buscar/reemplazar
"${var//antiguo/nuevo}"

Here Strings

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

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

Sustitución de Procesos

# Bash - comparar dos salidas de comandos
diff <(sort archivo1) <(sort archivo2)

# Equivalente POSIX (con archivos temporales)
sort archivo1 > /tmp/ordenado1
sort archivo2 > /tmp/ordenado2
diff /tmp/ordenado1 /tmp/ordenado2

Detección del Tipo de Shell

# Verificar si se ejecuta en bash
if [ -n "${BASH_VERSION:-}" ]; then
    echo "Ejecutando en Bash"
fi

# Verificar la versión de bash para características
if [ "${BASH_VERSINFO[0]:-0}" -ge 4 ]; then
    echo "Bash 4+ disponible"
fi

# Detección genérica de shell
case "${SHELL##*/}" in
    bash) echo "bash" ;;
    zsh)  echo "zsh" ;;
    *)    echo "otro" ;;
esac

Funciones de Utilidad Portables

Ejemplos de código

Guía de Decisión de Portabilidad

Usar POSIX cuando:

  • El script se ejecuta en sistemas minimalistas (contenedores, embebidos)
  • El destino incluye dash, ash o busybox sh
  • Se requiere máxima compatibilidad
  • El script es parte de la inicialización del sistema

Usar Bash cuando:

  • Se garantiza que los sistemas destino tienen bash
  • Se necesitan arrays, arrays asociativos o regex
  • Se requiere manipulación compleja de cadenas
  • La claridad del código mejora significativamente
  • Se necesitan características interactivas

Trampas Comunes de Portabilidad

echo vs printf

# Problemático - el comportamiento varía
echo -n "sin nueva línea"
echo -e "con\tabuladores"

# Portable
printf '%s' "sin nueva línea"
printf 'con\tabuladores\n'

Asignación de Variables

# Funciona en todas partes
var="valor"

# Puede fallar en algunos shells
var = "valor"  # Los espacios alrededor de = son incorrectos

Exportar con Asignación

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

# Bash/moderno - combinado (funciona en la mayoría de los lugares)
export var="valor"

Operaciones Similares a Arrays Sin Arrays

# Usar parámetros posicionales
set -- "elemento1" "elemento2" "elemento3"
for elemento in "$@"; do
    echo "$elemento"
done

# O división basada en IFS
elementos="elemento1:elemento2:elemento3"
IFS=':' read -r elem1 elem2 elem3 <<EOF
$elementos
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).

Skills relacionados