gstack-upgrade

gstack-upgrade 스킬 개요

gstack-upgrade가 하는 일

gstack-upgrade는 gstack 자체를 업데이트하고 싶을 때 사용하는 스킬입니다. 단일 워크플로 단계에 패치를 적용하는 수준이 아니라, 전역 설치인지 vendored 레이아웃인지 먼저 감지한 뒤 업그레이드 경로를 실행하고, 무엇이 바뀌었는지까지 보여 줘서 결과를 빠르게 확인할 수 있게 합니다. 설정을 망가뜨리지 않고 이 도구만 안전하게 업데이트하는 gstack-upgrade 가이드가 필요하다면 이 스킬이 딱 맞습니다.

누가 설치하면 좋은가

gstack 기반 워크플로를 운영하거나, ~/.claude/skills 아래에 저장된 Claude Code skills를 사용하거나, repo를 수동으로 뒤지지 않고 업그레이드를 처리하고 싶다면 gstack-upgrade 스킬을 설치하는 것이 좋습니다. 특히 전역 업그레이드를 해야 하는지 로컬 업그레이드를 해야 하는지 추측하지 않아도 되도록, 설치 방식의 차이를 스킬이 자동으로 처리해 주길 원하는 사용자에게 유용합니다.

왜 다른가

gstack-upgrade for Workflow Automation의 핵심 가치는 일반적인 프롬프트형 스킬이 아니라 업그레이드 중심으로 설계되어 있다는 점입니다. 이 스킬은 버전 인식 동작, 사용자 확인, 백업/복원 로직, 마이그레이션 스크립트를 중심으로 만들어졌습니다. 그래서 설치 이력이 남아 있는 환경에서는, 깨끗한 상태만 가정하는 일회성 “업데이트해 줘” 프롬프트보다 훨씬 신뢰할 수 있습니다.

gstack-upgrade 스킬 사용 방법

설치하고 컨텍스트를 로드하기

환경에서 지원한다면 디렉터리의 설치 명령을 먼저 사용하고, 그다음 Claude Code가 이름으로 스킬을 불러오게 하세요. 이 repo에서 문서화된 설치 방식은 다음과 같습니다:
npx skills add garrytan/gstack --skill gstack-upgrade

설치한 뒤에는 먼저 SKILL.md를 여세요. 그다음 SKILL.md.tmpl과 migrations/ 아래의 마이그레이션 스크립트를 읽어, 스킬에 실행을 맡기기 전에 실제 업그레이드 단계와 버전별 예외 상황을 파악하세요.

스킬에 맞는 시작 프롬프트 주기

좋은 gstack-upgrade usage 프롬프트는 짧지만 구체적이어야 합니다. 예: “현재 설치된 버전에서 최신 릴리스로 gstack를 업그레이드하고, 검토가 필요한 항목이 있으면 알려줘.” 이미 설치 형태를 알고 있다면 그것도 함께 말하세요. 예: “이건 ~/.claude/skills 아래의 vendored install이야. 안전하게 업그레이드하고 백업을 유지해 줘.”

더 강한 입력에는 다음이 포함됩니다:

• 알고 있다면 현재 버전
• 자동 업그레이드 동작을 원하는지 여부
• 파일을 바꾸기 전에 확인이 필요한지 여부
• 오프라인 작업, 제한된 셸 접근, 커스텀 skills 경로 같은 제약 조건

먼저 읽어야 할 파일

의사결정 품질을 높이려면 랜딩 페이지보다 실제 동작을 결정하는 파일을 먼저 확인하세요:

• SKILL.md는 실질적인 업그레이드 흐름
• SKILL.md.tmpl은 작성된 원본 기준
• migrations/v0.15.2.0.sh는 디렉터리 구조 수정
• migrations/v1.0.0.0.sh는 첫 실행 프롬프트 동작
• migrations/v1.1.3.0.sh는 설치 정리 로직
• migrations/v1.17.0.0.sh와 migrations/v1.27.0.0.sh는 이후의 이름 변경 및 연결 변경

실무 워크플로 팁

이 스킬은 개념적인 changelog가 아니라 검증까지 포함한 업그레이드가 필요할 때 쓰세요. 가장 중요한 입력은 설치가 global인지 vendored인지, 아니면 혼합형인지입니다. 스킬이 어떤 경로를 건드려야 하는지가 여기서 달라지기 때문입니다. 자동 승인이 설정된 환경에서 실행한다면, GSTACK_AUTO_UPGRADE=1 또는 설정 기반 auto-upgrade가 이미 활성화되어 있는지도 먼저 확인한 뒤 스킬을 호출하세요.

gstack-upgrade 스킬 FAQ

gstack-upgrade는 업그레이드 전용인가요?

네. gstack-upgrade skill은 gstack를 새 버전으로 옮기고 그 뒤처리까지 다루는 데 범위가 맞춰져 있습니다. 다른 repo 작업의 일반적인 문제 해결 도구가 아니며, 다른 프로젝트를 위한 별도 마이그레이션 계획을 대체하려는 목적도 아닙니다.

초보자도 사용할 수 있나요?

네. 설치 단계를 따르고 평이한 요청을 넣을 수만 있다면 초보자도 사용할 수 있습니다. 다만 설치 유형과 리스크 허용 범위를 명확히 말할 수 있는 사용자에게서 가장 좋은 결과가 나옵니다. 잘 모르겠다면 확인을 켠 일반 업그레이드를 요청하세요.

일반 프롬프트와는 어떻게 다른가요?

일반 프롬프트는 어시스턴트에게 “gstack를 업그레이드해 줘”라고만 요청할 수 있지만, gstack-upgrade는 버전별 워크플로, 확인 로직, 마이그레이션 인식 동작을 포함해 업그레이드를 더 안전하게 만듭니다. 설치 이력이 남아 있거나, 먼저 물어봐야 할지 자동 실행해야 할지를 스킬이 판단해야 할 때 특히 중요합니다.

언제 사용하지 말아야 하나요?

릴리스 노트만 읽고 싶을 때, 실제로 gstack를 사용하고 있지 않을 때, 또는 더 넓은 시스템 유지보수 도구가 필요할 때는 gstack-upgrade를 쓰지 마세요. 모든 파일 변경 전에 각 마이그레이션을 전부 수동 검토하고 싶다면 이 스킬은 적합하지 않습니다.

gstack-upgrade 스킬 개선 방법

버전과 설치 정보를 먼저 알려 주세요

품질을 가장 크게 높이는 방법은 무엇을 업그레이드하는지, 그리고 어디에 설치되어 있는지 처음부터 알려 주는 것입니다. “내 전역 gstack 설치를 v1.0에서 최신으로 업그레이드해 줘”는 “고쳐 줘”보다 훨씬 낫습니다. 스킬이 설치 유형에 맞춰 업그레이드 경로를 정하고, 불필요한 감지 작업을 피할 수 있기 때문입니다.

자동화 허용 범위를 분명히 하세요

gstack-upgrade 스킬이 빠르게 움직이길 원한다면 auto-upgrade를 허용하는지 명시하세요. 변경 전에 검토가 필요하다면 그것도 말하세요. 그러면 확인 단계의 모호함이 줄고, UPGRADE_AVAILABLE을 만났을 때 더 안전한 분기를 선택하는 데 도움이 됩니다.

마이그레이션에 민감한 사례를 챙기세요

가장 흔한 실패 지점은 모든 설치가 깨끗하다고 가정하는 것입니다. 오래된 설치에는 디렉터리 구조 복구, resource-log 마이그레이션, 프롬프트 스타일 변경, repo 이름 변경 처리 같은 작업이 필요할 수 있습니다. 환경에 이런 이력의 흔적이 있다면 요청에 함께 적어 두세요. 업그레이드가 나중에 다시 발견하지 않도록, 처음부터 확인할 수 있습니다.

첫 결과를 바탕으로 반복하세요

첫 업그레이드가 끝나면 새 동작이 워크플로와 맞는지 확인하세요. 설치 위치, 확인 방식, 바뀐 프롬프트 기본값이 특히 중요합니다. 어딘가 어색하다면, 그 불일치만 고치는 후속 요청을 하세요. 예: “간결한 문체를 유지해 줘”, “이전 업그레이드 확인 동작을 복원해 줘”, “백업을 유지한 상태로 다시 실행해 줘.”