Python 리뷰 라우터은(는) 무엇을 하나요?
Python 코드 리뷰를 위해 이 스킬을 먼저 사용하세요. 컨텍스트를 파악한 후, 변경된 코드와 일치하는 집중 스킬만 로드하세요.
리뷰 전: 오리엔테이션
-
pyproject.toml,setup.cfg,tox.ini, CI, 또는 README에서 Python 버전을 확인하세요.>=3.10인 경우: 모든 관련 핵심 스킬을 로드하되, 각 규칙을 해당 Python/도구 조건과 일치하는 경우에만 적용하세요.3.8-3.9인 경우:>=3.10이 필요한 구문 규칙은 건너뛰세요.- 알 수 없는 경우: 최소 3.10으로 가정하되, 버전에 민감한 발견 사항은 신중하게 표현하세요.
-
프로젝트 성숙도를 분류하세요.
- 활성/신규 프로젝트: 전체 규칙 집합이 적절합니다.
- 성숙한 레거시/유지보수 전용: CRITICAL 및 HIGH 발견 사항을 우선시하세요.
- 자동화/스크립트: 안전성, 정확성, 리소스 처리 및 명확한 오류를 우선시하세요.
-
도구 체인을 확인하세요.
- 프로젝트에서
pyright를 사용하는 경우mypy관련 구성을 권장하지 마세요. - 프로젝트에서
ruff를 사용하는 경우 스타일/import 관련 발견 사항은 해당 구성에 위임하세요. - 도구가 구성되지 않은 경우, 문제가 정확성과 관련되지 않는 한 도구 제안은 낮은 심각도로 제공하세요.
- 프로젝트에서
-
문제를 지적하기 전에 정확히 변경된 파일을 읽으세요.
- 모든 발견 사항에 대해 파일과 줄 번호를 명시하세요.
- 로컬 증거 없이 일반적인 발견 사항을 제시하지 마세요.
- 규칙 일치는 신호일 뿐, 최종 판결이 아닙니다.
라우팅
| 변경된 코드가 다음을 다루면... | 로드 | 다음의 경우 건너뛰기... |
|---|---|---|
annotations, Any, casts, generics, protocols, public APIs | py-type-safety | 변경이 사소하고 타입화된 표면이 없는 경우 |
| exceptions, validation, cleanup, retries, batch failures | py-error-handling | 실패 경로가 변경되지 않은 경우 |
| defaults, config, resource use, ORM/API boundaries, mixed I/O/business logic | py-anti-patterns | 변경이 문서/설정 전용인 경우 |
async def, event loops, FastAPI/httpx/aio*, tasks, cancellation | py-async-patterns | 프로젝트/변경이 동기 전용인 경우 |
| formatting, names, imports, docstrings, lint/type config | py-code-style | 도구 출력이 이미 포함하고 있거나 리뷰가 정확성만 요청된 경우 |
이식성 참고
"로드" 열은 각 변경 유형에 대해 어떤 집중 스킬의 규칙을 적용해야 하는지 알려줍니다. 이러한 규칙에 액세스하는 방법은 에이전트 런타임에 따라 다릅니다.
- 동적 로딩: 에이전트가 세션 중 스킬 활성화를 지원하는 경우, 명명된 스킬을 발견 가능하게 만들고 라우팅 테이블이 해당 범위를 알릴 때 활성화하세요.
- 정적 체크리스트: 스킬 디렉토리에서 집중 스킬의
SKILL.md파일을 직접 읽고 해당 규칙을 리뷰 체크리스트로 적용하세요.
두 접근 방식 모두 동일한 리뷰 결과를 생성합니다. 라우팅 테이블은 결정 트리이고, 집중 스킬은 규칙 집합을 제공합니다.
리뷰 출력
버그와 행동적 위험으로 리뷰를 시작하세요. 스타일만 개선하는 사항은 정확성 관련 발견 사항 뒤에 두세요. 레거시 코드의 경우 광범위한 현대화 조언보다는 실행 가능한 고영향 문제를 선호하세요.