debug-generated-project — скилл для Claude Code: установка и разбор
Помогает разбирать ошибки генерации, сборки и падений в проектах Tuist. Воспроизводит сбой в чистом каталоге, тестирует ветку main и находит причину.
npx skills add tuist/agent-skills --skill debug-generated-project -a claude-codeЧто делает debug-generated-project
Агент опрашивает разработчика о деталях сбоя, манифестах Project.swift и фазе ошибки (генерация, компиляция или запуск). Затем разворачивает изолированный тестовый проект во временной папке и проверяет поведение на свежем релизе через mise.
Если сбой воспроизводится, скилл клонирует репозиторий Tuist, компилирует бинарник и библиотеку ProjectDescription через swift build, после чего тестирует проект на ветке main. По итогам агент предлагает исправление манифеста при неверной конфигурации, готовит pull request с архивом репродукции либо собирает данные для тикета в GitHub Issues.
Для глубокой проверки компиляции и падений в рантайме требуются установленный Xcode, xcodebuild и работающий симулятор iOS.
Какие задачи решает
- локализовать ошибки в манифестах Project.swift и Tuist.swift
- воспроизвести сбой генерации на чистом временном проекте
- протестировать исправление на исходном коде Tuist из ветки main
- отладить аварийное завершение приложения в симуляторе iOS
Примеры запросов агенту
- Проверь, почему tuist generate падает с ошибкой в Project.swift
- Сборка проекта после генерации Tuist ломается на линковке зависимостей
- Приложение крашится на старте в симуляторе после генерации через Tuist
Как установить debug-generated-project
1Через Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill debug-generated-project -a claude-code2Вручную: положить файлы
~/.claude/skills/debug-generated-project/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/debug-generated-project/
1Через Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill debug-generated-project -a codex2Вручную: положить файлы
.agents/skills/debug-generated-project/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill debug-generated-project -a cursor2Вручную: положить файлы
.cursor/skills/debug-generated-project/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tuist/agent-skills debug-generated-project2Вручную: положить файлы
.github/skills/debug-generated-project/SKILL.md1Через Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill debug-generated-project -a gemini-cli2Командой платформы
gemini skills install https://github.com/tuist/agent-skills --path skills/debug-generated-projectВручную: положить файлы
.devin/skills/debug-generated-project/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill debug-generated-project -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о debug-generated-project
Как установить debug-generated-project в Claude Code?
Выполните команду npx skills add tuist/agent-skills --skill debug-generated-project -a claude-code.
Что делает скилл debug-generated-project?
Он воспроизводит ошибку проекта Tuist во временной директории, проверяет её на последнем релизе и ветке main, а затем выясняет, вызвана ли проблема багом или ошибкой в настройках.
Какие инструменты нужны для работы скилла?
Потребуются утилита mise для запуска релизов Tuist, Swift для компиляции Tuist из исходников, а также xcodebuild и симуляторы simctl для проверки сборки и запуска.
