Community생산성 & 협업github.com

wshobson/python-anti-patterns

Python 코드 리뷰 시 흔한 안티 패턴을 피하기 위해 사용하는 스킬입니다. 코드 리뷰, 구현 최종 점검, 또는 알려진 나쁜 관행으로 인한 문제 디버깅 시 체크리스트로 활용하세요.

python-anti-patterns란 무엇인가요?

이 스킬은 Python 코드에서 흔히 발견되는 안티 패턴을 식별하고 피하는 데 도움을 줍니다. 코드 리뷰, 구현 마무리 단계, 또는 알려진 나쁜 관행으로 인한 버그를 디버깅할 때 체크리스트로 사용할 수 있습니다. 주요 안티 패턴으로는 mutable 기본 인수, 전역 변수 과다 사용, isinstance 남용, 예외 처리 오용 등이 포함됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용 가능하며, SKILL.md 문서에 정의된 패턴 목록을 기준으로 코드를 분석하고 개선 방안을 제시합니다.

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

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

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

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

문서

python-anti-patterns은(는) 무엇을 하나요?

Python 코드 리뷰 시 흔한 안티 패턴을 피하기 위해 이 스킬을 사용하세요. 코드 리뷰, 구현 최종 점검, 또는 알려진 나쁜 관행으로 인한 문제 디버깅 시 체크리스트로 활용하세요.

안티 패턴 목록

1. Mutable 기본 인수

함수 매개변수에 리스트나 딕셔너리 같은 mutable 객체를 기본값으로 사용하지 마세요. 대신 None을 사용하고 함수 내부에서 초기화하세요.

나쁜 예:

def append_to(element, target=[]):
    target.append(element)
    return target

좋은 예:

def append_to(element, target=None):
    if target is None:
        target = []
    target.append(element)
    return target

2. 전역 변수 과다 사용

전역 변수는 코드의 가독성과 유지보수성을 떨어뜨립니다. 가능한 한 함수 매개변수나 클래스 속성을 사용하세요.

3. isinstance 남용

isinstance를 과도하게 사용하는 것은 객체 지향 설계 원칙을 위반합니다. 다형성을 활용하거나 추상 기본 클래스(ABC)를 사용하세요.

4. 예외 처리 오용

너무 광범위한 예외 처리는 디버깅을 어렵게 만듭니다. 특정 예외 타입을 명시하고, 예외를 삼키지 마세요.

나쁜 예:

try:
    risky_operation()
except:
    pass

좋은 예:

try:
    risky_operation()
except ValueError as e:
    print(f"ValueError 발생: {e}")

5. 리스트 컴프리헨션 남용

리스트 컴프리헨션이 너무 길거나 복잡하면 가독성이 떨어집니다. 일반 루프를 사용하는 것을 고려하세요.

6. 비효율적인 문자열 결합

루프 안에서 + 연산자로 문자열을 결합하지 마세요. 대신 리스트에 모은 후 join()을 사용하세요.

나쁜 예:

result = ""
for s in strings:
    result += s

좋은 예:

result = "".join(strings)

7. import * 사용

from module import *는 네임스페이스를 오염시키고 명시성을 떨어뜨립니다. 필요한 것만 임포트하세요.

8. 비교에 is 사용

값 비교에는 ==를 사용하고, 객체 동일성 비교에만 is를 사용하세요.

나쁜 예:

if x is 10:
    pass

좋은 예:

if x == 10:
    pass

사용 방법

  1. 코드 리뷰 시 이 체크리스트를 참고하여 안티 패턴을 찾으세요.
  2. 발견된 각 안티 패턴에 대해 좋은 예시로 대체하세요.
  3. 리뷰 의견에 구체적인 패턴명과 개선 방안을 포함하세요.

추가 자료

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.

관련 스킬