Openclaw용 Python 코딩 가이드라인

고품질의 관용적이며 유지 관리가 용이한 코드를 보장하기 위해 설계된 포괄적인 Python 코딩 표준 및 자동화 점검 세트입니다.

adarshdigievo
v1.0.0
Feb 3, 2026
14
12.1k
402

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install python

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 python 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Python 코딩 가이드라인란 무엇인가요?

이 스킬은 PEP 8 준수, 현대적인 구문 및 효율적인 의존성 관리에 중점을 둔 Python 개발을 위한 강력한 프레임워크를 제공합니다. 이러한 표준을 통합함으로써 개발자와 AI 에이전트는 코드베이스 전반에서 일관성을 유지하고, uv와 같은 고성능 도구를 활용하며, 가독성과 성능을 향상시키는 Pythonic 패턴을 채택할 수 있습니다. 이는 Openclaw Skills 생태계 내에서 Python 코드를 작성, 검토 및 리팩토링하기 위한 결정적인 가이드 역할을 합니다.

엄격한 버전 관리(Python 3.10+)와 타입 힌트 및 데이터 클래스와 같은 현대적인 기능을 강제함으로써, 이 스킬은 소프트웨어가 미래에도 경쟁력을 유지하고 일반적인 함정을 피할 수 있도록 보장합니다. CLI 도구를 빌드하든 복잡한 백엔드를 구축하든, 이 가이드라인은 초기 코드 작성부터 최종 테스트 및 배포까지의 개발 수명 주기를 간소화합니다.

Python 코딩 가이드라인 활용 사례

  • 팀 프로젝트 전반에서 코드 스타일 및 PEP 8 준수 표준화.
  • 매 커밋 전 자동 구문 검증 및 유닛 테스트.
  • 레거시 코드베이스를 현대적인 Python 3.10+ 기능으로 전환.
  • uv 또는 pip를 사용한 효율적인 의존성 관리 구현.
  • dataclasses 및 pathlib과 같은 관용적인 Pythonic 패턴을 사용한 코드 리팩토링.

Python 코딩 가이드라인 작동 원리

  1. 에이전트가 Python 소스 코드를 분석하여 PEP 8 및 현대적인 구문 표준 준수 여부를 확인합니다.
  2. 런타임 오류를 방지하기 위해 py_compile 모듈을 사용하여 자동화된 구문 검사를 수행합니다.
  3. 의존성 관리는 속도를 위해 uv를 우선적으로 처리하며, 필요시 pip로 대체합니다.
  4. 논리 검증을 위해 pytest 또는 unittest와 같은 테스트 도구를 자동으로 찾아 실행합니다.
  5. 깨끗하고 표준화된 구조를 유지하기 위해 Ruff 또는 Black과 같은 코드 포매팅 및 린팅 도구를 호출합니다.
  6. 관용적인 코드 품질을 보장하기 위해 타입 힌트 및 컨텍스트 관리자와 같은 현대적인 Python 기능을 검증합니다.

Python 코딩 가이드라인 설정 가이드

개발 환경에서 이러한 Openclaw Skills를 활용하려면 최신 Python 환경과 필요한 도구가 설치되어 있는지 확인하십시오.

# Python 3.10+ 설치 확인
python --version

# 권장: 빠른 의존성 관리를 위해 uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# 필수 린팅 및 테스트 도구 설치
pip install pytest ruff black

# 새로 시작하는 경우 uv로 프로젝트 초기화
uv init

Python 코딩 가이드라인 데이터 스키마 및 분류 체계

이 스킬은 다음 분류 체계를 사용하여 기술 요구 사항 및 메타데이터를 구성합니다.

요구 사항 표준 사양
들여쓰기 공백 4칸 (탭 사용 금지)
최대 줄 길이 88자 (Black 기본값)
명명 규칙 snake_case (함수/변수), PascalCase (클래스)
임포트 순서 표준 라이브러리 \u2192 서드파티 \u2192 로컬 (알파벳순)
최소 버전 Python 3.10+
테스트 패턴 파일명 test_*.py, 함수명 test_*

Python 코딩 가이드라인 고급 기능

  • 재현 가능한 환경을 위해 uv pip compile을 사용한 자동 의존성 해결.
  • 구조적 패턴 매칭 및 walrus 연산자와 같은 현대적인 Python 3.11-3.13 기능 지원.
  • IDE 지원 및 신뢰성 향상을 위해 공용 함수에 대한 포괄적인 타입 힌트 강제.
  • 더 안전한 I/O 작업을 위해 Pathlib 및 컨텍스트 관리자를 사용한 지능형 리소스 관리.
  • 가변 기본 인자 및 단순 예외 처리를 방지하기 위한 내장 안티 패턴 탐지.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*