품위 있는 파이썬 코딩 표준 스킬
깔끔하고 유지보수 가능한 현대적 파이썬 코드(버전 3.10-3.13)를 작성하기 위한 프로덕션 품질의 파이썬 코딩 표준입니다.
이 스킬을 사용해야 할 때
사용자가 다음과 같은 내용을 요청할 때 자동 호출됩니다:
- "파이썬스럽게 만들어 줘" / "이 파이썬 코드 괜찮아?"
- "타입 힌트" / "타입 어노테이션" / "타이핑"
- "LBYL vs EAFP" / "예외 처리"
- "pathlib vs os.path" / "경로 연산"
- "CLI 패턴" / "click 사용법"
- "코드 리뷰" / "이 코드 개선해 줘"
- 모든 파이썬 코드 품질 또는 표준 관련 질문
참고: 이 스킬은 일반 파이썬 표준이며, Dagster 특화가 아닙니다. Dagster 패턴은 /dagster-expert를 사용하세요.
이 스킬과 다른 스킬을 사용해야 할 때
| 사용자 요구사항 | 이 스킬 사용 | 대체 스킬 |
|---|---|---|
| "파이썬스럽게 만들어 줘" | ✅ 예 - 파이썬 표준 | |
| "이 파이썬 코드 괜찮아?" | ✅ 예 - 코드 품질 | |
| "타입 힌트" | ✅ 예 - 타입 가이드 | |
| "LBYL vs EAFP" | ✅ 예 - 예외 패턴 | |
| "pathlib vs os.path" | ✅ 예 - 경로 처리 | |
| "Dagster 관련 패턴" | ❌ 아니요 | /dagster-expert |
| "CLI 인자 파싱" | ✅ 예 - CLI 패턴 |
핵심 지식 (항상 로드됨)
버전 감지
프로젝트의 최소 파이썬 버전을 식별하려면 (순서대로 확인):
pyproject.toml-requires-python필드 확인 (예:requires-python = ">=3.12")setup.py또는setup.cfg-python_requires확인.python-version파일 -3.12또는3.12.0과 같은 버전 포함- 버전 지정자가 없으면 파이썬 3.12를 기본값으로 사용
식별 후, 해당 버전별 파일을 로드:
- 파이썬 3.10:
versions/python-3.10.md로드 - 파이썬 3.11:
versions/python-3.11.md로드 - 파이썬 3.12:
versions/python-3.12.md로드 - 파이썬 3.13:
versions/python-3.13.md로드
조건부 로딩 (작업 패턴 기반 로드)
핵심 파일은 파이썬 코드 패턴의 80% 이상을 다룹니다. 특정 패턴을 감지했을 때만 다음 추가 파일을 로드하세요:
패턴 감지 예시:
- 작업에 "click" 또는 "CLI"가 언급된 경우 ->
cli-patterns.md로드 - 작업에 "subprocess"가 언급된 경우 ->
subprocess.md로드
참조 문서 구조
참조 문서는 최상위 파일과 하위 디렉토리로 구성되어 있습니다:
핵심 참조 (SKILL.md와 동일한 위치)
dignified-python-core.md- 필수 표준 (항상 로드됨)cli-patterns.md- 명령줄 인터페이스 패턴 (click, argparse)subprocess.md- 서브프로세스 연산
버전별 참조 (versions/)
versions/python-3.10.md- 파이썬 3.10+에서 사용 가능한 기능versions/python-3.11.md- 파이썬 3.11+에서 사용 가능한 기능versions/python-3.12.md- 파이썬 3.12+에서 사용 가능한 기능versions/python-3.13.md- 파이썬 3.13+에서 사용 가능한 기능
고급 주제 (references/advanced/)
exception-handling.md- LBYL 패턴, 오류 경계interfaces.md- ABC 및 Protocol 패턴typing-advanced.md- 고급 타입 패턴api-design.md- API 설계 원칙
각 참조 문서를 읽어야 할 때
references/advanced/exception-handling.md
다음 경우에 읽으세요:
- try/except 블록 작성 시
- 예외를 발생시킬 수 있는 타사 API 래핑 시
from e또는from None을 보거나 작성할 때- LBYL 대안이 있는지 확실하지 않을 때
references/advanced/interfaces.md
다음 경우에 읽으세요:
- ABC 또는 Protocol 클래스 생성 시
- @abstractmethod 데코레이터 작성 시
- 게이트웨이 계층 인터페이스 설계 시
- ABC와 Protocol 중 선택해야 할 때
references/advanced/typing-advanced.md
다음 경우에 읽으세요:
- typing.cast() 사용 시
- Literal 타입 별칭 생성 시
- 조건부 블록에서 타입 좁히기 시
references/module-design.md
다음 경우에 읽으세요:
- 새 파이썬 모듈 생성 시
- 모듈 수준 코드 추가 시 (단순 상수 제외)
- 모듈 수준에서 @cache 데코레이터 사용 시
- 모듈 수준에서 Path() 또는 계산을 볼 때
- 인라인 임포트 고려 시
references/api-design.md
다음 경우에 읽으세요:
- 함수에 기본 매개변수 값 추가 시
- 5개 이상의 매개변수가 있는 함수 정의 시
- ThreadPoolExecutor.submit() 사용 시
- 함수 시그니처 리뷰 시
references/checklists.md
다음 경우에 읽으세요:
- 파이썬 코드 커밋 전 최종 리뷰 시
- 모든 규칙을 따랐는지 확실하지 않을 때
- 요구사항을 빠르게 확인해야 할 때
이 스킬 사용 방법
- 핵심 지식이 자동으로 로드됩니다 (LBYL, pathlib, 기본 임포트, 안티패턴)
- 버전 감지는 한 번 수행됩니다 - 최소 파이썬 버전을 식별하고 해당 버전 파일을 로드합니다
- 참조 문서는 위의 트리거를 기반으로 필요 시 로드됩니다
- 추가 패턴은 추가 로딩이 필요할 수 있습니다 (CLI 패턴, 서브프로세스)
- 각 파일은 독립적이며 해당 도메인에 대한 완전한 지침을 제공합니다