clojure-review
Проверка кода Clojure на нарушения стиля
Этот навык помогает разработчикам проверять изменения кода Clojure и ClojureScript в соответствии со стандартами кодирования Metabase. Он проверяет нарушения стиля, проблемы качества кода и соответствие установленным соглашениям.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «clojure-review». Review this Clojure function for style violations
Ожидаемый результат:
- ⚠️ Именование: Чистая функция 'get-user' должна быть существительным. Рассмотрите 'user' вместо этого.
- ⚠️ Видимость: Эта функция используется только в этом пространстве имён, но не помечена ^:private.
- ✓ Длина функции (15 строк) приемлема (меньше 20 строк).
- ✓ Kebab-case правильно используется для локальных связываний.
- ⚠️ Отсутствует docstring: Публичная функция требует документации с объяснением назначения.
Использование «clojure-review». Check if this API endpoint follows conventions
Ожидаемый результат:
- ✓ Схема ответа присутствует (:- <schema>)
- ✓ Параметры запроса используют kebab-case
- ✓ Маршрут использует существительное в единственном числе (/api/dashboard/:id)
- ⚠️ Тело запроса использует kebab-case вместо snake_case
- ✓ Malli схема присутствует для параметров
Аудит безопасности
БезопасноPure documentation skill containing only markdown guidelines for Clojure code review. No executable code, no network calls, no file system modifications, and no command execution capabilities. The scanner flagged documentation formatting and metadata identifiers as false positives.
Факторы риска
🌐 Доступ к сети (1)
📁 Доступ к файловой системе (2)
⚙️ Внешние команды (148)
Оценка качества
Что вы можете построить
Проверка изменений PR
Сканирование diff-файлов pull request на нарушения стиля Clojure перед слиянием в основную ветку.
Применение руководства по стилю
Проверка того, что весь новый код следует соглашениям Metabase по именованию, документации и организации.
Проверка вкладов
Проверка соответствия вклада сообщества стандартам проекта перед отправкой.
Попробуйте эти промпты
Проверьте этот файл Clojure на нарушения соглашений об именовании. Проверьте: kebab-case, имена функций существительные, функции с побочными эффектами заканчиваются на !
Проверьте это пространство имён на отсутствие docstrings у публичных vars. Отметьте любую публичную функцию без docstring, объясняющей её назначение, входы и выходы.
Проверьте эти API эндпоинты на нарушения соглашений. Проверьте: kebab-case параметры запроса, snake_case тела, единственные имена маршрутов, схемы ответов, Malli схемы параметров.
Проверьте все изменения Clojure в этом PR в соответствии с руководством по стилю Metabase. Сообщите: нарушения именования, отсутствующие docstrings, проблемы организации, проблемы соглашений API, проблемы паттернов тестирования. Не сообщайте о проблемах, обнаруживаемых линтером, таких как отсутствующие скобки.
Лучшие практики
- Сначала запустите команды линтинга (./bin/mage kondo-updated master) перед ручной проверкой.
- Сначала просмотрите краткий чеклист для эффективного сканирования распространённых проблем.
- Сосредоточьтесь на паттернах статического анализа; не пытайтесь выполнять проверяемый код.
Избегать
- Не публикуйте поздравительные комментарии для тривиальных изменений или соответствия стилю.
- Не пытайтесь автоматически применять исправления без проверки.
- Не проверяйте отсутствующие скобки (это делает линтер).