메뉴
GitHub PR URL을 인자로 받아 현재 브랜치가 PR의 head branch와 일치하는지 검증한 뒤, GitHub Actions CI 실패 원인을 분석/수정하고 commit+push 후 CI 성공을 폴링으로 확인하는 복구 루프를 수행한다. CodeRabbit/Copilot 같은 코드리뷰 체크는 제외하고 GitHub Actions run만 대상으로 한다. PR CI 실패 복구를 요청받으면 사용한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | pr-ci-loop |
| description | GitHub PR URL을 인자로 받아 현재 브랜치가 PR의 head branch와 일치하는지 검증한 뒤, GitHub Actions CI 실패 원인을 분석/수정하고 commit+push 후 CI 성공을 폴링으로 확인하는 복구 루프를 수행한다. CodeRabbit/Copilot 같은 코드리뷰 체크는 제외하고 GitHub Actions run만 대상으로 한다. PR CI 실패 복구를 요청받으면 사용한다. |
| argument-hint | [pr-url] |
| disable-model-invocation | true |
GitHub PR의 GitHub Actions CI 실패를 분석 -> 최소 수정 -> commit -> push -> 재폴링으로 반복해서 녹색이 될 때까지 복구한다.
핵심 원칙:
/pr-ci-loop https://github.com/{owner}/{repo}/pull/{number}$ARGUMENTS에서 PR URL을 추출한다.https://github.com/{owner}/{repo}/pull/{number}파싱 예시:
PR_URL="$ARGUMENTS"
echo "$PR_URL" | grep -Eq '^https://github.com/[^/]+/[^/]+/pull/[0-9]+/?$'
OWNER=$(echo "$PR_URL" | sed -E 's@^https://github.com/([^/]+)/([^/]+)/pull/([0-9]+)/?$@\1@')
REPO=$(echo "$PR_URL" | sed -E 's@^https://github.com/([^/]+)/([^/]+)/pull/([0-9]+)/?$@\2@')
PR_NUMBER=$(echo "$PR_URL" | sed -E 's@^https://github.com/([^/]+)/([^/]+)/pull/([0-9]+)/?$@\3@')
REPO_NWO="$OWNER/$REPO"
사전 체크:
git rev-parse --is-inside-work-tree
gh auth status
CURRENT_BRANCH=$(git branch --show-current)
test -n "$CURRENT_BRANCH"
현재 디렉토리의 저장소가 PR 저장소와 같은지 확인(권장):
LOCAL_REPO_NWO=$(gh repo view --json nameWithOwner --jq .nameWithOwner)
test "$LOCAL_REPO_NWO" = "$REPO_NWO"
PR의 head branch/sha 확인:
PR_HEAD_BRANCH=$(gh pr view -R "$REPO_NWO" "$PR_NUMBER" --json headRefName --jq .headRefName)
PR_HEAD_SHA=$(gh pr view -R "$REPO_NWO" "$PR_NUMBER" --json commits --jq '.commits[-1].oid')
echo "$PR_HEAD_BRANCH $PR_HEAD_SHA"
판정:
$CURRENT_BRANCH != $PR_HEAD_BRANCH 이면 아래를 출력하고 즉시 중단한다.
push 거부(behind/non-fast-forward)를 예방하려면(권장):
git fetch origin
git status -sb
환경 변수:
POLL_INTERVAL_SEC=60
MAX_EMPTY_POLLS=5
IGNORE_WORKFLOW_NAME_REGEX="coderabbit|copilot"
최신 head SHA 기준으로 워크플로우 이름별 최신 run 상태만 확인:
PR_HEAD_SHA=$(gh pr view -R "$REPO_NWO" "$PR_NUMBER" --json commits --jq '.commits[-1].oid')
gh run list -R "$REPO_NWO" --limit 200 \
--json databaseId,headSha,event,status,conclusion,name,url,createdAt \
--jq "
[ .[]
| select(.headSha == \"$PR_HEAD_SHA\")
| select(.event == \"pull_request\" or .event == \"pull_request_target\")
| select((.name | test(\"$IGNORE_WORKFLOW_NAME_REGEX\"; \"i\")) | not)
]
| sort_by([.name, .createdAt])
| group_by(.name)
| map(.[-1])
| sort_by(.createdAt)
| reverse
| .[]
| [.name, (.conclusion // .status // \"PENDING\"), .url, (.databaseId|tostring)]
| @tsv
"
상태 판정 규칙:
sleep "$POLL_INTERVAL_SEC" 후 재조회한다.
MAX_EMPTY_POLLS를 초과하면 workflow 미설정/권한 문제 가능성이 있으니 중단하고 원인을 보고한다.queued/in_progress/waiting 이면 sleep 후 재조회한다.success/skipped/neutral 이면 종료한다.failure/error/timed_out/cancelled/action_required/startup_failure 가 있으면 3단계로 진행한다.RUN_ID(databaseId)를 확보한다.gh run view -R "$REPO_NWO" "$RUN_ID" --log-failed
make ci, pnpm test, npm run lint).fix: CI 실패 원인 수정 ({workflow-name})git status --porcelain
git diff
git add -A
git commit -m "fix: CI 실패 원인 수정"
git push
push가 거부되면(behind/non-fast-forward):
git fetch 후 git pull --rebase로 동기화하고 재시도한다.2단계로 돌아가서 다시 폴링한다.
반복 중단 조건:
GitHub PR URL을 인자로 받아 merge conflict(병합 충돌) 유무를 판정하고, 충돌이 없으면 즉시 종료한다. 충돌이 있으면 충돌 파일/원인 커밋을 추적해 어떤 PR/브랜치에서 유입된 변경인지 식별한 뒤, 양쪽 PR/이슈의 plans(또는 docs/plan) 문서를 찾아 의도한 구현을 모두 보존하는 형태로 충돌을 해결하고 commit+push 해서 PR이 다시 mergeable 해질 때까지 확인한다. PR 병합 충돌 해결을 요청받으면 사용한다.
변경사항 커밋/푸시 워크플로우 자동화. 이슈 생성, 브랜치 생성, 원자적 커밋, 검증, push, PR 생성 후 CI 폴링/실패 복구까지 한 번에 진행해 달라는 명시적 요청에서 사용한다.
버그 상황과 로그를 받아 재현을 최우선으로 수행하고, git 변경/프로젝트 문서 기반 원인 가설을 반복 검증해 해결한다. 방향 변경이 필요하면 사용자 승인 후 진행한다.
구현 계획 문서를 6가지 관점으로 순차 리뷰하고, 수동 텍스트 승인 루프로 의견/승인을 받아 즉시 반영한 뒤 반복 루프를 수행한다.
GitHub 이슈 URL을 인자로 받아 이슈 정보를 확인하고 git worktree 기반 작업 브랜치를 생성한 뒤 이슈 계획 문서를 만든다. 이슈 URL 기준으로 브랜치/worktree/계획 문서 초기화를 요청할 때 사용한다.
Analyze current branch changes against a base branch, identify documentation that should be updated, and directly edit those docs. Use when asked to sync docs with branch changes before merge, release, or PR review.