make-pr

make-pr

레포에 PR 템플릿이 있으면 그 형식으로, 없으면 아래에 명시된 기본 형식으로 draft PR을 만들어요.

템플릿 탐색 → 브랜치·변경 확인 → stacked PR 여부(리뷰 단위 2+) → 문서 동기화 확인 → 본문 작성 → 확인 → gh pr create --draft
                                 └─ 예: gh-stack (gh stack init/submit)

사전 조건

gh가 인증되어 있어야 해요. 실패하면 안내하세요:

gh auth status || echo "gh 인증이 필요해요: gh auth login -h github.com"

절차

0. base 브랜치·docs 경로·PR 템플릿 결정

• base 브랜치: gh repo view --json defaultBranchRef -q .defaultBranchRef.name 으로 감지해요 (실패 시 main). 아래의 <base> 는 전부 이 값이에요.

• docs 경로: 환경변수 HARNESS_DOCS_PATH 를 읽고, 없으면 .claude/settings.local.json 의 env.HARNESS_DOCS_PATH 를 읽어요 (둘 다 없으면 docs). 아래의 <docsPath> 는 이 값이에요.

• PR 템플릿: GitHub 이 인식하는 위치를 훑어요 — 단일 파일과 다중 템플릿 디렉토리 둘 다예요:

  find .github docs . -maxdepth 1 -iname 'pull_request_template.md' 2>/dev/null
  find .github/PULL_REQUEST_TEMPLATE -name '*.md' 2>/dev/null
  

  (ls + glob 은 zsh 에서 매칭이 없을 때 2>/dev/null 로도 안 막히는 에러를 내니 find 로 통일해요.)

  • 후보가 하나면 그 파일을 읽어서 써요.
  • 여러 개면 목록을 보여주고 어느 템플릿을 쓸지 사용자에게 물어요.
  • 없으면 절차 4 의 기본 형식으로 가요.

1. 브랜치·변경 상태 확인

git branch --show-current
git status --porcelain
git log <base>..HEAD --oneline

• 현재 브랜치가 <base>면 중단하고, 별도 브랜치가 필요하다고 안내해요.
• 커밋 안 된 변경이 있으면 사용자에게 커밋/스태시 여부를 물어요.
• 원격에 브랜치가 없으면 gh pr create가 자동 push하지만, 필요 시 git push -u origin <branch>를 안내해요.

1.5 stacked PR 여부 (opt-in)

판단 기준은 커밋 개수가 아니라 리뷰 단위(관심사)가 2개 이상으로 나뉘는지예요. git log <base>..HEAD --oneline 과 변경 파일을 보고, 커밋들이 의존 순서가 있는 계층(예: 모델 → API → UI)으로 묶일 때만 AskUserQuestion 으로 "stacked PR로 나눌까요?"를 물어요. 커밋이 많아도 전부 한 관심사면 묻지 않고 단일 PR로 가요.

• 아니오 (기본) → 아래 2~5 그대로 진행 (단일 draft PR).

• 예 → 절차 2(문서 동기화)까지는 그대로 수행하고, 절차 3~5 대신 아래 gh-stack 흐름으로 생성해요.

  주의: gh stack 명령은 인자 없이 실행하면 대화형 프롬프트에 걸려 멈춰요. 반드시 아래처럼 브랜치 이름·플래그를 붙여요.

  1. 확장 설치 확인 — 없으면 안내하고 설치받아요:

     gh extension list | grep -qi gh-stack || echo "설치 필요: gh extension install github/gh-stack"
     git config rerere.enabled true   # init 시 대화형 프롬프트 방지