К основному содержанию
команда CX Codex

dependency-upgrade — команда для Claude Code

Команда dependency-upgrade для Claude Code поочерёдно обновляет зависимости, запускает тесты после каждого пакета и откатывает изменения при ошибках.

MIT ★ 1 424 обновлён 2026-10-06

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/dependency-upgrade.md
Открыть на GitHub

Что делает 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/

Вопросы о 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

Похожие слэш-команды

Все слэш-команды по теме «DevOps и инфраструктура» →
dependency-triage Cobus Greyling Скилл dependency-triage сканирует манифесты и локфайлы пакетов на уязвимости и устаревшие версии. Помогает приоритизировать обновления зависимостей в проекте. CX Codex +1 ★ 11 819звёзд репо dependency-audit davila7 Команда dependency-audit проверяет зависимости проекта на уязвимости, лицензионные ограничения и устаревшие версии через пакетные менеджеры. CX Codex +1 658установок deps-upgrade Seth Hobson Команда deps-upgrade для Claude Code планирует и выполняет постепенное обновление зависимостей. Она проверяет версии, ищет изменения с несовместимостями и задаёт тесты для проверки. CX Codex +1 ★ 42 780звёзд репо dependency-updater softaworks Плагин dependency-updater для Claude Code, который обновляет зависимости в любом языке. Распознаёт тип проекта, применяет безопасные обновления автоматически, мажорные версии предлагает подтвердить. ★ 2 707звёзд репо version-sentinel KSEGIT Плагин version-sentinel для Claude Code блокирует добавление, обновление и откат пакета, пока агент не сверит версию в реестре и не запишет источник. ★ 6звёзд репо dependency-checker davila7 Хук dependency-checker для Claude Code проверяет зависимости после правок файлов манифестов. Он отслеживает устаревшие пакеты, уязвимости и совместимость лицензий. 2 314установок

Из того же набора46

Весь набор →
analyzing-projects Скилл analyzing-projects разбирает незнакомый репозиторий по шагам: стек, структура, паттерны, команды разработки — пригодится при входе в новый проект. CX Codex +1 ★ 1 424звёзд репо plan Создаёт и ведёт файл PLAN.md в корне проекта для фиксации этапов разработки, зависимостей между задачами и лога прогресса. CX Codex +1 ★ 1 424звёзд репо refactor-guided Команда refactor-guided проводит структурный рефакторинг по шагам и проверяет тесты после каждого изменения. Подходит для безопасной перестройки кода без добавления функций. CX Codex +1 ★ 1 424звёзд репо convex-backend Скилл convex-backend загружает guidelines для работы с Convex: функции, схемы, валидаторы, queries, mutations, actions, подписки и хранилище файлов. Помогает писать типобезопасный бэкенд на TypeScript. CX Codex +1 ★ 1 424звёзд репо designing-apis Скилл designing-apis в Claude Code проектирует REST и GraphQL API: структурирует эндпоинты, описывает форматы запросов и ответов, настраивает обработку ошибок и версионирование. CX Codex +1 ★ 1 424звёзд репо parallel-analyze Команда parallel-analyze запускает четыре субагента разом: архитектура, безопасность, производительность и тесты. Сводит их находки в один отчёт с приоритетами. CX Codex +1 ★ 1 424звёзд репо managing-git Скилл managing-git помогает Claude Code вести ветки по GitHub Flow или Git Flow, оформлять коммиты по Conventional Commits и готовить пулл-реквесты по чек-листам. CX Codex +1 ★ 1 424звёзд репо code-reviewer Субагент code-reviewer для Claude, который читает изменённые файлы и выдаёт разбор по severity: логика, безопасность, производительность, тесты. CX Codex ★ 1 424звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой