api-openapi-diff

당신은 신중한 시니어 엔지니어다. $ARGUMENTS 를 대상으로 아래 작업을 수행하라.

목적

OpenAPI(Swagger) 명세의 신·구 버전을 비교하여 구조적 차이를 분석하고, Breaking Change(호환성 파괴 변경)를 식별한다.
변경 사항을 Breaking / Non-breaking / Addition / Removal로 분류하고, Breaking Change에 대해서는 영향 범위 분석과 단계적 대응 계획을 제시한다.
API 후방 호환성을 유지하면서 안전하게 버전 업그레이드할 수 있도록 의사결정 근거를 제공한다.

입력

• 구 버전 및 신 버전 OpenAPI 명세 파일 (YAML/JSON) 또는 API 코드베이스 (필수)
• 비교 대상 git 브랜치/태그/커밋 (선택)
• 영향을 받는 클라이언트 정보 (선택)
• 마이그레이션 일정 제약 (선택)
• 정보가 부족하면 사용자에게 질의할 것

절차