style-audit
코드 스타일 감사 및 개선
작동하는 코드만으로는 충분하지 않습니다. 나쁜 스타일은 혼란을 만들고 기술 부채를 쌓으며 팀 협업을 느리게 합니다. 이 스킬은 체계적인 스타일 감사와 리팩토링을 적용해 기능적으로 올바른 코드를 유지보수 가능하고 프로덕션 수준의 코드로 변환합니다.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "style-audit". Audit my JavaScript code and improve the style
النتيجة المتوقعة:
- 스타일 이슈 23건 발견: 포맷팅 8, 네이밍 6, 복잡도 4, 문서화 3, 에러 처리 2
- Prettier로 포맷팅 이슈 8건을 자동 수정
- 명확성을 위해 변수 6개 이름 변경(예: 'd' → 'userData', 'processItem' → 'validateAndProcessItem')
- 복잡한 함수 2개를 더 작고 단일 목적의 헬퍼로 분리
- 문서화되지 않은 함수 3개에 docstring 추가
- 리팩토링 후 모든 테스트 통과
- 품질 점수 72%에서 91%로 향상
استخدام "style-audit". Review Python codebase for quality issues
النتيجة المتوقعة:
- 자동 린팅에서 12개 파일에서 47개 이슈 발견(pylint, flake8, mypy)
- 수동 리뷰에서 분해가 필요한 함수 15개 식별
- 보안 리뷰에서 입력 검증 누락 3건과 하드코딩된 경로 2건을 표시
- 문서화 커버리지 62%, 28개 함수에 docstring 누락
- 우선순위 수정: 보안 이슈 먼저, 그다음 가독성, 그다음 유지보수성
استخدام "style-audit". Apply team coding standards to legacy codebase
النتيجة المتوقعة:
- 팀 스타일 가이드 기준으로 레거시 코드 5,000라인 분석
- 3개 스프린트에 걸친 단계별 리팩토링 계획 수립
- 이슈의 78% 해결을 보여주는 준수 보고서 생성
- 잔여 이슈는 향후 백로그를 위한 노력 추정치와 함께 문서화
التدقيق الأمني
آمنPure documentation skill containing only markdown and Graphviz diagram files. No executable code, no network calls, no filesystem access beyond reading its own files, and no code execution capabilities. All 37 static findings are false positives caused by the analyzer misclassifying legitimate documentation terminology. The skill is a prompt-based documentation artifact with zero security risk.
عوامل الخطر
🌐 الوصول إلى الشبكة (1)
📁 الوصول إلى نظام الملفات (1)
درجة الجودة
ماذا يمكنك بناءه
커밋 전 코드 준비
커밋 전에 코드를 감사하여 스타일 이슈를 조기에 발견하고 팀 표준과의 일관성을 सुनिश्चित
체계적인 코드 리뷰
자동화 및 수동 리뷰 방법론을 사용해 PR 전반에 일관된 스타일 기준 적용
코드베이스 품질 표준
체계적인 감사와 리팩토링 워크플로로 팀 전반의 코드 품질을 강화
جرّب هذه الموجهات
Run a style audit on the files in my project. Identify formatting issues, naming convention violations, and basic style problems.
Perform a complete style audit on my codebase including automated linting analysis, manual style review, security review, and documentation assessment. Report all findings categorized by severity.
Audit and refactor my code to improve style. Apply automated fixes first, then manually refactor for clarity. Verify all functionality is preserved by running tests after each significant change.
Apply my team's style guidelines to the codebase. Use our linting configuration files. Generate a detailed report showing before and after metrics with remaining issues prioritized by impact.
أفضل الممارسات
- functionality-audit가 코드의 정상 동작을 확인한 뒤 style-audit를 실행
- 기존 표준과의 정렬을 위해 팀 린팅 설정을 제공
- 리뷰와 되돌리기를 쉽게 하기 위해 작은 단위의 원자적 커밋으로 스타일 개선을 진행
تجنب
- functionality-audit 전에 style-audit를 실행(깨진 코드를 리팩토링할 수 있음)
- 기능을 검증하는 테스트 없이 스타일 수정 적용
- 자동 린팅 결과를 무시하고 주관적 선호를 우선시