clean-code
Применяйте принципы Clean Code к вашей кодовой базе
또한 다음에서 사용할 수 있습니다: Benny9193,DoubleslashSE
Пишите код, который работает И который легко поддерживать. Этот навык применяет принципы Clean Code Роберта К. Мартина для преобразования неаккуратного кода в читаемый, тестируемый и профессиональный код, который другие разработчики могут понять и модифицировать.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"clean-code" 사용 중입니다. Review this function: def chk(u): if u.age>65 and u.tp=='h': return True
예상 결과:
Найдено 3 нарушения Clean Code: 1) Имя функции 'chk' не раскрывает намерение. Предлагаем: isEligibleForFullBenefits. 2) Параметр 'u' не поисковый. Предлагаем: employee. 3) Магическое сравнение 'tp==h' использует неясное сокращение. Выделите в метод isHourly() или используйте именованную константу. Предоставлена рефакторенная версия с объяснением.
"clean-code" 사용 중입니다. Apply Clean Code principles to this 50-line function that does validation, database save, sends email, and logs metrics
예상 결과:
Эта функция нарушает принцип единственной ответственности. Разделите на 4 функции: 1) validateUserCredentials(), 2) saveUserToDatabase(), 3) sendWelcomeEmail(), 4) logUserMetrics(). Каждая функция должна быть менее 10 строк. Основная функция координирует эти шаги с явной обработкой ошибок на каждом этапе.
보안 감사
안전Static analysis detected 29 potential issues (external commands, network patterns, weak cryptography, system reconnaissance), but all are FALSE POSITIVES. The findings match Markdown code block delimiters (backticks), documentation examples, and reference URLs in educational content. The skill contains no executable code, performs no file operations, makes no network requests, and is purely documentation about software engineering principles. Safe to publish.
품질 점수
만들 수 있는 것
Код-ревью пул-реквеста
Применяйте принципы Clean Code во время ревью PR, чтобы предоставить конструктивную обратную связь на основе принципов по именованию, размеру функций и организации кода перед мержем.
Рефакторинг легаси-кода
Преобразуйте сложный в поддержке легаси-код в чистый, читаемый код, выявляя code smells, разбивая большие функции на меньшие и улучшая соглашения об именовании.
Разработка новых функций
Пишите чистый код с самого начала при реализации новых функций, гарантируя, что функции небольшие, имена осмысленные, и код следует лучшим отраслевым практикам.
이 프롬프트를 사용해 보세요
Проверьте эту функцию на соответствие принципам Clean Code. Проверьте, делает ли она одно дело, имеет ли описательное имя, подходящее количество аргументов и достаточно ли она мала. Предложите улучшения: [ВСТАВИТЬ КОД]
Примените принципы Clean Code для рефакторинга этого кода. Сфокусируйтесь на: осмысленных именах, небольших функциях, одном уровне абстракции, удалении плохих комментариев и правильной обработке ошибок. Объясните каждое изменение: [ВСТАВИТЬ КОД]
Проанализируйте эту кодовую базу/файл на наличие code smells, включая: ригидность, хрупкость, немобильность, вязкость, излишнюю сложность и повторения. Перечислите конкретные проблемы с номерами строк: [ВСТАВИТЬ КОД]
Проверьте имена в этом коде (переменные, функции, классы) на намеренно-раскрывающую ясность, произносимость и поисковость. Предложите лучшие имена и объясните почему: [ВСТАВИТЬ КОД]
모범 사례
- Используйте навык во время код-ревью для предоставления объективной обратной связи на основе принципов, а не субъективных мнений
- Применяйте принципы Clean Code постепенно при рефакторинге — не пытайтесь исправить всё сразу
- Сфокусируйтесь сначала на самых impactful улучшениях: размер функций, именование и устранение дублирования кода
- Балансируйте принципы clean code с практическими ограничениями, такими как дедлайны и контекст команды
피하기
- Не применяйте слепо все принципы без учёта контекста — иногда функция с 3 аргументами является самым ясным решением
- Избегайте комментирования каждой строки кода — стремитесь к самодокументируемому коду, не требующему объяснений
- Не рефакторьте без тестов — убедитесь, что у вас есть тестовое покрытие перед внесением структурных изменений
- Никогда не жертвуйте корректностью ради чистоты — код должен работать, прежде чем он сможет быть чистым