CommunityRecherche & Datenanalysegithub.com

wshobson/shellcheck-configuration

Beherrschen Sie die Konfiguration und Nutzung von ShellCheck für die statische Analyse von Shell-Skripten zur Steigerung der Codequalität. Verwenden Sie dies beim Einrichten der Linting-Infrastruktur, Beheben von Code-Problemen oder Sicherstellen der Skript-Portabilität.

Was ist shellcheck-configuration?

Diese Fähigkeit bietet eine umfassende Anleitung zur Einrichtung und Nutzung von ShellCheck, einem leistungsstarken Tool zur statischen Analyse von Shell-Skripten. Sie hilft Entwicklern und KI-Agenten, konsistente Linting-Regeln zu definieren, häufige Fehlerquellen zu identifizieren und zu beheben sowie die Portabilität von Skripten über verschiedene Shell-Umgebungen hinweg sicherzustellen. Die Fähigkeit unterstützt plattformübergreifend die Integration in CI/CD-Pipelines und Editor-Umgebungen, indem sie klare Anweisungen zur Konfiguration von ShellCheck-Direktiven und zum Ignorieren spezifischer Warnungen gibt. Mit diesem Skill können Benutzer Code-Qualitätsstandards durchsetzen, Sicherheitslücken vermeiden und die Wartbarkeit von Shell-Skripten verbessern. Die Beschreibung umfasst bewährte Methoden zur Erstellung anpassbarer Konfigurationsdateien und zur Nutzung von ShellCheck-Optionen für verschiedene Szenarien, was zu einer effizienteren und fehlerfreieren Skriptentwicklung führt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wshobson/agents/tree/main/skills/shellcheck-configuration

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht shellcheck-configuration?

Beherrschen Sie die Konfiguration und Nutzung von ShellCheck für die statische Analyse von Shell-Skripten zur Steigerung der Codequalität. Verwenden Sie dies beim Einrichten der Linting-Infrastruktur, Beheben von Code-Problemen oder Sicherstellen der Skript-Portabilität.

Übersicht

ShellCheck ist ein Tool zur statischen Analyse von Shell-Skripten, das dazu beiträgt, häufige Fehler und unsichere Praktiken zu identifizieren. Diese Fähigkeit bietet eine umfassende Anleitung zur Konfiguration von ShellCheck für verschiedene Projektanforderungen.

Konfiguration

Grundlegende Einrichtung

  1. Installation: Stellen Sie sicher, dass ShellCheck in Ihrer Umgebung installiert ist.
  2. Konfigurationsdatei: Erstellen Sie eine .shellcheckrc-Datei im Stammverzeichnis Ihres Projekts.

Beispiel .shellcheckrc

# Diese Direktiven aktivieren bestimmte Prüfungen und deaktivieren andere
enable=all
# Deaktivieren Sie bestimmte Warnungen, die für Ihr Projekt irrelevant sind
#disable=SC2154,SC1091
# Setzen Sie die Shell auf bash, um bash-spezifische Prüfungen zu aktivieren
shell=bash
# Deaktivieren Sie Quellcodedateien, die nicht von ShellCheck überprüft werden sollen
external-sources=true

Verwendung

In der Kommandozeile

shellcheck mein_skript.sh

Mit spezifischen Optionen

shellcheck -s bash -P SCRIPTDIR mein_skript.sh
  • -s bash: Legt die Ziel-Shell fest
  • -P SCRIPTDIR: Fügt das Skriptverzeichnis zum Suchpfad für Quellcodedateien hinzu

Integration in CI/CD

Fügen Sie ShellCheck zu Ihrer CI/CD-Pipeline hinzu, um die Codequalität automatisch zu überprüfen.

Beispiel für GitHub Actions

- name: Führe ShellCheck aus
  uses: ludeeus/action-shellcheck@master
  with:
    # Optional: Legen Sie das zu überprüfende Verzeichnis fest
    scandir: './skripte'
    # Optional: Legen Sie die zu verwendende Shell fest
    shell: bash

Richtlinien für die Skriptentwicklung

  • Verwenden Sie immer ShellCheck: Führen Sie ShellCheck bei allen Shell-Skripten aus, bevor Sie sie bereitstellen.
  • Behandeln Sie Warnungen als Fehler: Konfigurieren Sie ShellCheck, um Warnungen in Ihrer Build-Pipeline als Fehler zu behandeln.
  • Dokumentieren Sie Ausnahmen: Wenn Sie bestimmte Warnungen deaktivieren müssen, dokumentieren Sie den Grund in der Konfigurationsdatei.
  • Aktualisieren Sie regelmäßig: Halten Sie ShellCheck auf dem neuesten Stand, um von neuen Prüfungen und Fehlerbehebungen zu profitieren.

Fehlerbehebung

Häufige Probleme

  • ShellCheck wird nicht gefunden: Überprüfen Sie die Installation und stellen Sie sicher, dass der Binärpfad in PATH enthalten ist.
  • Konfiguration wird ignoriert: Stellen Sie sicher, dass die .shellcheckrc-Datei im korrekten Verzeichnis liegt und gültige Direktiven enthält.
  • Falsche Shell-Erkennung: Wenn das Shebang (#!) fehlt oder mehrdeutig ist, geben Sie die Shell explizit mit der Option -s an.

Individual skills in this repo

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

wshobson/accessibility-compliance

Implement WCAG 2.2 compliant interfaces with mobile accessibility, inclusive design patterns, and assistive technology support. Use when auditing accessibility, implementing ARIA patterns, building for screen readers, or ensuring inclusive user experiences.

wshobson/airflow-dag-patterns

Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.

wshobson/angular-migration

Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning framework migrations, or modernizing legacy Angular code.

wshobson/anti-reversing-techniques

Understand anti-reversing, obfuscation, and protection techniques encountered during software analysis. Use this skill when analyzing malware evasion techniques, when implementing anti-debugging protections for CTF challenges, when reverse engineering packed binaries, or when building security research tools that need to detect virtualized environments.

wshobson/api-design-principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

wshobson/architecture-decision-records

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

wshobson/architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.

wshobson/async-python-patterns

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.

wshobson/attack-tree-construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

wshobson/auth-implementation-patterns

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

wshobson/avoid-ai-writing

Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, or blog post for machine-sounding prose, or make text sound less like AI. Supports a detect-only mode, a rewrite mode, and an edit-in-place mode, with optional voice and context profiles.

wshobson/backtesting-frameworks

Build robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.

wshobson/bash-defensive-patterns

Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.

wshobson/bats-testing-patterns

Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.

wshobson/bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

wshobson/before-you-build

Pre-build product and feature risk review for founders, product managers, and AI-assisted builders. Use this skill when the user is about to build a landing page, MVP, SaaS product, internal tool, agent workflow, or major feature and needs to check demand, positioning, monetization, retention, trust, distribution, and adoption risk before implementation starts.

wshobson/billing-automation

Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.

wshobson/binary-analysis-patterns

Master binary analysis patterns including disassembly, decompilation, control flow analysis, and code pattern recognition. Use when analyzing executables, understanding compiled code, or performing static analysis on binaries.

wshobson/block-no-verify-hook

Configure a PreToolUse hook to prevent AI agents from skipping git pre-commit hooks with --no-verify and other bypass flags. Use when setting up Claude Code projects that enforce commit quality gates.

wshobson/brand-landingpage

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

Verwandte Skills