Community연구 & 데이터 분석github.com

Python 리뷰 라우터

agentskills.io 호환 에이전트용 이식 가능한 Python 코드 리뷰 스킬 — 타입 안전성, 오류 처리, 안티패턴, async 및 코드 스타일을 위한 라우터 및 집중 스킬

Python 리뷰 라우터란 무엇인가요?

이 스킬은 Python 코드 리뷰를 위한 라우터 역할을 하며, 변경된 코드 영역에 따라 적절한 하위 스킬을 동적으로 로드하거나 정적으로 참조하도록 지원합니다. 타입 안전성(py-type-safety), 오류 처리(py-error-handling), 안티패턴(py-anti-patterns), async 패턴(py-async-patterns), 코드 스타일(py-code-style)의 다섯 가지 집중 스킬로 구성되어 있어, 리뷰어가 변경 사항에 가장 관련된 규칙만 적용할 수 있습니다. agentskills.io와 같은 동적 스킬 로딩을 지원하는 에이전트 런타임뿐만 아니라, 정적 체크리스트 방식으로도 사용할 수 있어 Cursor, Claude Code, Codex 등 다양한 플랫폼에서 이식 가능합니다. 리뷰 결과는 버그와 행동적 위험을 먼저 제시하고, 스타일만 개선하는 사항은 하위에 배치하여 실질적인 문제 해결에 집중하도록 설계되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add CodeSigils/py-review-skill

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

문서

Python 리뷰 라우터은(는) 무엇을 하나요?

Python 코드 리뷰를 위해 이 스킬을 먼저 사용하세요. 컨텍스트를 파악한 후, 변경된 코드와 일치하는 집중 스킬만 로드하세요.

리뷰 전: 오리엔테이션

  1. pyproject.toml, setup.cfg, tox.ini, CI, 또는 README에서 Python 버전을 확인하세요.

    • >=3.10인 경우: 모든 관련 핵심 스킬을 로드하되, 각 규칙을 해당 Python/도구 조건과 일치하는 경우에만 적용하세요.
    • 3.8-3.9인 경우: >=3.10이 필요한 구문 규칙은 건너뛰세요.
    • 알 수 없는 경우: 최소 3.10으로 가정하되, 버전에 민감한 발견 사항은 신중하게 표현하세요.
  2. 프로젝트 성숙도를 분류하세요.

    • 활성/신규 프로젝트: 전체 규칙 집합이 적절합니다.
    • 성숙한 레거시/유지보수 전용: CRITICAL 및 HIGH 발견 사항을 우선시하세요.
    • 자동화/스크립트: 안전성, 정확성, 리소스 처리 및 명확한 오류를 우선시하세요.
  3. 도구 체인을 확인하세요.

    • 프로젝트에서 pyright를 사용하는 경우 mypy 관련 구성을 권장하지 마세요.
    • 프로젝트에서 ruff를 사용하는 경우 스타일/import 관련 발견 사항은 해당 구성에 위임하세요.
    • 도구가 구성되지 않은 경우, 문제가 정확성과 관련되지 않는 한 도구 제안은 낮은 심각도로 제공하세요.
  4. 문제를 지적하기 전에 정확히 변경된 파일을 읽으세요.

    • 모든 발견 사항에 대해 파일과 줄 번호를 명시하세요.
    • 로컬 증거 없이 일반적인 발견 사항을 제시하지 마세요.
    • 규칙 일치는 신호일 뿐, 최종 판결이 아닙니다.

라우팅

변경된 코드가 다음을 다루면...로드다음의 경우 건너뛰기...
annotations, Any, casts, generics, protocols, public APIspy-type-safety변경이 사소하고 타입화된 표면이 없는 경우
exceptions, validation, cleanup, retries, batch failurespy-error-handling실패 경로가 변경되지 않은 경우
defaults, config, resource use, ORM/API boundaries, mixed I/O/business logicpy-anti-patterns변경이 문서/설정 전용인 경우
async def, event loops, FastAPI/httpx/aio*, tasks, cancellationpy-async-patterns프로젝트/변경이 동기 전용인 경우
formatting, names, imports, docstrings, lint/type configpy-code-style도구 출력이 이미 포함하고 있거나 리뷰가 정확성만 요청된 경우

이식성 참고

"로드" 열은 각 변경 유형에 대해 어떤 집중 스킬의 규칙을 적용해야 하는지 알려줍니다. 이러한 규칙에 액세스하는 방법은 에이전트 런타임에 따라 다릅니다.

  • 동적 로딩: 에이전트가 세션 중 스킬 활성화를 지원하는 경우, 명명된 스킬을 발견 가능하게 만들고 라우팅 테이블이 해당 범위를 알릴 때 활성화하세요.
  • 정적 체크리스트: 스킬 디렉토리에서 집중 스킬의 SKILL.md 파일을 직접 읽고 해당 규칙을 리뷰 체크리스트로 적용하세요.

두 접근 방식 모두 동일한 리뷰 결과를 생성합니다. 라우팅 테이블은 결정 트리이고, 집중 스킬은 규칙 집합을 제공합니다.

리뷰 출력

버그와 행동적 위험으로 리뷰를 시작하세요. 스타일만 개선하는 사항은 정확성 관련 발견 사항 뒤에 두세요. 레거시 코드의 경우 광범위한 현대화 조언보다는 실행 가능한 고영향 문제를 선호하세요.

관련 스킬