GitHub PR Workflow

• 로컬 변경 사항을 배포할 준비가 되어 있으며, 브랜치 생성, 커밋 스테이징, 구조화된 설명이 포함된 PR 열기를 하나의 흐름으로 처리하고 싶습니다.
• 열려 있는 PR의 CI 체크 실행을 모니터링해야 하며, GitHub UI를 직접 확인하지 않고도 실패한 로그가 자동으로 표시되기를 원합니다.
• 자동 수정 루프를 원합니다: 실패한 린트 또는 테스트 체크를 감지하고, 수정 사항을 적용하고, 푸시한 후, 모든 체크가 통과될 때까지 재폴링합니다.
• 병합할 준비가 되었으며, 특정 전략(스쿼시, 리베이스, 또는 머지 커밋)을 적용하고 이후 소스 브랜치를 삭제하고 싶습니다.

• git 저장소에서 GitHub를 원격 저장소로 사용하고 있지 않은 경우 — 이 스킬은 전반적으로 해당 설정을 전제로 합니다.
• gh CLI가 인증되지 않았거나 GitHub PAT를 사용할 수 없는 경우 — 둘 중 하나가 없으면 API 호출이 실패합니다.
• GitLab, Bitbucket 또는 기타 GitHub가 아닌 원격 저장소를 관리해야 하는 경우 — 이 스킬은 GitHub 전용입니다.

기능 브랜치를 관례에 맞는 슬러그 이름으로 자동 생성하고, 생성된 커밋 메시지와 함께 변경 사항을 스테이징합니다. 메시지를 직접 작성하지 않아도 커밋 히스토리를 깔끔하게 유지할 수 있습니다.

브랜치를 origin에 푸시하고 내장 설명 템플릿(references/pr-template.md)을 사용하여 풀 리퀘스트를 엽니다. 동일한 단계에서 리뷰어 요청, 레이블 지정, 이슈 연결을 지원합니다.

scripts/watch_ci.sh를 통해 GitHub 체크 실행을 폴링하고, 실패한 체크의 로그를 세션에 직접 출력합니다. Actions UI를 클릭해가며 오류를 찾을 필요가 없습니다.

검사가 실패하면, 이 스킬이 수정 사항을 적용하고 새 커밋을 푸시한 뒤 검사를 다시 폴링합니다 — 필수 검사가 모두 통과될 때까지 이 과정을 반복합니다. 린팅이나 포매팅 실패를 처리할 때 반복적인 푸시를 줄여줍니다.

스쿼시 병합, 리베이스 병합, 표준 병합 커밋을 지원합니다. 병합 후에는 소스 브랜치를 삭제하여 원격 저장소를 깔끔하게 유지합니다.

인증된 경우 gh CLI를 기본 드라이버로 사용합니다. gh를 사용할 수 없는 경우, references/api-fallback.md 및 curl 기반 스크립트가 $GITHUB_TOKEN을 사용하여 GitHub REST API에 대한 모든 작업을 처리합니다.

개발자가 로컬 변경 사항을 가지고 있으며 다음과 같이 요청합니다: "/api/search에 속도 제한 추가'라는 제목으로 main을 대상으로 하는 PR을 열어줘." 이 스킬은 브랜치를 생성하고, 커밋을 스테이징하며, 푸시하고, 설명과 함께 PR을 열어줍니다 — 수동 git 명령어가 전혀 필요하지 않습니다.

PR을 열고 난 후, 개발자가 이렇게 요청합니다: "PR 검사를 모니터링하다가, 린트가 실패하면 수정하고 다시 푸시해줘." 이 스킬은 체크 실행을 주기적으로 폴링하여 린트 실패를 감지하고, 수정 사항을 적용한 뒤 푸시하며, 전체 검사 항목이 통과될 때까지 이 과정을 반복합니다.

리뷰가 승인되면, 개발자가 요청합니다: "PR #142를 스쿼시 병합하고 브랜치를 삭제해 주세요." 이 스킬은 스쿼시 병합을 실행하고 원격 브랜치를 한 번의 작업으로 제거합니다.

개발자가 묻습니다: "내 브랜치를 검토해줘 — 어떤 검사가 실패하고 있고, 아직 승인하지 않은 사람은 누구야?" 이 스킬은 GitHub API에서 현재 CI 상태와 미결 리뷰어 승인 현황을 가져와 보여줍니다.