gh-stack 스택 PR 운영 가이드

무엇을 해주나

• gh stack 확장을 사용해 trunk 위에 쌓이는 스택형 브랜치·PR 체인을 만들고, 각 레이어가 자기 몫의 diff만 담도록 관리한다.
• 에이전트가 멈추지 않도록 비대화형 실행 규칙을 제공한다: view --json, submit --auto, merge <대상> --yes, init <브랜치> 등 반드시 붙여야 할 플래그와 절대 맨손으로 실행하면 안 되는 명령(TUI 전용 modify, switch)을 표로 정리.
• 레이어 소유권 판단, 하위 레이어 수정 후 rebase --upstack, sync/sync --prune, 스택 단위 머지(PR 번호 또는 스택 번호 범위, 머지 큐 동작) 절차를 단계로 안내.
• view --json 출력 스키마(trunk, branches[].pr, needsRebase 등)와 종료 코드 0~10별 복구 방법(리베이스 충돌, 스택 파일 잠금, API 실패 등)을 명시.
• 상황별로 references/stack-design.md, commands.md, troubleshooting.md를 골라 읽게 하는 트리거도 제공.

이런 분께 추천

• 큰 기능을 여러 개의 작은 PR로 나눠 리뷰받는 팀의 개발자.
• Claude Code 같은 에이전트에게 브랜치·PR 작업을 맡기면서 TUI 프롬프트에 걸려 멈추는 문제를 겪은 분.
• 모노레포·멀티 리모트 환경에서 --remote, remote.pushDefault, worktree 충돌을 자주 다루는 분.

활용 예시

1. "인증 → API → 프론트엔드 순으로 스택을 만들어 PR 올려줘" → gh stack init auth → 커밋 → gh stack add api → 커밋 → gh stack submit --auto로 드래프트 PR 생성.
2. 중간 레이어(api)에 수정이 필요할 때 → gh stack down으로 이동해 커밋 후 gh stack rebase --upstack으로 상위 전체 재적용 → gh stack top → gh stack push.
3. 리뷰가 끝난 아래쪽 PR들을 한 번에 정리 → gh stack merge 42 --yes --squash(해당 PR과 그 아래 미병합 PR 전체, 전부 성공 아니면 전부 취소) 후 gh stack sync --prune.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/molefrog/moi/HEAD/.agents/skills/gh-stack/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 molefrog/moi 의 .agents/skills/gh-stack 폴더를 내 ~/.claude/skills/gh-stack/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.