AIKraft/Skills/clojure-write

clojure-write

Помогает писать, разрабатывать и рефакторить код на Clojure и ClojureScript, следуя лучшим практикам и соглашениям. Использует REPL-ориентированный рабочий процесс. Подходит для проектов из репозитория metabase/metabase.

MEMetabase official Разработка ★ 49.6k

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

Навык помогает писать, разрабатывать и рефакторить код на Clojure и ClojureScript, следуя лучшим практикам и соглашениям проекта Metabase. Он обеспечивает REPL-ориентированный рабочий процесс для создания, тестирования и интеграции функций. Навык также регламентирует написание документационных строк (docstrings) и правила редактирования кода.

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

  • Разработка новых функций с использованием REPL-ориентированного подхода (сначала REPL, затем исходный код).
  • Рефакторинг существующего кода Clojure/ClojureScript с соблюдением соглашений по стилю и структуре.
  • Написание и проверка docstrings, чтобы они описывали контракт для вызывающего, а не детали реализации.
  • Исправление ошибок синтаксиса и проверка читаемости кода после изменений с помощью инструментов MCP или команд mage.

Как работает

  1. При наличии инструментов clojure-mcp (clojure_eval, clojure_edit) использовать их вместо shell-команд для прямой интеграции с REPL.
  2. Начинать разработку с написания и тестирования небольших, фундаментальных функций непосредственно в REPL.
  3. После успешного тестирования в REPL переносить код в файлы исходных кодов (соответствующие namespaces).
  4. Строить сложные функции путем композиции уже протестированных базовых функций, проверяя каждую композицию в REPL.
  5. При редактировании кода следить за количеством скобок, выравниванием столбцов и отсутствием пробелов в конце строк.
  6. После каждого изменения проверять читаемость кода командой -check-readable и завершать файлы новой строкой.

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

Напиши функцию для подключения к базе данных, используя REPL для тестирования, а затем перенеси её в исходный код.
Проверь docstring функции на соответствие контракту: убери детали реализации и оставь только требования к вызывающему.
Рефактори этот код Clojure, убедившись, что после изменений он проходит проверку -check-readable и сохраняет выравнивание.

Что понадобится

  • Доступность инструментов clojure-mcp (clojure_eval, clojure_edit) или fallback на ./bin/mage.
  • Наличие файлов @./../_shared/development-workflow.md, @./../_shared/clojure-style-guide.md, @./../_shared/clojure-commands.md.
  • Окружение проекта Metabase с возможностью запуска ./bin/mage.

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

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

1Скачать навык
# возьмите папку навыка «clojure-write» из репозитория: # https://github.com/metabase/metabase
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r clojure-write/ ~/.claude/skills/clojure-write/

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