dependency-upgrade — команда для Claude Code
Команда dependency-upgrade для Claude Code поочерёдно обновляет зависимости, запускает тесты после каждого пакета и откатывает изменения при ошибках.
MIT ★ 1 424 обновлён 2026-10-06
.claude/commands/dependency-upgrade.mdЧто делает dependency-upgrade
Команда автоматизирует рутинное обновление библиотек для Node.js, Python, Rust и Go. Сначала она проверяет статус рабочей директории и запускает базовый набор тестов. Если тесты уже падают или в репозитории остались незакоммиченные файлы, процесс немедленно останавливается.
Затем утилита собирает список устаревших пакетов и делит их на патчи, минорные и мажорные версии. Обновление идёт строго по одному пакету, начиная с наименее рискованных патчей. Для каждого шага команда изучает changelog, выполняет обновление через менеджер пакетов и сразу запускает тесты. При успехе создаётся коммит формата chore(deps): upgrade ..., а в случае поломки изменения сбрасываются через git checkout -- . с восстановлением исходных файлов из локфайла.
Команда требует настроенный тестовый набор в проекте, иначе проверка каждого шага теряет смысл.
Какие задачи решает
- обновить зависимости строго по одной с прогоном тестов
- автоматически откатить сломанное обновление пакета до исходного состояния
- разобрать устаревшие пакеты по степени риска от патчей до мажорных версий
- сохранить зелёный статус тестов на каждом этапе обновления
Примеры запросов агенту
- /dependency-upgrade
- /dependency-upgrade react
- /dependency-upgrade pydantic
Как установить dependency-upgrade
Вручную: положить файлы
.claude/commands/dependency-upgrade.mdВызов — /dependency-upgrade. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/dependency-upgrade.mdВызов — /prompts:dependency-upgrade. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/dependency-upgrade.prompt.mdВручную: положить файлы
.gemini/commands/dependency-upgrade.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о dependency-upgrade
Как установить dependency-upgrade в Claude Code?
Сохраните файл команды по пути .claude/commands/dependency-upgrade.md в вашем проекте.
Что делает dependency-upgrade?
Команда находит устаревшие зависимости, сортирует их по уровню риска, поочерёдно накатывает обновления и тестирует сборку после каждого шага.
Что произойдёт, если тесты упадут после обновления библиотеки?
Команда выполнит откат с помощью git checkout -- ., переустановит зависимости из сохранённого локфайла, зафиксирует причину сбоя в отчёте и перейдёт к следующему пакету.
Исходный текст
dependency-upgrade.md · MIT
--- allowed-tools: Bash(git:*), Bash(npm:*), Bash(npx:*), Bash(yarn:*), Bash(pnpm:*), Bash(bun:*), Bash(pip:*), Bash(uv:*), Bash(python:*), Bash(cargo:*), Bash(go:*), Read, Edit, WebFetch description: Safe, one-at-a-time dependency upgrades with verification after each. Detects package manager automatically. argument-hint: "[specific package name, or blank for all outdated]" --- # Dependency Upgrade Safely upgrade dependencies one at a time with testing between each upgrade. ## Context - Project root files (infer the package manager from the lockfile present): !`ls -a` - Current branch: !`git branch --show-current` - Working tree status: !`git status --short` - Node version (if applicable): !`node --version 2>/dev/null || echo "N/A"` - Python version (if applicable): !`python3 --version 2>/dev/null || echo "N/A"` ## Workflow ### Phase 1: Detect Environment 1. Identify the package manager from context above 2. Confirm a clean working tree. If there are uncommitted changes, stop and ask the user how to proceed — do not stash or commit their work yourself 3. Ensure tests pass BEFORE any upgrades — this is the baseline: - Node.js: `npm test` / `yarn test` / `pnpm test` / `bun test` - Python: `pytest` / `python -m pytest` - Rust: `cargo test` - Go: `go test ./...` 4. If baseline tests fail, STOP and report — do not upgrade on a broken baseline ### Phase 2: List Outdated Dependencies Run the appropriate outdated command: - npm: `npm outdated --json` - yarn: `yarn outdated` - pnpm: `pnpm outdated` - bun: `bun outdated` - pip/uv: `uv pip list --outdated` or `pip list --outdated --format=json` - cargo: `cargo outdated` (if installed) or check Cargo.toml - go: `go list -m -u all` ### Phase 3: Categorize Updates Sort dependencies into risk categories: ``` ## Outdated Dependencies ### Patch Updates (safe — bug fixes only) | Package | Current | Latest | Notes | |---------|---------|--------|-------| | ... | ... | ... | ... | ### Minor Updates (review — new features, possible deprecations) | Package | Current | Latest | Notes | |---------|---------|--------|-------| | ... | ... | ... | ... | ### Major Updates (careful — breaking changes expected) | Package | Current | Latest | Notes | |---------|---------|--------|-------| | ... | ... | ... | ... | ``` If `$ARGUMENTS` specifies a package, focus only on that package. ### Phase 4: Upgrade One at a Time Process in this order: patches first, then minors, then majors. For EACH dependency: 1. **Announce** which package is being upgraded and from/to versions 2. **Check changelog/release notes** for breaking changes: - Look at the package's GitHub releases or CHANGELOG - For major upgrades, summarize breaking changes before proceeding 3. **Upgrade** the single package: - npm: `npm install package@latest` - yarn: `yarn upgrade package@latest` - pnpm: `pnpm update package@latest` - bun: `bun update package` - uv: `uv lock --upgrade-package package && uv sync` - pip: `pip install --upgrade package` - cargo: update version in Cargo.toml, then `cargo update -p package` - go: `go get package@latest && go mod tidy` 4. **Run tests** immediately 5. **If tests PASS:** - Commit: `chore(deps): upgrade [package] from [old] to [new]` - Continue to next package 6. **If tests FAIL:** - Revert: `git checkout -- .`, then reinstall from the restored lockfile (`npm ci`, `yarn install --frozen-lockfile`, `pnpm install --frozen-lockfile`, `uv sync`) so the installed packages match it again - Record the failure reason - If it is a minor/patch with failing tests, flag as unexpected - Move to the next package ### Phase 5: Summary Report ``` ## Dependency Upgrade Report ### Successfully Upgraded | Package | From | To | Type | |---------|------|----|------| | ... | ... | ...| patch/minor/major | ### Failed (Reverted) | Package | From | To | Failure Reason | |---------|------|----|----------------| | ... | ... | ...| ... | ### Skipped | Package | From | To | Reason | |---------|------|----|--------| | ... | ... | ...| ... | ### Test Results - Baseline: [pass/fail] - Final: [pass/fail] - Total upgrades attempted: [count] - Successful: [count] - Reverted: [count] ``` ## Target $ARGUMENTS If no target specified, process all outdated dependencies in order of risk (patches first).
© CloudAI-X · MIT · CloudAI-X/claude-workflow-v2