# 누적 끌어오기 요청에 대한 빠른 시작

gh stack 확장을 GitHub CLI 설치하고 첫 번째 누적 끌어오기 요청 집합을 만듭니다.

> \[!NOTE] 이 기능은 공개 미리 보기로 제공되며 변경될 수 있습니다.

누적 끌어오기 요청을 사용하여 큰 코드 변경 내용을 독립적으로 검토하고 병합할 수 있는 더 작은 종속 끌어오기 요청 체인으로 분할합니다.

스택은 동일한 리포지토리에 있는 일련의 끌어오기 요청으로, 각 끌어오기 요청이 아래 끌어오기 요청의 분기를 대상으로 하여 단일 분기(일반적으로 주 분기)에 배치되는 순서가 지정된 체인을 형성합니다. 하나의 큰 끌어오기 요청 대신 더 작은 끌어오기 요청 집합을 가져옵니다. 각 끌어오기 요청에는 고유한 포커스가 있는 diff가 있으므로 팀원은 각 계층을 독립적으로 검토하고 승인할 수 있습니다.

## 사전 요구 사항

* GitHub CLI (`gh`) 2.90.0 이상 및 Git 2.20 이상
  * 를 사용하여 인증 GitHub CLI 합니다 `gh auth login`.
* GitHub 푸시할 수 있는 리포지토리입니다.

## CLI 확장 설치

```shell copy
gh extension install github/gh-stack
```

> \[!TIP]
> AI GitHub Copilot코딩 에이전트와 함께 누적 끌어오기 요청을 사용하려면 기술을 설치 `gh-stack` 합니다.
>
> ```shell copy
> gh skill install github/gh-stack
> ```

## 첫 번째 스택 만들기

1. 스택을 초기화하려면 리포지토리로 이동하고 다음 명령을 실행합니다. 그러면 추적 항목과 첫 번째 분기가 만들어집니다.

   ```shell copy
   gh stack init
   ```

   첫 번째 분기의 이름을 지정하라는 메시지가 표시됩니다. 기본적으로 스택은 리포지토리의 기본 분기(예: `main`트렁크)를 사용하지만 스택은 모든 분기를 대상으로 할 수 있습니다.

2. 코드 작성, 변경 단계 변경 및 커밋과 같은 첫 번째 분기에서 평소와 같이 작업합니다.

   ```shell
   # ... write code ...
   git add .
   git commit -m "helpful-commit-message"
   ```

3. 다음 논리 작업 단위에 대한 준비가 되면 스택의 맨 위에 새 분기를 추가합니다.

   ```shell copy
   gh stack add BRANCH-NAME
   # ... write code ...
   git add .
   git commit -m "Another-helpful-commit-message"
   ```

4. 모든 분기를 원격으로 푸시합니다.

   ```shell copy
   gh stack push
   ```

5. 끌어오기 요청을 만들고 스택으로 연결합니다 GitHub.

   ```shell copy
   gh stack submit
   ```

   각 끌어오기 요청은 올바른 기본 분기를 사용하여 생성됩니다. 첫 번째 분기 대상 및 `main`다음 분기는 첫 번째 분기 `BRANCH-NAME` 를 대상으로 합니다. 검토자는 해당 계층에 대한 차이만 볼 수 있습니다. 끌어오기 요청은 스택 GitHub 으로 자동으로 연결되며 순서를 확인하고 빠르게 탐색할 수 있습니다.

6. 스택을 보고 언제든지 전체 상태를 확인합니다.

   ```shell copy
   gh stack view
   ```

   이 명령은 모든 분기, 끌어오기 요청 링크, 상태 및 각각에 대한 가장 최근 커밋을 표시합니다.

7. 모든 변경 내용을 스테이징하고, 커밋하고, 한 단계에서 다음 분기를 만드는 데 사용합니다 `gh stack add -Am "MESSAGE"` . 별도의 `git add` 또는 `git commit`.이 필요하지 않습니다. 현재 분기에 아직 커밋이 없으면 커밋이 해당 지점에 배치됩니다. 커밋이 이미 있으면 새 분기가 만들어집니다.

   ```shell
   # Commit lands on the current branch
   gh stack add -Am "Auth middleware"

   # Current branch already has commits, so this creates the next branch
   gh stack add -Am "API routes"
   ```

8. 준비가 되면 모든 항목을 푸시하고 끌어오기 요청을 만듭니다.

   ```shell copy
   gh stack submit
   ```

## 다음 단계

* [누적 끌어오기 요청 관리](/ko/pull-requests/how-tos/create-pull-requests/managing-stacked-pull-requests)
* [누적 끌어오기 요청 병합](/ko/pull-requests/how-tos/merge-and-close-pull-requests/merging-stacked-pull-requests)
* [끌어오기 요청에 AI 생성 코드 스택](/ko/copilot/tutorials/stack-ai-generated-code-in-pull-requests)
* [조직에 누적 끌어오기 요청 롤아웃](/ko/pull-requests/tutorials/roll-out-stacked-prs)