yeahjack/avoid-overkill

avoid-overkill은(는) 무엇을 하나요?

코드, 테스트, ML 검증, 학술 작성을 위한 비례적인 접근법을 제공하는 간결한 Codex 스킬입니다.

개요

이 스킬은 작업의 실제 필요에 맞게 노력과 복잡성을 조절하도록 AI 어시스턴트를 안내합니다. 과잉 엔지니어링(over-engineering)을 피하고 효율성을 극대화하는 것이 목표입니다.

사용 방법

• 코딩: 요구사항에 정확히 부합하는 간결한 코드를 작성합니다. 불필요한 추상화나 과도한 최적화를 피합니다.
• 테스트: 코드의 중요한 부분을 테스트하는 비례적인 테스트를 작성합니다. 100% 코드 커버리지보다 핵심 기능의 정확성을 우선시합니다.
• ML 검증: 데이터와 모델 특성에 적합한 검증 전략을 선택합니다. 간단한 모델에는 간단한 검증을, 복잡한 문제에는 더 엄격한 방법을 적용합니다.
• 학술 작성: 필요한 수준의 상세함과 명확함을 유지하면서도 간결하게 작성합니다. 독자가 이미 알고 있다고 가정할 수 있는 내용은 과도하게 설명하지 않습니다.

주요 원칙

1. 비례성: 각 작업에 소요되는 노력은 작업의 중요성과 복잡성에 비례해야 합니다.
2. 과잉 방지: '더 나은' 해결책을 위해 지나치게 복잡하게 만들지 않습니다. '충분히 좋은' 해결책도 가치 있습니다.
3. 상황 인식: 컨텍스트를 고려하여 가장 적합한 접근법을 선택합니다.

코드 예시

# 과잉 설계된 예시 (avoid)
class Calculator:
    def __init__(self, operations):
        self.operations = operations
    
    def calculate(self, a, b, op):
        if op not in self.operations:
            raise ValueError(f"Unsupported operation: {op}")
        return self.operations[op](a, b)

# 비례적인 예시 (prefer)
def add(a, b):
    return a + b

참고 사항

이 스킬은 Codex 플랫폼에 최적화되어 있으며, 다른 AI 코딩 어시스턴트와도 호환될 수 있습니다.