CommunitySchreiben & Editierengithub.com

Jamie-BitFlight/bash-portability

Diese Fähigkeit sollte verwendet werden, wenn der Benutzer nach „POSIX-Kompatibilität“, „portablen Shell-Skripten“, „shellübergreifender Kompatibilität“, „Bashismen“, „Shebang-Auswahl“ fragt oder wenn er Skripte erwähnt, die auf verschiedenen Shells (bash, sh, dash, zsh) oder Systemen funktionieren.

Was ist bash-portability?

Dieses Skill dient als umfassender Leitfaden für Entwickler und KI-Agenten, die portable Shell-Skripte schreiben möchten. Es behandelt die grundlegende Entscheidung zwischen der Verwendung von rein POSIX-kompatiblen Konstrukten (maximale Portabilität, z. B. mit `/bin/sh`) und der Nutzung von Bash-spezifischen Funktionen wie `[[ ]]`, Arrays oder `<<<`. Das Skill enthält eine detaillierte Matrix, die gegenüberstellt, welche Funktionen in POSIX verfügbar sind und welche nur in Bash (z. B. `${var,,}`). Es zeigt konkrete, portierbare Alternativen für typische Aufgaben wie Bedingungsabfragen (`[ ]` statt `[[ ]]`), Zeichenkettenumwandlung (`tr` statt `${var,,}`) und das Lesen von Dateien. Zusätzlich werden häufige Fallstricke wie das Verhalten von `echo` vs. `printf` oder die korrekte Syntax von Variablenzuweisungen erläutert. Ein Entscheidungsleitfaden hilft dabei, je nach Zielsystem (containers, embedded, systemd) die richtige Shell-Strategie zu wählen. Das Skill ist plattformunabhängig und für alle Shell-Umgebungen (CLI-Agenten, Cursor, Claude Code, Codex, etc.) geeignet.

Funktioniert mit~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 Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Bash-Portabilität

Anleitung zum Schreiben portabler POSIX-kompatibler Skripte und zur Entscheidung, wann Bash-spezifische Funktionen eingesetzt werden sollten.

Shebang-Auswahl

#!/usr/bin/env bash für Bash-Skripte verwenden

#!/usr/bin/env bash

Warum: Durchsucht den PATH nach bash und funktioniert systemübergreifend, auch wenn bash in unterschiedlichen Verzeichnissen installiert ist.

#!/bin/sh für POSIX-Skripte verwenden

#!/bin/sh

Warum: Maximale Portabilität, wenn Bash-Funktionen nicht benötigt werden. Auf vielen Systemen ist /bin/sh dash oder eine andere POSIX-Shell.

Direkter Pfad, wenn erforderlich

#!/bin/bash

Nur verwenden, wenn: Systemanforderungen den Bash-Speicherort garantieren oder Sicherheitsrichtlinien absolute Pfade vorschreiben.

POSIX- vs. Bash-Funktionsmatrix

FeaturePOSIXBashEmpfehlung
[[ ]]NeinJaFür POSIX [ ] verwenden
(( ))NeinJa[ ] mit -eq usw. verwenden
ArraysNeinJaPositionsparameter oder Dateien
localTeilw.JaIm Allgemeinen sicher
${var,,}Nein4+Für POSIX tr verwenden
<<<NeinJaecho verwenden
=~ (Regex)NeinJagrep oder expr verwenden
sourceNeinJa. (Punkt) Befehl verwenden
function f()NeinJaNur f() verwenden
$'...'NeinJaprintf verwenden
{1..10}NeinJaseq oder while-Schleife nutzen

POSIX-kompatible Muster

Bedingungen

# POSIX – [ ] mit korrekten Anführungszeichen verwenden
if [ -f "$file" ]; then
    echo "Datei existiert"
fi

# Zeichenkettenvergleich
if [ "$var" = "value" ]; then
    echo "Übereinstimmung"
fi

# Numerischer Vergleich
if [ "$num" -gt 10 ]; then
    echo "Größer"
fi

# Zusammengesetzte Bedingungen
if [ -f "$file" ] && [ -r "$file" ]; then
    echo "Lesbare Datei"
fi

Groß-/Kleinschreibung umwandeln (POSIX)

# Kleinschreibung
klein=$(echo "$zeichenkette" | tr '[:upper:]' '[:lower:]')

# Großschreibung
gross=$(echo "$zeichenkette" | tr '[:lower:]' '[:upper:]')

Teilzeichenketten-Operationen (POSIX)

# Teilzeichenkette extrahieren – expr oder cut verwenden
substr=$(expr "$zeichenkette" : '.\{3\}\(.\{5\}\)')  # Zeichen 4–8
substr=$(echo "$zeichenkette" | cut -c4-8)

# Zeichenkettenlänge
laenge=$(expr length "$zeichenkette")
laenge=${#zeichenkette}  # Dies ist tatsächlich POSIX-konform

Dateien lesen (POSIX)

# Zeile für Zeile
while IFS= read -r zeile; do
    echo "$zeile"
done < "$datei"

# Ganze Datei lesen (ohne cat)
inhalt=$(cat "$datei")  # cat ist POSIX-konform

Befehlssubstitution

# Moderne Syntax (auch in POSIX bevorzugt)
ergebnis=$(befehl)

# Veraltete Syntax (vermeiden)
ergebnis=`befehl`

# Verschachtelt (daher ist die moderne besser)
ergebnis=$(echo $(datum))      # Klar
ergebnis=`echo \`datum\``      # Escape-Albtraum

Bash-spezifische Funktionen, die sich lohnen

Wenn Portabilität nicht erforderlich ist, verbessern diese Bash-Funktionen die Codequalität:

Erweiterter Test [[ ]]

# Mustervergleich
[[ "$datei" == *.txt ]]

# Regex-Vergleich
[[ "$eingabe" =~ ^[0-9]+$ ]]

# Keine Sorgen um Worttrennung
[[ -f $datei ]]  # Anführungszeichen optional (aber weiterhin empfohlen)

# Logische Operatoren innerhalb
[[ -f "$datei" && -r "$datei" ]]

Arrays

# Indizierte Arrays
declare -a dateien=()
dateien+=("eins.txt")
dateien+=("zwei.txt")
for f in "${dateien[@]}"; do
    verarbeite "$f"
done

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

Parametererweiterung

# Standardwert
"${var:-default}"

# Groß-/Kleinschreibung umwandeln (Bash 4+)
"${var,,}"  # Kleinschreibung
"${var^^}"  # Großschreibung

# Teilzeichenkette
"${var:0:10}"  # erste 10 Zeichen
"${var: -5}"   # letzte 5 Zeichen

# Suchen/Ersetzen
"${var//alt/neu}"

Here-Strings

# Bash
read -r var <<< "Eingabezeichenkette"

# POSIX-Äquivalent
var=$(echo "Eingabezeichenkette")

Prozesssubstitution

# Bash – zwei Befehlsausgaben vergleichen
diff <(sort datei1) <(sort datei2)

# POSIX-Äquivalent (mit temporären Dateien)
sort datei1 > /tmp/sortiert1
sort datei2 > /tmp/sortiert2
diff /tmp/sortiert1 /tmp/sortiert2

Shell-Typ erkennen

# Prüfen, ob in Bash ausgeführt wird
if [ -n "${BASH_VERSION:-}" ]; then
    echo "Läuft in Bash"
fi

# Bash-Version für Funktionen prüfen
if [ "${BASH_VERSINFO[0]:-0}" -ge 4 ]; then
    echo "Bash 4+ verfügbar"
fi

# Generische Shell-Erkennung
case "${SHELL##*/}" in
    bash) echo "bash" ;;
    zsh)  echo "zsh" ;;
    *)    echo "andere" ;;
esac

Portable Hilfsfunktionen

Codebeispiele

Entscheidungsleitfaden zur Portabilität

POSIX verwenden, wenn:

  • Skript auf minimalistischen Systemen läuft (Container, eingebettete Systeme)
  • Das Zielsystem dash, ash oder busybox sh enthält
  • Maximale Kompatibilität erforderlich ist
  • Das Skript Teil der Systeminitialisierung ist

Bash verwenden, wenn:

  • Zielsysteme garantiert bash enthalten
  • Arrays, assoziative Arrays oder Regex benötigt werden
  • Komplexe Zeichenkettenmanipulation erforderlich ist
  • Die Codeklarheit erheblich verbessert wird
  • Interaktive Funktionen benötigt werden

Häufige Portabilitätsfallen

echo vs. printf

# Problematisch – Verhalten variiert
echo -n "kein Zeilenumbruch"
echo -e "mit\tTabulatoren"

# Portabel
printf '%s' "kein Zeilenumbruch"
printf 'mit\tTabulatoren\n'

Variablenzuweisung

# Funktioniert überall
var="wert"

# Kann bei manchen Shells fehlschlagen
var = "wert"  # Leerzeichen um = sind falsch

Export mit Zuweisung

# POSIX – getrennte Befehle
var="wert"
export var

# Bash/modern – kombiniert (funktioniert meistens)
export var="wert"

Array-ähnliche Operationen ohne Arrays

# Positionsparameter verwenden
set -- "eintrag1" "eintrag2" "eintrag3"
for eintrag in "$@"; do
    echo "$eintrag"
done

# Oder IFS-basiertes Aufteilen
eintraege="eintrag1:eintrag2:eintrag3"
IFS=':' read -r eintrag1 eintrag2 eintrag3 <<EOF
$eintraege
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).

Verwandte Skills