Community생산성 & 협업github.com

wshobson/bash-defensive-patterns

프로덕션 등급 스크립트를 위한 방어적 Bash 프로그래밍 기술을 마스터하세요. 견고한 셸 스크립트, CI/CD 파이프라인 또는 내결함성과 안전성을 요구하는 시스템 유틸리티를 작성할 때 사용하세요.

bash-defensive-patterns란 무엇인가요?

이 스킬은 Bash 스크립트에서 오류 처리, 입력 검증, 예기치 않은 종료 방지 등 방어적 프로그래밍 패턴을 가르칩니다. CI/CD 파이프라인, 시스템 유틸리티, 배포 스크립트와 같이 신뢰성이 중요한 환경에서 유용합니다. 주요 플랫폼(Bash 4.0+, sh)을 지원하며, set -euo pipefail, trap, 변수 기본값, 함수 반환 코드 확인 등의 기법을 다룹니다. 개발자는 이 가이드를 따라 더 견고하고 유지보수 가능하며 예측 가능한 셸 스크립트를 작성할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wshobson/agents/tree/main/skills/bash-defensive-patterns

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

bash-defensive-patterns은(는) 무엇을 하나요?

프로덕션 등급 스크립트를 위한 방어적 Bash 프로그래밍 기술을 마스터하세요. 견고한 셸 스크립트, CI/CD 파이프라인 또는 내결함성과 안전성을 요구하는 시스템 유틸리티를 작성할 때 사용하세요.

방어적 Bash 프로그래밍이 중요한 이유

셸 스크립트는 종종 시스템의 핵심 부분에서 실행됩니다. 단 하나의 처리되지 않은 오류나 예상치 못한 입력이 전체 시스템을 손상시킬 수 있습니다. 방어적 프로그래밍 패턴은 이러한 위험을 완화합니다.

핵심 방어 패턴

1. set -euo pipefail 사용

#!/bin/bash
set -euo pipefail
  • -e: 명령이 실패하면 즉시 종료합니다.
  • -u: 설정되지 않은 변수를 오류로 처리합니다.
  • -o pipefail: 파이프라인에서 첫 번째 실패한 명령의 종료 코드를 반환합니다.

2. 입력 검증

# 필수 인수 확인
if [[ $# -lt 1 ]]; then
    echo "사용법: $0 <인수>"
    exit 1
fi

# 특정 패턴과 일치하는지 확인
input="$1"
if [[ ! "$input" =~ ^[a-zA-Z0-9_-]+$ ]]; then
    echo "오류: 영숫자, 밑줄, 하이픈만 허용됩니다."
    exit 1
fi

3. trap으로 정리

cleanup() {
    echo "정리 중..."
    rm -f /tmp/임시_파일_$$
}

trap cleanup EXIT ERR

4. 변수 기본값 사용

# 환경 변수에 안전한 기본값
PORT="${PORT:-8080}"
DATABASE_URL="${DATABASE_URL:?DATABASE_URL이 설정되지 않았습니다}"

5. 함수 반환 코드 확인

if ! some_command; then
    echo "오류: some_command 실패"
    exit 1
fi

권장 사항

  • 항상 모든 셸 스크립트 상단에 set -euo pipefail을 추가하세요.
  • 외부 입력을 검증하고 예상치 못한 데이터를 거부하세요.
  • trap을 사용하여 임시 파일을 정리하고 리소스를 해제하세요.
  • 설정되지 않은 변수로 인한 오류 방지를 위해 변수 확장에 기본값을 사용하세요.

참고

이 패턴은 GNU Bash 4.0 이상 및 POSIX sh와 호환됩니다. set -euo pipefail은 POSIX 표준의 일부가 아니므로 일부 파생 셸에서는 동작이 다를 수 있습니다.

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/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.

wshobson/changelog-automation

Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.

관련 스킬