review-architecture
Обзор архитектуры на соответствие стандартам качества кода
Обеспечьте соответствие вашего кода архитектурным стандартам и следование установленным паттернам. Этот навык предоставляет систематические обзоры архитектуры для создания последовательных и поддерживаемых кодовых баз в проектах Spring Boot и Next.js.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "review-architecture". Проверьте этот Spring Boot контроллер на соответствие архитектурным требованиям
النتيجة المتوقعة:
- ✅ Структура пакетов: Корректно размещён в пакете контроллера
- ✅ Соглашения об именах: RESTful эндпоинт без глаголов
- ✅ Аннотации: Правильное использование @RestController и @RequestMapping
- ✅ Валидация: Аннотация @Valid реализована
- ❌ Нарушение DRY: Следует использовать SecurityUtils.getCurrentUserId()
- ❌ Документация: Новый код ошибки не добавлен в error-codes.md
- ⚠️ Общее: Хорошая структура с небольшими улучшениями
استخدام "review-architecture". Проанализируйте этот Next.js компонент страницы на соответствие стандартам качества
النتيجة المتوقعة:
- ✅ TypeScript strict mode: Ошибок не обнаружено
- ✅ Server/Client Component: Корректно помечен
- ✅ shadcn/ui: Компонент Button используется правильно
- ❌ React Hooks: Отсутствует функция очистки в useEffect
- ❌ Экспорт: Именованный экспорт должен быть в момент определения
- ⚠️ Общее: Требуется исправление незначительных проблем перед слиянием
التدقيق الأمني
آمنThis is a pure documentation skill with no executable code. The static scanner produced false positives by misidentifying documentation markup (backticks for code blocks), file path references, and documentation filenames as security vulnerabilities. No network calls, no command execution, no cryptographic operations exist in this skill.
عوامل الخطر
🌐 الوصول إلى الشبكة (1)
📁 الوصول إلى نظام الملفات (1)
⚙️ الأوامر الخارجية (41)
درجة الجودة
ماذا يمكنك بناءه
Согласованность архитектуры
Обеспечьте соответствие нового кода установленным архитектурным паттернам перед слиянием в основную ветку.
Контроль качества кода
Автоматизируйте процессы проверки кода для поддержания последовательных стандартов качества в команде.
Интеграция с CI/CD
Интегрируйте обзоры архитектуры в рабочие процессы CI/CD для раннего выявления проблем проектирования.
جرّب هذه الموجهات
Проверьте этот Spring Boot код на соответствие архитектурным требованиям: структура пакетов, соглашения об именах, принципы DRY и обновление документации.
Проанализируйте этот Next.js компонент на соответствие TypeScript strict mode, правильному использованию React Hooks и лучшим практикам shadcn/ui.
Проверьте эту реализацию API на соответствие принципам проектирования RESTful, правильным HTTP методам и согласованности документации OpenAPI.
Выполните полный обзор архитектуры этого pull request, охватывающий стандарты Java бэкенда, соответствие TypeScript фронтенда и согласованность документации.
أفضل الممارسات
- Всегда читайте документацию проекта перед началом проверок, чтобы понять контекст и требования
- Сосредоточьтесь только на новых изменениях - избегайте повторения уже решённых проблем из предыдущих проверок
- Предоставляйте конкретные, выполнимые рекомендации с путями к файлам и номерами строк для лёгкого исправления
تجنب
- Не проводите проверку без понимания стандартов кодирования и архитектурных паттернов проекта
- Избегайте общих рекомендаций - всегда ссылайтесь на конкретные правила из backend-rules.md или frontend-rules.md
- Никогда не одобряйте код, нарушающий обязательные требования, такие как @SuppressWarnings или любые типы в TypeScript