Community코딩 & 개발github.com

python-reduce-complexity

Python 코드의 복잡성을 측정하고 줄입니다. 명령형 어휘 토큰 수를 기반으로 단순화를 제안하고, 각각이 기능적으로 동등함을 검증하거나 차이가 문제되지 않는 이유를 설명한 후, 다시 측정하여 토큰 수가 감소했는지 확인합니다.

python-reduce-complexity란 무엇인가요?

이 스킬은 Python 파일 또는 노트북의 코드 복잡성을 명령형 어휘 토큰(imperative lexical tokens) 개수로 측정하고 줄이는 도구입니다. 번들된 `imperative_tokens.py` 스크립트를 사용하여 `def`/`class` 헤더, 타입 애너테이션, 임포트, 독스트링 등 선언적 요소는 제외하고, 실제 실행되는 구문(if, for, while, try, with, return, raise, 할당, 연산자, 호출, 리터럴, 컴프리헨션, 람다 등)만 카운트합니다. Claude Code, Cursor 등 AI 에이전트가 사용자의 요청(코드 복잡성 측정, 비교, 감소 요청 등)에 응답하여, 먼저 기준 측정을 수행한 뒤, 코드를 분석해 더 간결한 표현(예: `if x is not None else default` → `x or default`, 수동 루프 → 표준 라이브러리 함수)을 제안합니다. 각 제안은 기능적 동등성(또는 차이가 허용 가능함)을 테스트와 직접 비교로 검증하고, 사용자의 승인을 받아 적용한 후 최종 토큰 수를 다시 측정하여 복잡성이 실제로 감소했음을 보고합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jachymb/skills/tree/main/python-reduce-complexity

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

Python 복잡성 줄이기

파일: $ARGUMENTS

코드 복잡성은 가능한 낮게 유지하는 것이 좋습니다. 복잡성은 명령형 코드의 일부인 Python 어휘 토큰의 개수로 측정됩니다. 즉, 무언가를 실행하는 구문입니다. 선언은 코드를 구성할 뿐 로직에 추가되지 않으므로 무료입니다.

카운트되는 항목

이 파일 옆에 있는 imperative_tokens.py가 정의입니다.

카운트되지 않는 항목:

  • def 및 class 헤더: 첫 번째 데코레이터부터 본문을 여는 콜론까지(데코레이터, 매개변수, 기본값, 기본 클래스, 반환 애너테이션 포함). 이 모든 것은 정의와 함께 한 번 평가되며 인터페이스를 선언합니다.
  • 타입 애너테이션(x: int = 1은 x = 1로 카운트, x: int만 있으면 아무것도 카운트되지 않음) 및 type 별칭.
  • 임포트, 주석, 독스트링, 새 줄 및 들여쓰기.
  • 호출에서 키워드 인수의 이름: f(key=value)는 f(value)와 동일한 가중치입니다. 대부분의 상황에서 키워드로 인수를 전달하는 것이 선호되므로 비용이 들지 않습니다.
  • 속성 한정: a.b.c.d는 d와 동일한 가중치입니다. 점으로 구분된 경로는 하나의 객체를 지정합니다. 이를 카운트하면 np.log 대신 from numpy import log를 사용하거나 self.x의 로컬 별칭을 사용하는 것이 유리해지며, 둘 다 로직을 변경하지 않습니다.

카운트되는 항목: 다른 모든 토큰. 문(if, for, while, try, with, return, raise, …), 할당, 연산자, 호출, 리터럴, 컴프리헨션 및 람다, 그리고 그들의 쉼표, 콜론 및 쌍을 이루는 두 괄호. 따라서 호출은 동일한 작업을 수행하는 연산자보다 하나 더 많은 가중치를 갖습니다: a.update(b)는 4개의 토큰, a |= b는 3개의 토큰입니다.

노트북(.ipynb)의 경우 코드 셀이 카운트됩니다. 매직 또는 셸 라인(%config …, !pip …)은 IPython이 변환하는 호출로 카운트됩니다. 셀 매직 아래의 셀(%%bash, %%html)은 0으로 카운트됩니다. 예외는 본문을 Python으로 실행하는 셀 매직(IPython의 ExecutionMagics (예: %%time 및 %%capture))입니다. 매직은 라인 매직으로 카운트되고 본문은 코드로 카운트됩니다. 설치된 IPython에 내장되지 않은 매직(예: 확장 프로그램의 매직)은 0으로 카운트되고 스크립트는 경고를 출력합니다. 보고서에 해당 경고를 전달하십시오. 커널이 Python이 아닌 노트북은 0으로 카운트됩니다. 스크립트는 Python 노트북이 제공된 경우에만 IPython을 가져오고 어떤 매직이 내장되어 있는지 묻습니다.

카운트는 대리 측정입니다

더 낮은 카운트는 단순화의 증거이지 단순화 자체가 아닙니다.

  • 중대한 리팩터링은 허용됩니다: 새로운 도우미 함수, 새로운 기본 클래스, 새로운 파일. 그런 다음 모든 영향을 받는 파일을 합산하여 카운트를 비교하므로(단계 4), 파일 간에 이동된 로직은 순 제로가 됩니다.
  • 자체적인 정당화가 필요합니다: 스크립트가 보지 않는 곳(기본값, 데코레이터 인수, 기본 클래스 표현식 또는 새로운 종속성)으로 로직을 이동하는 경우. 제안은 낮은 카운트 외에도 변경이 좋은 이유를 명시합니다.
  • 금지됨: eval 또는 exec 또는 유사한 외부 실행을 위한 문자열 내의 코드.
  • 한 번만 사용되는 변수를 인라인화하는 것은 가독성을 해치지 않는 경우에만 허용됩니다. 중간 변수에 대한 좋은 이름은 독자가 의도를 이해하는 데 도움이 됩니다.
  • 줄이지 않는 것: 동작 제거(경계에서의 유효성 검사, 오류 처리, 지원되는 사례) 및 몇 개의 토큰을 위해 가독성을 희생하는 것(밀집된 원라이너, 후행 쉼표 제거).

프로젝트 자체 규칙(CLAUDE.md, 코딩 지침)이 카운트보다 우선합니다.

엄격하게 동등하지 않은 변경

변경이 프로그램이 올바르게 유지된다는 주장과 함께 단순화를 위해 동작을 변경할 수 있습니다. 제안은 무엇이 다른지, 어떤 입력에서 다른지, 그리고 코드에서의 증거와 함께 주장을 명시합니다:

  • 해당 입력이 발생할 수 없습니다. 증거: 값을 구성하거나 검증하는 코드.
  • 아무도 그 차이를 관찰하지 않습니다. 증거: 값의 모든 소비자를 나열합니다.
  • 차이는 관찰 가능하지만 무해합니다: 시드된 생성기에서의 다른 추출, 느린 알고리즘, 더 일찍 발생한 오류. 이는 사용자의 명시적 동의가 필요합니다. 공개 반환 값, 기록된 출력 또는 테스트에서 볼 수 있는 모든 차이도 마찬가지입니다.

주장의 모양을 보여주는 몇 가지 예입니다. 동작을 변경하는 다른 모든 변경은 아래 예와 비슷한지 여부에 관계없이 동일한 방식으로 주장됩니다:

더 간단한 형태대체 대상다른 점
x or defaultx if x is not None else defaultfalsy한 x(0, "", [])도 대체됨
zip(a, b)range(len(a))로 인덱싱더 짧은 b가 자동으로 잘림; strict=True는 검사를 유지함
a // bint(a / b)음수 피연산자는 반대 방향으로 반올림됨
max(xs, key=f)sorted(xs, key=f)[-1]동점 시, 마지막이 아닌 동등한 항목 중 첫 번째가 승리함
xs.sort()xs = sorted(xs)호출자가 전달한 리스트가 변경됨
Counter(xs)카운팅 루프누락된 키가 예외를 발생시키는 대신 0을 읽음
@dataclass, row.name으로 읽음dict 레코드, row["name"]으로 읽음인덱싱, .get, ** 언패킹 및 JSON 직렬화가 작동하지 않음

주장은 오늘날의 데이터가 아닌 코드에 기반합니다: "파일에 중복이 없다"는 주장이 될 수 없으며 "아마도 고유할 것이다"도 아닙니다. 동작 제거는 계속 제외됩니다: 경계에서의 유효성 검사는 주장으로 없앨 수 없습니다.

확실하지 않을 때는 사용자가 결정합니다. 증거가 불완전하거나(저장소 외부의 소비자, 읽을 수 없는 코드로 빌드된 값) 차이가 무해한지 불분명한 경우, 어느 쪽으로도 결정하지 마십시오. 다른 점과 알려지지 않은 내용과 함께 변경을 제시하고, 다른 제안을 계속 진행하며, 사용자가 동의할 때만 적용하십시오.

표준 라이브러리 형태

자주 발생하는 사례의 샘플로, 그러한 대체가 어떻게 보이는지 보여줍니다. 카탈로그가 아닙니다: 내장 함수, 표준 라이브러리 및 프로젝트의 설치된 종속성은 훨씬 더 많은 것을 제공하며, 테이블에 없는 대체도 테이블에 있는 것만큼 유효합니다.

표준 형태대체 대상다른 점
@dataclass, field(default_factory=list), order=True, frozen=True 포함매개변수만 저장하는 __init__; 수동 __eq__, __repr__, __lt__, __hash____eq__가 없던 클래스가 이제 값으로 비교되고 해시 불가능해짐(eq=False는 동일성 유지); __eq__는 클래스도 비교함; 명시적 None이 더 이상 기본값이 되지 않음
any(p(x) for x in xs), all(…), next(filter(p, xs), None)break가 있는 플래그 또는 검색 루프없음
defaultdict(list)if key not in groups: groups[key] = []누락된 키를 읽으면 삽입됨
@cache, @cached_property메모 dict; if self._x is None 게으른 속성메서드의 @cache는 호출된 각 인스턴스를 계속 유지함; 속성은 None을 할당하는 것이 아니라 del로 재설정됨
itemgetter("foo"), str.strip, operator.mul하나의 인덱싱, 하나의 메서드 호출 또는 하나의 연산자 적용만 하는 람다str.strip은 str이 아닌 값에서 예외를 발생시킴
Path(path).read_text()with open(path) as file: 및 file.read()없음
name.removeprefix(prefix), line.partition("=")startswith와 슬라이스; split과 길이 검사없음
chain.from_iterable(xss)[x for xs in xss for x in xs]이터레이터: 결과가 인덱싱되거나 두 번 읽히는 경우 list로 래핑
batched(xs, n)range(0, len(xs), n)에 대한 xs[i:i + n]슬라이스 리스트가 아닌 튜플의 이터레이터
@singledispatchisinstance 체인가장 구체적으로 등록된 클래스가 승리하며, 일치하는 첫 번째 테스트가 아님; 디스패치된 인수는 첫 번째 인수이며 위치로 전달됨

@singledispatch 및 @dataclass의 인수는 스크립트가 보지 않는 헤더로 로직을 이동합니다. 카운트 외의 이유: 생성된 메서드는 필드 목록을 따르며 이탈할 수 없고, 각 타입은 고유한 함수를 가지며 새로운 타입이 이를 건드리지 않습니다.

다른 형태는 컨텍스트에 따라서만 도움이 되므로 추가 고려가 필요합니다:

  • itertools.product 또는 itertools.combinations는 중첩 루프를 대체할 수 있습니다.
  • functools.reduce는 내장 함수가 없는 폴드를 대체할 수 있습니다.

단계

  1. 기준 설정. 프로젝트의 인터프리터(Python 3.12 이상)로 인수의 파일에 대해 스크립트를 실행하고 출력을 유지합니다:

    python "${CLAUDE_SKILL_DIR}/imperative_tokens.py" <file.py | notebook.ipynb> [...]
    

    지금 테스트를 실행하십시오: 변경 전에 실패하는 테스트 스위트는 변경 후에 아무것도 검증할 수 없습니다. 사용자가 측정만 요청한 경우 보고하고 중단하십시오.

  2. 제안. 코드가 일치시킬 패턴이 아니라 무엇을 계산하는지 읽고, 각 함수, 루프 및 분기에 대해 동일한 결과를 더 적은 양으로 표현할 수 있는지 물어보십시오. 이 스킬의 목록과 표는 단순화가 어떻게 보이는지 보여줍니다. 이것들은 검색 공간이 아닙니다: 제거할 수 있는 대부분은 당면한 코드에 특화되어 있으며 어떤 목록도 이를 예측할 수 없습니다. 나열된 패턴만 확인하는 패스는 불완전합니다.

    일반적인 발견 사항(대략 수확량 순서):

    • 죽은 코드: 사용되지 않는 함수, 매개변수 및 실행될 수 없는 분기;
    • 여기 또는 다른 파일에서 동일한 로직이 두 번 작성된 경우, 공유 도우미 또는 기본 클래스가 한 번만 보유하게 됨;
    • 표준 라이브러리, 내장 함수 또는 설치된 종속성이 이미 제공하는 수동 코드; itertools, functools, operator, collections 또는 dataclasses와 같은 표준 라이브러리 유틸리티가 도움이 될 수 있으며, 위의 "표준 라이브러리 형태"는 자주 발생하는 사례를 나열합니다;
    • 값을 구성하는 루프: 컴프리헨션이 일반적으로 루프보다 낫고, 때로는 filter 또는 map 내장 함수가 컴프리헨션보다 간단합니다;
    • 오버로드된 연산자가 대체하는 메서드 호출: a.union(b) 대신 a | b, a.update(b) 대신 a |= b, a.dot(b) 대신 a @ b. 먼저 피연산자 타입을 확인하십시오: 집합의 |=는 집합이 필요한 반면 .update()는 모든 iterable을 받습니다;
    • 데이터(매핑) 또는 일반 경로로 축소되는 분기;
    • 되돌리기 위해 존재하는 상태 및 변환;
    • 프로그램 경계에서 멀리 떨어진 방어적 검사;
    • 입력이 필요한 것보다 더 엄격한 코드, 여기서 더 간단한 형태는 발생할 수 없는 입력에서만 다르거나 아무도 관찰하지 않는 방식으로 다릅니다(위 테이블).

    그런 다음 이 중 어느 것에도 해당하지 않는 항목에 대해 가장 긴 함수부터 다시 한 번 코드를 검토하십시오: 부기(bookkeeping)를 불필요하게 만드는 다른 알고리즘 또는 데이터 구조; 특수 사례가 사라지도록 재정렬된 계산; 프로젝트가 이미 사용하는 종속성의 함수가 전체 작업을 수행하는 경우; 하나의 값에서만 다른 두 함수. 이러한 제안은 나열된 것과 동일한 규칙이 적용됩니다.

    스니펫(예: 제안 전후의 라인)의 가중치를 측정하려면 파일 인수 없이 스크립트로 파이프하십시오. 카운트만 출력합니다. 스니펫은 자체적으로 구문 분석되어야 하므로 들여쓰기를 제거하십시오:

    python "${CLAUDE_SKILL_DIR}/imperative_tokens.py" <<'EOF'
    uncounted |= set(range(first, last))
    EOF
    

    각 제안을 코드 형태, 전후의 주요 라인, 예상 토큰 절약, 영향받는 다른 파일, 위 섹션에서 요구하는 정당화 또는 주장과 함께 보여주십시오. 사용자의 승인 시 적용하거나, 사용자가 이미 변경을 요청한 경우 직접 적용하십시오.

  3. 적용 및 검증, 한 번에 하나의 제안을 수행하여 실패 시 원인을 지적할 수 있도록 합니다.

    • 기준에 없는 파일을 처음 편집하기 전에 측정하여 기준에 추가하십시오. 새 파일은 0에서 시작합니다.
    • 테스트는 변경 없이 통과해야 합니다. 검사하는 코드와 함께 편집된 테스트는 더 이상 코드를 검증하지 않습니다. 변경해야 하는 경우(제거된 도우미를 호출하는 경우) 그렇게 말하십시오.
    • 변경된 라인을 실행하지 않는 테스트는 아무것도 증명하지 않습니다. 해당 라인에 대해 이전 버전(git stash 또는 git show HEAD:<path>를 스크래치 파일로)과 새 버전을 동일한 입력(엣지 케이스 포함)에서 실행하고 출력을 비교하십시오. 부동 소수점 결과는 동일하거나 보고서가 차이의 크기를 명시합니다.
    • 엄격하게 동등하지 않은 변경은 주장이 허용하는 입력에서 비교됩니다. 그런 다음 주장 자체를 확인하십시오: 값을 구성하는 코드를 읽거나 모든 소비자를 검색하십시오. 성립하지 않는 증거는 제안을 기각합니다.
    • 공개 동작(시그니처, 예외 유형, 출력 순서)의 변경은 동등한 변경이 아닙니다. 사용자의 명시적 동의가 필요합니다.
  4. 재측정. 영향을 받는 모든 파일(인수의 파일 및 변경이 편집하거나 생성한 다른 모든 파일)에 대해 스크립트를 실행하십시오. 삭제된 파일은 0으로 끝납니다. 결합된 총계가 결합된 기준보다 낮거나 변경이 되돌려집니다. 단계 3에 실패한 변경도 마찬가지입니다.

  5. 보고. 영향받는 파일별 및 결합: 전후의 토큰 수 및 차이. 그런 다음 동등성을 검증한 것(어떤 테스트, 어떤 직접 비교), 엄격하게 동등하지 않은 모든 변경(다른 점과 그 주장 포함), 사용자의 결정을 기다리는 모든 변경, 그리고 기각된 모든 제안(이유 포함)을 보고하십시오.

관련 스킬