clean-code
TypeScript에 클린 코드 원칙 적용하기
명확한 지침 없이 유지보수 가능한 TypeScript 코드를 작성하는 것은 어렵습니다. 이 스킬은 DRY, KISS, YAGNI 원칙의 실용적인 예제를 제공하여 팀이 이해할 수 있는 더 깔끔하고 읽기 쉬운 코드를 작성할 수 있도록 도와줍니다.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "clean-code". Review this function for clean code principles: const calc = (a,b,f) => f ? a*b*0.1 : a*b
النتيجة المتوقعة:
- DRY: 중복이 감지되지 않음
- KISS: 'calc'라는 이름이 불명확함 - 무엇을 계산하는지 설명해야 함
- 네이밍: 파라미터 'f'가 설명적이지 않음 - 'applyDiscount' 사용
- 제안: 'applyDiscount' 파라미터와 함께 'CalculateTotal'로 이름 변경
استخدام "clean-code". Help me apply clean code to this validation logic that repeats in multiple places
النتيجة المتوقعة:
- DRY: 검증 로직을 재사용 가능한 함수로 추출
- KISS: 복잡한 검증을 더 작고 집중된 검사로 분리
- YAGNI: 현재 필요한 검증 규칙만 추가
- 네이밍: 'validate' 대신 'isValidEmail'과 같은 설명적인 이름 사용
التدقيق الأمني
آمنAll 93 static findings are FALSE POSITIVES. This is a documentation-only skill containing educational content about clean code principles. The static analyzer detected patterns in TypeScript code examples within markdown documentation (template literals, fetch calls, constant declarations) and misinterpreted them as security issues. No executable code, network operations, file system access, or system commands exist in this skill. The content consists solely of educational code examples demonstrating software engineering best practices.
عوامل الخطر
⚙️ الأوامر الخارجية (58)
🌐 الوصول إلى الشبكة (10)
📁 الوصول إلى نظام الملفات (2)
درجة الجودة
ماذا يمكنك بناءه
클린 코드 기초 학습
실용적인 예제를 통해 DRY, KISS, YAGNI 원칙을 이해하여 코드 품질을 향상시킵니다.
팀 코드 리뷰 가이드
코드 리뷰 중 팀원들에게 클린 코드 원칙을 설명하기 위한 참고 자료로 사용합니다.
코딩 표준 수립
팀 코딩 표준 및 모범 사례 문서 작성을 위한 참고 자료입니다.
جرّب هذه الموجهات
이 TypeScript 코드를 검토하고 DRY 원칙 위반 사항을 식별하세요. 중복을 제거하기 위한 리팩토링을 제안해주세요: [paste code]
이 코드가 과도하게 엔지니어링된 것 같습니다. KISS 원칙을 적용하여 더 간단한 구현을 제안해주세요: [paste code]
이 코드에서 YAGNI 위반 사항을 분석하세요. 현재 필요하지 않은 기능이나 추상화를 식별해주세요: [paste code]
이 TypeScript 코드에 대해 DRY, KISS, YAGNI, 네이밍 규칙 및 클린 코드 체크리스트를 기준으로 완전한 클린 코드 리뷰를 수행하세요.
أفضل الممارسات
- 모든 변수, 메서드 및 클래스에 구체적이고 설명적인 이름 사용
- 메서드를 작게 유지하고 단일 책임에 집중
- 공통 코드를 추출하기 전에 3의 법칙 적용
تجنب
- 최소 세 개의 유사한 구현이 있을 때까지 코드를 추상화하지 말 것
- 성능을 먼저 측정하지 않고 조기 최적화를 피할 것
- 향후 계획 없이 단일 구현을 위한 인터페이스를 만들지 말 것
الأسئلة المتكررة
이 스킬은 JavaScript 프로젝트와 호환되나요?
이 스킬이 내 실제 코드 파일을 분석할 수 있나요?
개발 워크플로우에 어떻게 통합하나요?
내 코드가 외부 서비스로 전송되나요?
우리 팀이 다른 규칙을 사용하면 어떻게 하나요?
자동화된 코드 분석 도구와 어떻게 비교되나요?
تفاصيل المطور
المؤلف
DoubleslashSEالترخيص
MIT
المستودع
https://github.com/DoubleslashSE/claude-workflows/tree/main/Plugins/dotnet-tdd/skills/clean-codeمرجع
main
بنية الملفات
📄 SKILL.md