scope-creep-detector
Анализирует git diffs, чтобы выявить scope creep: нерелевантные файлы, широкие PR, изменения, выходящие за рамки фикса, и лишние зависимости. Полезно, когда нужно оценить, не разросся ли PR, и получить рекомендации по разделению или обоснованию изменений. Работает локально и офлайн.
Что делает навык
Анализ git-диффов для выявления scope creep: нерелевантных файлов, широких PR и изменений, выходящих за рамки заявленной цели. Skill определяет, нужно ли разделить изменения, обосновать их или оставить как есть, предоставляя рекомендации на основе анализа сигналов.
Когда применять
- Перед созданием pull request, чтобы убедиться, что изменения соответствуют заявленной цели
- При исправлении бага, который затрагивает неожиданные файлы или подсистемы
- Когда пользователь спрашивает, слишком ли широки staged-изменения
- При наличии в diff зависимостей, публичных API, конфигураций, CI или билд-изменений
- Когда требуется конкретный план разделения смешанных изменений
Как работает
- Установить намерение (intent) на основе описания задачи или имени ветки
- Запустить скрипт scope_creep.py с указанием репозитория, намерения и источника диффа (working tree, staged, branch diff или файл)
- Получить JSON-ответ с классификацией изменений (in_scope, likely_creep, new_deps, api_renames, config_edits, stats)
- Проанализировать сигналы из likely_creep и других категорий, используя справочник references/scope-signals.md
- Присвоить каждому элементу likely_creep статус: Keep (необходимо), Split (можно разделить) или Justify (требует обоснования)
- Сформировать отчет с рекомендациями и предложением по группировке изменений, не применяя изменения без согласия пользователя
Примеры запросов агенту
Что понадобится
- Python 3 и скрипт scripts/scope_creep.py из репозитория
- Доступ к git-репозиторию и возможность чтения его истории и диффов
- Справочник references/scope-signals.md для интерпретации сигналов
Описание составлено по SKILL.md навыка, сверено 09.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.