Общие лучшие практики

Что делает навык

Набор общих лучших практик разработки ПО, охватывающих качество кода, архитектуру, тестирование, безопасность, производительность и поддерживаемость. Помогает агенту писать чистый, безопасный и эффективный код, соответствующий принципам SOLID и Clean Architecture.

Когда применять

• Рефакторинг существующего кода для улучшения читаемости и соблюдения принципа единой ответственности.
• Проектирование архитектуры приложения с разделением на слои (Presentation, Application, Domain, Infrastructure).
• Настройка процессов тестирования, включая написание unit- и integration-тестов и их интеграцию в CI/CD.
• Обеспечение безопасности приложения через валидацию входных данных, управление секретами и защиту от SQL-инъекций.
• Настройка наблюдаемости (observability) системы с помощью структурированного логирования, метрик и распределенного трейсинга.

Как работает

1. Анализируйте код на соответствие принципам читаемости: проверяйте длину функций (до 30 строк), отсутствие глубокой вложенности и наличие guard clauses.
2. Проверяйте архитектуру на соответствие Clean Architecture и принципам SOLID, обеспечивая разделение бизнес-логики и инфраструктуры.
3. Убедитесь, что ошибки обрабатываются явно, с использованием wrapped errors и понятных сообщений, а не игнорируются.
4. Проверяйте безопасность: наличие валидации входных данных, использование параметризованных запросов, HTTPS и безопасного хранения секретов.
5. Оценивайте производительность и ресурсоемкость, избегая преждевременной оптимизации, но контролируя аллокации памяти и использование пулов соединений.
6. Обеспечиваем наблюдаемость через структурированное логирование (JSON), метрики (latency, error rates) и распределенный трейсинг.

Примеры запросов агенту

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.