탐색으로 건너뛰기

병합 제안

한 브랜치의 변경 사항이 다른 브랜치에 반영되기 전에 검토를 요청하세요.

개요

병합 제안은 한 브랜치의 변경 사항을 다른 브랜치에 병합해 달라는 요청을 기록하고, 병합 전에 팀원이 diff를 검토할 수 있게 합니다. 에이전트 편집 권한이 있는 사람이라면 누구나 자신이 직접 병합할 수 없는 브랜치로도 제안을 열 수 있습니다. 제안을 병합하려면 여전히 대상 브랜치에 대한 쓰기 권한이 필요하므로, 모든 기여자에게 병합 권한을 부여하지 않고도 변경 사항을 보호된 브랜치에 반영할 수 있습니다.

병합 제안은 브랜치를 직접 병합하는 방식에 선택적인 검토 단계를 추가합니다. 대상 브랜치에 쓰기 권한이 있고 다른 사람의 의견이 필요하지 않다면 직접 병합하세요. 먼저 검토받고 싶거나 대상 브랜치가 보호되어 있어 쓰기 권한이 없다면 제안을 여세요.

제공 여부

병합 제안은 알파 단계입니다. 에이전트의 여러 브랜치가 동시에 진행되면 어떤 브랜치가 병합할 준비가 되었고 안전한지 추적하기 어려워집니다. 병합 제안은 팀이 한곳에서 브랜치의 변경 사항을 검토하고 논의하며, 브랜치 간 테스트 통과율을 비교하고, 브랜치의 최신 대화를 확인할 수 있게 합니다.

알파 버전은 GitHub의 풀 리퀘스트와 유사한 에이전트용 CI/CD 스타일 워크플로를 향한 첫 단계입니다. 향후 몇 주 내에 다음 기능이 추가될 예정입니다.

  • 제안을 병합하기 전에 반드시 통과해야 하는 필수 테스트
  • 특정 검토자에게 승인 요청
  • 에이전트의 각 부분에 대한 소유자 구성

제안 수명 주기

모든 제안에는 다음 상태 중 하나가 있습니다.

상태의미
열림검토 또는 병합 대기 중입니다.
병합됨소스 브랜치의 변경 사항이 대상 브랜치에 병합되었습니다.
닫힘작성자가 철회했거나, 다른 사람이 거부했거나, 소스 브랜치가 보관 처리되어 자동으로 닫혔습니다.

제안이 열려 있는 동안 검토자는 다음 판정 중 하나를 남깁니다. 검토자의 최신 판정은 같은 검토자가 이전에 남긴 판정을 대체합니다.

검토 상태의미
승인됨검토자가 변경 사항에 만족합니다.
변경 요청됨검토자가 병합 전에 해결할 사항이 있다고 판단합니다.

제안 열기

변경 사항을 검토받고 싶은 브랜치에서 제안을 여세요.

에이전트의 Branches 탭에서 소스 브랜치의 옵션 메뉴를 열고 Open merge proposal을 선택하세요.

브랜치 옵션 메뉴의 Open merge proposal 옵션

제안에 제목과 선택적 설명을 지정하고, 에이전트의 보관되지 않은 다른 브랜치 중에서 대상 브랜치를 선택하세요. 제안을 열어도 두 브랜치 중 어느 것도 변경되지 않으며, 요청만 기록됩니다.

하나의 소스 및 대상 브랜치 쌍에는 동시에 하나의 열린 제안만 있을 수 있습니다. 같은 두 브랜치 간에 다른 제안을 열려면 기존 제안을 먼저 닫으세요.

제안 검토하기

제안 페이지에는 다음 탭이 있습니다.

설명, 검토 이력, 검토를 남길 수 있는 양식입니다.

병합 제안의 Overview 탭

제안 작성자를 제외하고 에이전트 편집 권한이 있는 사람은 누구나 선택적 댓글과 함께 검토를 남길 수 있습니다. 댓글은 마크다운을 지원합니다.

제안 병합하기

제안을 병합하면 브랜치 병합을 직접 수행할 때와 동일하게 처리되며, 충돌 해결 및 이후 소스 브랜치를 보관 처리하는 옵션도 포함됩니다. 제안을 병합하려면 다음 요구 사항을 충족해야 합니다.

  • 병합하는 사용자에게 소스 및 대상 브랜치 모두에 대한 쓰기 권한이 있어야 합니다. 보호된 브랜치에서는 워크스페이스 관리자여야 합니다.
  • 어떤 검토자의 최신 판정도 “변경 요청됨”이 아니어야 합니다. 변경을 요청한 검토자는 제안을 병합하기 전에 승인해야 합니다.
  • 제안 작성자가 아닌 사람의 승인이 최소 하나 있어야 합니다. 워크스페이스 관리자는 이 승인 없이도 병합할 수 있습니다.

제안을 병합하면 소스 브랜치의 변경 사항이 이미 반영되었으므로, 동일한 소스 브랜치에 대한 다른 열린 제안은 모두 자동으로 닫힙니다.

제안 닫기

제안이 열려 있는 동안에는 언제든지 병합하지 않고 닫을 수 있습니다. 작성자와 검토자는 제안이 닫힐 때까지 제목과 설명을 편집할 수 있습니다.

  • 작성자가 자신의 제안을 닫으면 철회됨으로 기록됩니다.
  • 다른 사람이 닫으면 거부됨으로 기록됩니다.
  • 소스 브랜치를 보관 처리하면 해당 브랜치에서 또는 해당 브랜치로 향하는 모든 열린 제안이 자동으로 닫히며, branch_archived로 기록됩니다.

병합 제안 및 ElevenAgents Architect

Architect는 사용자를 대신해 병합 제안을 열 수 있습니다. 브랜치에서 변경 사항을 적용하고 테스트한 후 브랜치의 커밋과 병합 미리보기를 읽고 요약, 테스트, 검토 방법 섹션이 포함된 제안을 엽니다. 선택할 수 있는 검토자를 제안할 수도 있습니다. Architect는 사용자를 대신하여 작동하므로 제안의 작성자는 사용자로 표시됩니다.

Architect는 제안을 검토, 승인, 병합 또는 닫을 수 없습니다. 이 단계는 항상 사람이 수행합니다. 전체 흐름은 제안 및 검증을 참조하세요.

다음 단계