Community생산성 & 협업github.com

의존성 업그레이드 플래너

변경을 수행하기 전에 주요 변경 사항을 그룹화하고 위험을 식별하여 프로젝트 의존성을 안전하게 업그레이드할 수 있는 계획을 수립합니다. 사용자가 의존성 업그레이드, 패키지 업데이트, 메이저 버전 업, 취약하거나 오래된 패키지 해결, 프레임워크 마이그레이션 계획을 요청할 때 사용합니다. 애플리케이션 기능 작성이나 버그 수정에는 사용하지 마십시오.

의존성 업그레이드 플래너란 무엇인가요?

이 스킬은 개발자가 프로젝트 의존성을 업그레이드하기 전에 안전하고 체계적인 계획을 수립하도록 도와줍니다. 사용자가 의존성 업그레이드를 요청하면, 패키지 매니페스트를 분석하고 사용 가능한 버전을 확인한 후 업그레이드 항목을 보안 수정, 패치/마이너 업데이트, 주요 변경 사항으로 분류하여 단계별로 제시합니다. npm, pip, Go, Rust, Ruby 등 다양한 생태계를 지원하며, 각 단계별 검증 명령어와 롤백 방법까지 포함한 상세한 계획을 제공합니다. 실제 파일을 수정하지 않고 계획만 출력하므로 사용자가 승인한 후에만 변경이 이루어집니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/teejayfpi/agensi-skills/tree/add-agensi-skills/repo-maintenance-pack/skills/dependency-upgrade-planner

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

의존성 업그레이드 플래너은(는) 무엇을 하나요?

계획을 수립합니다. 사용자가 계획을 승인하기 전까지 아무것도 업그레이드하지 마십시오.

절차

  1. 매니페스트에서 생태계를 감지합니다: package.json, requirements.txt 또는 pyproject.toml, go.mod, Cargo.toml, Gemfile, pom.xml. 여러 개가 있다면 어떤 것을 계획할지 묻거나, 별도로 계획합니다.
  2. 매니페스트와 잠금 파일(package-lock.json, poetry.lock, go.sum, Cargo.lock, Gemfile.lock)에서 현재 버전을 읽습니다.
  3. 생태계 자체 도구를 사용하여 사용 가능한 버전을 찾고 실제로 얻은 출력을 보고합니다:
    • npm: npm outdated
    • Python: pip list --outdated 또는 uv pip list --outdated
    • Go: go list -u -m all
    • Rust: cargo outdated
    • Ruby: bundle outdated 도구를 사용할 수 없으면 그 사실을 알리고 매니페스트를 기준으로 작업하며 버전을 미확인으로 표시합니다.
  4. 각 오래된 패키지를 분류합니다:
    • 패치 / 마이너 — 일반적으로 안전합니다.
    • 메이저 — 계획을 세우기 전에 변경 로그나 릴리스 노트를 읽어 주요 변경 사항을 확인합니다.
    • 보안 — npm audit, pip-audit, govulncheck, cargo audit, 또는 bundle audit으로 플래그된 항목입니다. 이 항목들이 우선순위가 가장 높습니다.
  5. 작업을 배치로 정렬합니다:
    • 배치 0: 보안 수정 (메이저여도 포함).
    • 배치 1: 패치 및 마이너 업데이트, 영역별로 그룹화.
    • 배치 2: 교차 의존성이 없는 메이저 업데이트, 커밋당 하나씩.
    • 배치 3: 함께 이동해야 하는 메이저 업데이트 (예: 프레임워크와 그 플러그인).
  6. 각 배치에 대해 다음을 명시합니다: 패키지, 이전/이후 버전, 적용되는 주요 변경 사항, 변경해야 할 코드 또는 설정, 검증 방법.

출력 템플릿

## 업그레이드 계획

생태계: <npm / pip / go / cargo / ...>
매니페스트: <경로>

### 배치 0 — 보안
| 패키지 | 이전 | 이후 | 이유 | 주요 변경? |
| --- | --- | --- | --- | --- |

### 배치 1 — 패치 및 마이너
...

### 배치 2 — 메이저, 독립적
...

### 배치 3 — 메이저, 함께 이동 필요
...

### 검증

각 배치 후: <정확히 어떤 명령이 회귀가 없음을 증명하는지>

### 롤백

배치별: <되돌리는 방법, 예: 해당 배치 커밋을 git revert>

### 연기됨

<일부러 변경하지 않은 패키지와 그 이유>

규칙

  • 계획 중에 매니페스트를 절대 편집하지 마십시오. 계획을 출력하고 멈추십시오.
  • 메이저 업데이트에 대해 사용 가능한 경우 실제 변경 로그를 읽으십시오. 메이저 번호가 변경되었다고 해서 주요 변경 사항이 있다고 가정하지 마십시오.
  • 항상 검증 명령어를 명시하십시오. "테스트를 실행하세요"는 명령어가 아닙니다. npm test가 명령어입니다.
  • 패키지를 제외할 때 연기 이유를 명확히 적으십시오. 예를 들어 릴리스 노트를 읽을 수 없었던 메이저 업데이트.
  • 트리를 수정하는 install, upgrade, audit 명령어를 실행하지 마십시오. npm outdated, npm audit 및 그에 상응하는 명령어는 읽기 전용이며 안전합니다.

지원 파일

references/upgrade-strategy.md는 배치 처리, semver 엣지 케이스, 보류해야 하는 패키지 처리 방법을 설명합니다.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬