gjalla-spec — скилл для Claude Code: что делает и как установить
Скилл заставляет агента проектировать нетривиальные функции до написания кода: формулировать цели, архитектурные требования, тесты и план отката.
npx skills add gjalla/engineering --skill gjalla-spec -a claude-codeЧто делает gjalla-spec
Скилл запускает структурированное проектирование изменений перед реализацией задач. Сначала ассистент обращается к gjalla через CLI или MCP-сервер, чтобы изучить архитектуру и потоки данных из мастер-спецификации. При необходимости модель запрашивает недостающие детали у разработчика. Затем утилита gjalla spec new создаёт шаблон документа.
Документ описывает проблему, модель угроз, архитектурные изменения и сценарии отката. Для каждого требования скилл предписывает называть файл и функцию, которые за него отвечают. Также нужно заранее определить хотя бы один тест, падающий до внесения правок. Без установленного инструмента gjalla агент не сможет создать шаблон и связать документ с мастер-спецификацией.
Перед написанием кода модель обязана показать подготовленный план человеку. Это блокирующий этап. Без явного подтверждения разработчика переходить к редактированию файлов запрещено. В Claude Code подтверждение фиксируется платформой автоматически.
Какие задачи решает
- Спроектировать изменение архитектуры до редактирования файлов
- Зафиксировать требования к безопасности и модель угроз до написания кода
- Определить падающий тест для проверки будущей реализации
- Согласовать план работ с разработчиком перед внедрением
Примеры запросов агенту
- Спланируй добавление двухфакторной аутентификации через gjalla-spec
- Подготовь спецификацию на рефакторинг обработчика заказов
- Создай план внедрения нового API эндпоинта с проверкой безопасности
Как установить gjalla-spec
1Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-spec -a claude-code2Вручную: положить файлы
~/.claude/skills/gjalla-spec/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gjalla-spec/
1Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-spec -a codex2Вручную: положить файлы
.agents/skills/gjalla-spec/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-spec -a cursor2Вручную: положить файлы
.cursor/skills/gjalla-spec/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gjalla/engineering gjalla-spec2Вручную: положить файлы
.github/skills/gjalla-spec/SKILL.md1Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-spec -a gemini-cli2Командой платформы
gemini skills install https://github.com/gjalla/engineering --path skills/gjalla-specВручную: положить файлы
.devin/skills/gjalla-spec/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-spec -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gjalla-spec
Как установить gjalla-spec в Claude Code?
Выполните команду npx skills add gjalla/engineering --skill gjalla-spec -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/gjalla-spec/SKILL.md.
Что делает скилл gjalla-spec?
Он направляет агента по шагам предварительного анализа: чтение мастер-спецификации, генерация заготовки документа и формулирование строгих требований до написания кода.
Можно ли начать разработку без одобрения спецификации?
Нет. Инструкции скилла запрещают приступать к коду до явного подтверждения от пользователя в режиме плана или в диалоге.
