python-code-stylecommit cbb6049SKILL.md · 코드 규약

Python 코드 스타일

Python 린트·포맷터 설정, PEP 8 명명, import 순서, 타입 힌트, Google 스타일 docstring 규칙을 다룹니다.

npx skills add wshobson/agents --skill python-code-style

권한: read-repo
write-files
shell
network
호환 도구: Claude Code, Codex, Cursor, Copilot, OpenCode
GitHub: 42.1k
출처: 커뮤니티 · Seth Hobson
상태: 스캔 통과
라이선스: MIT
카테고리: 코드 규약
저장소: github.com/wshobson/agents/plugins/python-development/skills/python-code-style

핵심 규칙

포맷 논쟁은 도구에 맡기고, 한 번 설정해 자동으로 적용합니다.

실행 단계

01단계도구 설정
pyproject.toml에 ruff를 린터 겸 포맷터로 설정하고 mypy나 pyright를 strict 모드로 켭니다.
02단계명명과 import
PEP 8을 따르고 간결함보다 명확함을 우선하며, import는 표준 라이브러리·서드파티·로컬 순으로 묶고 절대 import만 씁니다.
03단계타입과 문서
모든 공개 API에 타입 힌트와 Google 스타일 docstring을 달고 Args, Returns, Raises, 예시를 적습니다.
04단계포맷과 문서
줄 길이는 120으로 두고 읽기 좋게 줄바꿈하며, README와 Keep a Changelog 형식 CHANGELOG를 관리하고 CI에서 린터를 돌립니다.

권한 설명 (SKILL.md 기준)

기능	필요 여부	설명
파일 쓰기	필요	pyproject.toml 등 설정을 수정하고 코드에 타입과 docstring을 추가하며 프로젝트 문서를 작성합니다.
명령 실행	일부 필요	ruff check --fix, ruff format, 그리고 ruff, mypy 설치 명령을 실행합니다.
네트워크 송신	일부 필요	pip로 ruff, mypy 등을 설치할 때만 패키지 인덱스에 접속합니다.

SKILL.md 프런트매터(YAML)commit cbb6049

---
name: python-code-style
description: Python code style, linting, formatting, naming conventions, and documentation standards. Use when writing new code, reviewing style, configuring linters, writing docstrings, or establishing project standards.
---

핵심 규칙

실행 단계

01단계도구 설정

02단계명명과 import

03단계타입과 문서

04단계포맷과 문서

권한 설명 (SKILL.md 기준)

SKILL.md 프런트매터(YAML)

관련 스킬