kaizen
Применение методов Kaizen для качества кода
Команды разработки ПО сталкиваются с проблемой непостоянного качества кода и реактивного подхода к обработке ошибок. Этот навык предоставляет структурированную методологию Kaizen для непрерывного улучшения, защиты от ошибок на этапе проектирования и следования стандартизированным паттернам.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «kaizen». Примените Kaizen для улучшения этой функции, которая вычисляет суммы заказов
Ожидаемый результат:
- Итерация 1 — Добавьте валидацию входных данных: проверьте массив элементов на null/пустоту и отрицательные цены перед вычислением. Это предотвратит ошибки времени выполнения.
- Итерация 2 — Улучшите читаемость: замените for-цикл на reduce() для более ясного намерения. Сигнатура типа явно возвращает number.
- Итерация 3 — Добавьте сообщения об ошибках: выбрасывайте описательные ошибки для недопустимых входных данных вместо тихих сбоев. Каждая итерация протестирована и работает.
Использование «kaizen». Спроектируйте защищённый от ошибок тип Order используя Poka-Yoke
Ожидаемый результат:
- Вместо простого объекта со строковым статусом используйте дискриминируемые объединённые типы, где каждое состояние заказа имеет свои требуемые данные.
- Ожидающие заказы требуют временной метки createdAt. Отправленные заказы требуют trackingNumber. Доставленные заказы требуют signature.
- Система типов делает невозможным наличие отправленного заказа без информации об отслеживании. Ошибки компиляции предотвращают целые классы багов.
Аудит безопасности
БезопасноThis skill is a documentation-only guide for Kaizen software development methodology. Static analysis flagged 73 patterns in code examples within markdown documentation, but all findings are false positives. The backtick operators are TypeScript template literals (not shell commands), fetch calls are educational examples (not actual network requests), and environment variable references teach secure validation practices. No executable code exists in this skill.
Проблемы низкого риска (3)
Оценка качества
Что вы можете построить
Улучшение код-ревью
Применение принципов Kaizen во время код-ревью для предложения небольших постепенных улучшений вместо требования полной переписывания. Каждое предложение проверяется и тестируется перед переходом к следующему.
Устойчивое к ошибкам проектирование API
Использование техник Poka-Yoke для проектирования TypeScript API, где некорректные состояния непредставимы на этапе компиляции. Система типов отлавливает ошибки до запуска.
Рефакторинг устаревшего кода
Применение подхода итеративного уточнения: заставить работать, сделать понятным, сделать эффективным. Каждая итерация завершена и протестирована перед переходом к следующей.
Попробуйте эти промпты
Просмотрите эту функцию и предложите одно небольшое улучшение в соответствии с принципами Kaizen. Объясните, почему это изменение улучшает качество, и убедитесь, что оно работает, прежде чем предлагать что-либо ещё.
Проанализируйте этот API-интерфейс, используя принципы Poka-Yoke. Покажите, как использовать типы TypeScript, чтобы сделать некорректные состояния непредставимыми. Приведите примеры до и после с определениями типов.
Я добавляю новую функцию в эту кодовую базу. Проанализируйте существующие паттерны кода для [тип функции] и покажите, как реализовать новую функцию, следуя тому же стандартизированному подходу. Укажите на конкретные примеры в кодовой базе.
Проверьте этот код на нарушения YAGNI. Определите любые функции «на всякий случай», преждевременные абстракции или неиспользуемую сложность. Для каждой проблемы покажите простейшую версию, отвечающую текущим требованиям, и объясните, что нужно удалить.
Лучшие практики
- Делайте минимально жизнеспособное изменение, улучшающее качество, убедитесь, что оно работает, затем переходите к следующему улучшению
- Проверяйте входные данные и конфигурацию на границах системы, быстро завершайтесь с явными сообщениями об ошибках
- Следуйте существующим паттернам кодовой базы для согласованности. Внедряйте новые паттерны только когда они значительно лучше и согласованы командой
Избегать
- Попытка крупных проектов рефакторинга вместо постепенных улучшений
- Создание универсальных фреймворков или абстракций до наличия нескольких проверенных случаев использования
- Добавление функций «на всякий случай» или оптимизация без измерения реальных проблем производительности