--- name: tk-pr-open description: "[user/auto] 검증된 현재 브랜치 `commit`을 하나의 GitHub `pull request` 또는 필요한 경우 reviewable `stacked PR`로 준비·발행하며, 원격 발행은 정확한 작업 범위·대상에 대한 명시적 승인을 확인합니다." argument-hint: "" disable-model-invocation: false metadata: tigerkit: kind: hybrid origin: tigerkit, mattpocock/skills relationship: adapted upstream-skill: pr --- ## 공통 저작 품질 관문 이 스킬에서 질문·메시지·설명·보고서·Markdown·HTML·대본·자막·문서·스킬 본문 등 사람이 읽는 텍스트를 **새로 작성하거나 의미·표현을 수정하기 전에**, 설치된 `tk-writing`의 [모든 저작의 공통 관문](../tk-writing/references/authoring-gate.md)과 [명확한 글쓰기](../tk-writing/references/clear-writing.md)를 이번 작업에서 읽고 적용합니다. 최종 산출물을 인계하기 전에 같은 기준으로 원고를 검사하고 문제를 수정합니다. 이미 읽은 기준을 반복 로드하거나 별도 재작성 스킬·에이전트·승인 라운드를 추가하지 않습니다. 코드·명령·식별자·기계 판독 형식·인용과 고정 문구는 보호하며, 이 참조로 변경·전송·발행 권한이 생기지 않습니다. 이 스킬이 작성 작업을 수행하지 않는 경우에는 추가 읽기가 필요하지 않습니다. # PR 발행 ## 공통 참조 현재 설치된 담당 스킬에서 해당 분기의 조건에 따라 기준을 읽습니다. 소유자나 자원이 없거나 일치하지 않으면 해당 작업을 중단합니다. 기억, 다른 설치본이나 승인되지 않은 설치 대신 `tk-setup-skills`를 사용합니다. 참조 읽기는 워크플로 실행이나 변경 권한을 부여하지 않습니다. - 사용자 소유 결정·누락된 승인·미충족 선행 조건을 질문이나 질문 도구 입력으로 제시하기 직전에 [질문 라운드](../tk-questioning/references/questions.md)를 이번 작업에서 읽었는지 확인하고 누락했으면 먼저 읽습니다. 독립적인 결정과 승인은 각각 별도 질문으로 두며, 승인 선택지를 결정 질문에 섞지 않습니다. - 사용자에게 완료 보고, 산출물 경로 인계나 여러 속성을 비교하는 대화 응답을 전달하기 전에 [대화 전달](../tk-writing/references/delivery.md)을 읽습니다. 작업별 구체적인 출력 계약이 우선합니다. ## UI 근거 기존 UI 문구는 언어·대소문자·문장부호·공백을 보존하고 제안 문구와 구분합니다. 근거 없는 탐색 경로를 안내하지 않습니다. UI 문구·경로를 인용·검증·전달할 때 [UI 근거](../tk-ui-evidence/references/ui-evidence.md)를 읽고, 대상에 맞는 근거와 충돌·미확인 사항을 보존합니다. 전달만 하는 분기는 새 조사를 시작하지 않으며, 수집은 담당자의 기존 조사 권한 안에서만 수행합니다. UI와 무관하면 이 참조를 읽지 않습니다. ## 승인 연속성 같은 작업에 대한 유효한 승인을 턴과 자식 단계(baseline/after 포함) 전반에 재사용하고, 기존 담당자를 통해 승인된 작업만 계속합니다. 자식·baseline 근거를 반환하고 승인된 담당 작업을 재개합니다. 단계 상태는 완료를 뜻하지 않습니다. 새로운 중대한 결정, 범위·권한 변경이나 사용자만 제공할 수 있는 입력이 누락된 경우에만 질문합니다. 호출과 복구된 산출물은 권한을 부여하지 않습니다. 원격 작업과 파괴적 작업에는 행동·대상에 대한 명시적 승인이 필요하며, 로컬 승인에서 추론하지 않습니다. `/tk-pr-open`, `$tk-pr-open`, 호스트 스킬 선택기를 통한 선택, `현재 브랜치로 PR 열어줘` 또는 이미 구현된 현재 브랜치를 리뷰 가능한 stacked PR로 나누라는 요청처럼 PR 발행을 생성하거나 업데이트하려는 의도가 명시적일 때 시작합니다. 입력은 이미 구현·검증된 현재 브랜치의 `commit` 또는 같은 세션에서 구현·검증을 마친 관련 미커밋 변경과 현재 상호작용에서 제공된 발행 입력입니다. 미커밋 변경은 아래의 승인된 로컬 커밋 분기를 먼저 완료하여 실제 head/tree로 고정합니다. 검토 대상 head/tree와 검토 범위·예외, 적용되는 리뷰 요구도 이 입력으로 받으며, 아래의 발행 대상 대조에만 사용합니다. `.tigerkit/seed.md`를 읽거나, 별도 리뷰 상태나 구현 회고를 찾아보거나, `tk-prep`이나 `tk-review`를 호출하거나, 수정 작업으로 연결하지 않습니다. 발행은 구현 리뷰가 수렴했는지 결정하지 않습니다. 구현을 반복하거나 `worker`를 만들거나 새 제품 변경을 추가하지 않습니다. 승인된 로컬 커밋은 기존 검증 내용을 기록하는 행동만 허용하며 구현·검증을 대신하지 않습니다. 승인된 구현 후 스택 분할에서는 이미 검증된 제품 트리를 정확히 재구성하는 발행 전용 브랜치와 커밋을 만들 수 있습니다. 해당 커밋은 제품 동작을 추가·누락·복구해서는 안 됩니다. ## 현재 상태 먼저 다음을 확인합니다. - 저장소와 인증된 GitHub 계정을 확인합니다. - 현재 브랜치와 `HEAD`를 확인합니다. - base 브랜치를 확인합니다. - 대상 `commit`, 트리, 커밋 범위와 변경된 경로를 확인합니다. - 같은 `head`의 `PR`이 이미 있는지와 그 `observed draft | ready` 상태를 확인합니다. - 무관한 dirty·staged 경로를 확인합니다. - 관련 미커밋 변경이 있으면 정확한 전체 경로·diff와 검증 범위, 기존 로컬 커밋 승인 여부를 확인합니다. - 대상 저장소의 `PR template`을 확인합니다. - 현재 규범적인 제목 지침을 확인합니다. 지침이 없을 때만 관례를 파악하기에 충분한 수의 최근 merge `PR` 제목을 확인합니다. 정확한 현재 `commit`을 입증할 수 없거나 무관한 변경이 섞였다면 범위를 넓히지 말고 `Blocked`/`Unverifiable`을 반환합니다. 현재 `HEAD`는 입증되지만 같은 세션에서 검증한 관련 변경만 미커밋 상태이면 [발행 전 로컬 커밋](references/approval-packet.md#local-publication-commit)을 읽고 그 행동을 승인 자료에 넣습니다. 필요한 로컬 승인과 커밋 후 검증을 마친 뒤에만 아래 사전 점검과 최종 원격 발행 자료를 준비합니다. 검증되지 않았거나 작업 소유권이 불명확한 변경은 구현 담당자에게 반환하며, 무관한 dirty·staged 변경을 정리하거나 함께 커밋하지 않습니다. ## 리뷰 가능성 사전 점검 단일 `PR`을 선택하기 전에 `base...HEAD`를 살펴보고 발행 형태를 선택합니다. ```text single | stacked ``` 엄격한 LOC 기준을 사용하지 않습니다. 큰 diff는 신호일 뿐입니다. 이미 검증된 브랜치에 하나의 일관된 선형 의존 관계를 이루는 독립적으로 리뷰 가능한 관심사가 둘 이상 있다면 `stacked`를 우선합니다. 특히 관심사마다 리뷰어 집단이 다르거나 기반 → 구현 → 통합 경계가 분명한 경우에 해당합니다. 인계에 여러 PR 그룹이 이미 계획되어 있다면 발행 형태를 선택하기 전에 [다중 PR 전달의 안전](../tk-pr-guidance/references/multi-pr-delivery.md)을 읽습니다. 해당 그룹 구성과 중간 상태 안전 검사를 보존합니다. 대응 관계가 없거나 바뀌었다고 새 분할을 만들거나 하나로 합친 PR을 발행할 권한이 생기는 것은 아닙니다. 생성 출력, lockfile, 스냅샷, vendoring된 산출물이나 기계적 대량 변경만으로 스택이 정당화되지는 않습니다. 원시 diff가 크더라도 일관된 변경 하나는 `single`로 유지합니다. 구현 후 분할은 같은 `head`의 PR이 생기기 전 새 발행에만 적격입니다. 리뷰 댓글이나 원격 상태가 있는 기존 PR을 알리지 않고 대체하거나 재구성하지 않습니다. 스택이 타당한 후보이거나 사용자가 명시적으로 요청했다면 발행 계획을 준비하기 전에 [구현 후 스택 분할](references/split-to-stack.md)을 읽습니다. 한 번의 호출은 하나의 일관된 발행 이야기를 담당합니다. PR 하나 또는 선형 스택 하나입니다. 무관한 작업에 별도 스택이나 독립 PR이 필요하다면 그 범위 확대를 하나의 발행 안에 숨기지 말고 중단합니다. 저장소 동작이나 도메인 의미를 해석하기 전에 관련된 저장소 소유 [도메인 맥락](../tk-repository-guidance/references/domain-context.md)이 있다면 읽습니다. ## PR 제목과 본문 PR 제목·본문을 작성하거나 업데이트하기 전에 [PR 본문 준비](references/pr-body.md)를 읽습니다. 적용되는 기본 브랜치 템플릿과 규범적인 제목 지침을 보존하고, 현재 리뷰 가능한 관심사를 설명하며, 검증된 UI와 위험·복구 근거를 대조하여 반영합니다. 필요한 근거가 해결되지 않았다면 발행을 중단합니다. 발행만 담당하는 이 단계는 새 제품 조사나 변경 권한을 부여하지 않습니다. ## 근거 현재 발행 입력에 근거 manifest, 이미지·GIF·MP4 또는 미디어 요구가 있으면 승인 자료를 준비하기 전에 [PR 미디어 근거](references/media-evidence.md)를 읽습니다. 해당 입력·요구가 모두 없으면 `N/A`로 두며 manifest를 만들지 않습니다. `undecided`를 원격 쓰기 전에 해소하고, 필수 근거가 누락·미검사·불완전하거나 `Pass`가 아니면 발행을 중단합니다. 실제 비밀이나 검증되지 않은 캡처는 업로드하지 않습니다. 생성 동의는 업로드 승인이 아니며, 선택·검사한 정확한 미디어만 담당 PR이 존재한 뒤 `tk-pr-media`로 전달합니다. ## 발행 승인 자료 발행 점검 지점 전에 [승인 자료](references/approval-packet.md)를 읽습니다. 정확한 저장소, single/stacked 형태, 원격 행동별 대상·승인, draft/ready 상태, base/head/tree, 검토 대상, refspec, 제목·본문, 템플릿 체크 상태, 근거와 제외 사항을 연결합니다. 최종 확인 전에 해당 참조의 검토 대상 대조를 완료하고 구체적으로 렌더링된 미리보기를 보여주며 전체 자료를 유지합니다. `.tigerkit/pr-open.md`는 해당 참조의 저장 조건을 충족할 때만 사용합니다. 새 PR은 ready가 기본값이며, 변경 요청이 없으면 기존 PR 상태를 보존합니다. ## 🔴 점검 지점 · 🛑 중단 · 발행 경계 스택 재구성이나 원격 쓰기 전에 활성 자료와 필수 산출물을 다시 읽습니다. 먼저 미결 선택을 해결한 뒤, 확정된 자료에 대한 최종 발행 확인을 한 번 받습니다. 같은 정확한 자료와 원격 행동별 대상·범위를 이미 명시적으로 승인받았다면 재사용하며 반복하지 않습니다. 단순한 단일 PR 발행 요청은 준비 의도를 확정하지만, 아직 제시하지 않은 최종 자료 내용까지 승인한 것으로 취급하지 않습니다. 스택 재구성에는 정확한 계층 계획도 필요합니다. 단일 PR 요청에서 추론하지 않습니다. 해결되지 않은 `undecided` 근거 상태는 중대한 모호함입니다. 직접적인 단일 PR 요청이라도 이 점검 지점에서 질문합니다. 기존 결정과 승인 범위는 보존하되, 근거 선택의 답변만으로 발행하지 않습니다. 미결 답변을 반영한 뒤 첫 원격 쓰기 전에 바뀐 항목과 최종 원격 행동·체크 상태·검토 대상·제외 사항을 다시 보여주고 명시적 발행 확인을 받습니다. 전체 자료를 반복할 필요는 없지만 사용자가 현재 자료를 확인할 수 있어야 합니다. 결정 답변으로 자료가 바뀌면 그 답변과 최종 승인을 같은 것으로 취급하지 않습니다. 최종 확인 뒤 자료가 다시 바뀌면 영향받은 항목을 갱신하여 확인받습니다. 질문은 공통 질문 계약에 따라 결정과 승인을 구분합니다. 미리보기와 발행 근거는 질문 직전 채팅에 렌더링하고, 최종 발행 확인은 [질문 라운드](../tk-questioning/references/questions.md)와 [발행 승인 자료](references/approval-packet.md)를 따릅니다. 호스트 승인 제한을 준수합니다. `stacked`에서는 같은 승인이 승인된 계층 계획의 정확한 로컬 발행 이력 재구성만 추가로 허용합니다. 제품 수정, 소스 브랜치 재작성, 추가 계층이나 무관한 브랜치 정리는 허용하지 않습니다. 계획, 승인된 `commit`, 템플릿·근거 상태, 스택 도구 출처나 현재 저장소 상태를 재검증할 수 없으면 중단합니다. ## 발행 승인 후 저장소, 계정, 소스 브랜치, `HEAD`, base, 기존 `PR`, 템플릿 출처와 스택 브랜치 이름 충돌 여부를 다시 확인합니다. 승인 자료의 [검토 대상 대조](references/approval-packet.md#reviewed-publication-target)에 따라 현재 head/tree와 diff 기준을 다시 읽고 승인한 비교 결과가 여전히 유효한지 확인합니다. 최종 승인한 후보에서 추가 변경이 생겼거나 승인한 비교 결과를 입증할 근거가 없으면 원격 쓰기를 보류하고 해당 선택·확인 단계로 돌아갑니다. 테스트·정적 검사를 필수 독립 리뷰 대신 사용하지 않습니다. 기존 `PR`의 `actual state`가 승인된 `plan`과 중대하게 다르면 승인을 무효화합니다. 중대한 `drift`가 있으면 승인을 무효화합니다. 원격 상태 변경(`push`, PR 생성·업데이트, `gh pr ready`, `gh pr edit`)은 로컬 정리와 별도의 도구 호출에서 실행합니다. 정리 거부가 발행 결과를 차단하거나 가리지 않도록 원격 결과를 독립적으로 기록하고 재확인합니다. PR 외 원격 행동은 PR 승인에서 추론하지 않습니다. 연결된 티켓의 상태 전이 선택지·추천과 조회 불가 시의 생략은 [승인 자료의 부가 원격 행동](references/approval-packet.md#additional-remote-actions)을 따릅니다. 사용자가 선택하여 승인 자료에 포함하고 명시적으로 승인한 행동만 PR 발행 성공을 검증한 뒤 수행합니다. draft PR의 전이도 같은 선택지와 승인 절차를 따릅니다. 승인 없이는 어느 상태의 PR에서도 전이를 실행하지 않습니다. `single`에서는 정확히 승인된 `refspec`만 push하고 지정된 `PR`만 생성하거나 업데이트합니다. `create`에서는 승인된 `PR state`를 적용하고, `update`에서는 명시적으로 승인된 경우에만 상태를 바꿉니다. `stacked`에서는 [구현 후 스택 분할](references/split-to-stack.md)을 따릅니다. 소스 브랜치를 보존하고 그 옆에 승인된 계층만 재구성하며, 모든 계층과 최종 트리 불변 조건을 검증한 뒤 검증된 `github/gh-stack`으로 정확한 사슬을 제출합니다. 새로 생성한 모든 계층에 승인된 상태를 사용하고, 제출 후 자동 생성된 PR 메타데이터를 정확히 승인된 제목·본문으로 수정합니다. `merge`, `close`, `tag`, `release`를 수행하거나 보존된 소스 브랜치를 삭제하거나 무관한 ref를 정리하지 않습니다. 발행을 생성하거나 업데이트한 뒤 원격 상태를 다시 읽습니다. `single`에서는 URL, `head SHA`, 실제 `draft | ready` 상태, 템플릿 준수와 근거 상태를 검증합니다. `stacked`에서는 기계 판독 스택 상태를 사용하고 모든 PR의 URL, head/base 관계, 상태, 정확한 제목·본문, 템플릿 준수와 근거 상태를 다시 읽습니다. 근거가 필수이거나 업로드를 명시적으로 선택했다면 담당 PR이 존재한 뒤 이미지 업로더를 사용합니다. PR이 하나라도 생성되었지만 필수 메타데이터·근거나 선택된 이미지 발행이 실패했다면 실제 원격 상태를 보존하고 부분 발행을 숨기지 말고 완료 상태를 `Blocked`로 보고합니다. 승인된 트래커 전이가 실패하거나 차단되면 성공한 PR과 실패한 부가 행동을 나누어 보고하고, PR을 자동으로 되돌리거나 다른 전이를 시도하지 않습니다. ## 완료 사용자에게 중요한 결과만 보여줍니다. - `PR` URL이나 하위→상위 스택 PR URL을 보여줍니다. - 발행을 생성했는지 업데이트했는지 보여줍니다. - 현재 소스 `head`를 보여줍니다. 스택이라면 보존된 소스 브랜치와 스택 tip을 보여줍니다. - 현재 `PR state`를 보여줍니다. - 검증·근거 결과를 보여줍니다. - 스택이라면 stack-tip 트리가 원본 트리와 같은지 보여줍니다. - 남은 차단 요인이나 부분 원격 상태를 보여줍니다. 출처 전체 덤프나 제품 구현 receipt는 보여주지 않습니다. ## 산출물 경로 승인된 산출물 쓰기, checkout·전송·Git 제외 설정이나 임시 입력 소비 전에 [산출물 경로](../tk-artifacts/references/artifact-paths.md)를 읽습니다. 저장소 임시 파일에는 안전하고 소유권이 확인된 심볼릭 링크가 아닌 경로와 입증된 Git 제외를 사용합니다. 검사에 실패하면 해당 파일 분기를 중단합니다. 명시적인 최종 목적지와 담당자별 기본값을 보존합니다. 미리 채워진 입력은 완료된 입력이 아닙니다. 정리는 기록된 리터럴 형태의 해석 완료된 실행 소유 절대 경로만 대상으로 하며, cwd 상대 경로나 glob을 사용하지 않습니다.