메뉴
GitHub PR URL을 인자로 받아 merge conflict(병합 충돌) 유무를 판정하고, 충돌이 없으면 즉시 종료한다. 충돌이 있으면 충돌 파일/원인 커밋을 추적해 어떤 PR/브랜치에서 유입된 변경인지 식별한 뒤, 양쪽 PR/이슈의 plans(또는 docs/plan) 문서를 찾아 의도한 구현을 모두 보존하는 형태로 충돌을 해결하고 commit+push 해서 PR이 다시 mergeable 해질 때까지 확인한다. PR 병합 충돌 해결을 요청받으면 사용한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
GitHub PR URL을 인자로 받아 현재 브랜치가 PR의 head branch와 일치하는지 검증한 뒤, GitHub Actions CI 실패 원인을 분석/수정하고 commit+push 후 CI 성공을 폴링으로 확인하는 복구 루프를 수행한다. CodeRabbit/Copilot 같은 코드리뷰 체크는 제외하고 GitHub Actions run만 대상으로 한다. PR CI 실패 복구를 요청받으면 사용한다.
변경사항 커밋/푸시 워크플로우 자동화. 이슈 생성, 브랜치 생성, 원자적 커밋, 검증, 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.
SOC 직업 분류 기준
| name | pr-merge-conflict |
| description | GitHub PR URL을 인자로 받아 merge conflict(병합 충돌) 유무를 판정하고, 충돌이 없으면 즉시 종료한다. 충돌이 있으면 충돌 파일/원인 커밋을 추적해 어떤 PR/브랜치에서 유입된 변경인지 식별한 뒤, 양쪽 PR/이슈의 plans(또는 docs/plan) 문서를 찾아 의도한 구현을 모두 보존하는 형태로 충돌을 해결하고 commit+push 해서 PR이 다시 mergeable 해질 때까지 확인한다. PR 병합 충돌 해결을 요청받으면 사용한다. |
| argument-hint | [pr-url] |
| disable-model-invocation | true |
GitHub PR의 merge conflict(병합 충돌)를 판정 -> 원인 추적 -> 계획 문서 합치기 -> 충돌 해결 구현 -> commit -> push -> 재판정 루프로 해결한다.
핵심 원칙:
mergeable이 MERGEABLE이면 작업을 시작하지 않는다.plans/ 또는 docs/plan/ 문서를 우선 탐색/참조한다.--force-with-lease 허용)/pr-merge-conflict 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
현재 디렉토리의 저장소가 PR 저장소와 같은지 확인(권장):
LOCAL_REPO_NWO=$(gh repo view --json nameWithOwner --jq .nameWithOwner)
test "$LOCAL_REPO_NWO" = "$REPO_NWO"
PR 메타데이터 수집:
PR_BASE_BRANCH=$(gh pr view -R "$REPO_NWO" "$PR_NUMBER" --json baseRefName --jq .baseRefName)
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')
PR_MERGEABLE=$(gh pr view -R "$REPO_NWO" "$PR_NUMBER" --json mergeable --jq .mergeable)
echo "$PR_MERGEABLE base=$PR_BASE_BRANCH head=$PR_HEAD_BRANCH sha=$PR_HEAD_SHA"
판정:
MERGEABLE: 즉시 종료 (충돌 해결 불필요)CONFLICTING: 다음 단계로 진행UNKNOWN: 10~30초 대기 후 최대 5회 재조회하고, 계속 UNKNOWN이면 현재 정보로 진행하되 마지막에 재검증한다.CURRENT_BRANCH=$(git branch --show-current)
test -n "$CURRENT_BRANCH"
test "$CURRENT_BRANCH" = "$PR_HEAD_BRANCH"
CURRENT_SHA=$(git rev-parse HEAD)
test "$CURRENT_SHA" = "$PR_HEAD_SHA"
test -z "$(git status --porcelain)"
불일치 시 안내(예시):
echo "현재 브랜치가 PR head branch가 아닙니다."
echo "권장: gh pr checkout -R \"$REPO_NWO\" \"$PR_NUMBER\""
기본 접근:
사전 fetch:
git fetch origin "$PR_BASE_BRANCH"
MB=$(git merge-base HEAD "origin/$PR_BASE_BRANCH")
echo "merge-base=$MB"
충돌 파일 수집(merge는 반드시 abort로 원복):
git merge --no-commit --no-ff "origin/$PR_BASE_BRANCH" || true
CONFLICT_FILES=$(git diff --name-only --diff-filter=U)
echo "$CONFLICT_FILES"
충돌이 재현되지 않으면:
git merge --abort로 원복한다.mergeable 상태가 오래된 것일 수 있으니 다시 조회 후 종료하거나, 필요 시 git fetch/gh pr view 재시도한다.원인 커밋/PR 매핑(파일별 반복):
for f in $CONFLICT_FILES; do
echo "== $f =="
HEAD_SIDE_SHA=$(git log -n 1 --format=%H "$MB..HEAD" -- "$f" || true)
BASE_SIDE_SHA=$(git log -n 1 --format=%H "$MB..origin/$PR_BASE_BRANCH" -- "$f" || true)
if test -n "$HEAD_SIDE_SHA"; then
git show -s --date=short --format="head %h %ad %an %s" "$HEAD_SIDE_SHA"
gh api -H "Accept: application/vnd.github+json" "/repos/$REPO_NWO/commits/$HEAD_SIDE_SHA/pulls" --jq '.[].html_url' || true
fi
if test -n "$BASE_SIDE_SHA"; then
git show -s --date=short --format="base %h %ad %an %s" "$BASE_SIDE_SHA"
gh api -H "Accept: application/vnd.github+json" "/repos/$REPO_NWO/commits/$BASE_SIDE_SHA/pulls" --jq '.[].html_url' || true
fi
done
원복:
git merge --abort || true
test -z "$(git status --porcelain)"
추적 결과 정리:
base-side PR URL을 1~3개로 좁혀 "충돌 원인 PR 후보"로 선정한다.목표:
PR 정보에서 이슈 번호 후보를 뽑는다:
# PR0
gh pr view -R "$REPO_NWO" "$PR_NUMBER" --json title,body,headRefName,baseRefName,url
# PRx (URL이 있으면)
PRX_URL="https://github.com/$REPO_NWO/pull/123" # 예시
gh pr view "$PRX_URL" --json title,body,headRefName,baseRefName,url
이슈 번호 추정 규칙(우선순위):
issue-{number}- 패턴이 있으면 그 번호 사용Fixes #123, Closes #123, Resolves #123 패턴 우선#123 패턴은 후보로만 수집하고, PR 번호와 혼동되지 않게 검증plans 문서 위치 후보:
docs/plan/plans/탐색:
# PR URL로 직접 검색
rg -n "$PR_URL|pull/$PR_NUMBER" docs/plan plans 2>/dev/null || true
# 이슈 번호가 있으면 (예: 123)
ISSUE_NUMBER="123"
ls docs/plan 2>/dev/null | rg -n "ISSUE_${ISSUE_NUMBER}_" || true
find plans -type f -maxdepth 4 2>/dev/null | rg -n "ISSUE_${ISSUE_NUMBER}_" || true
문서가 여러 개면:
문서를 못 찾으면:
전략 선택:
merge로 base를 PR head에 합친다. (force push 없이 해결 가능)rebase를 선택하되 --force-with-lease 전제다.git fetch origin "$PR_BASE_BRANCH"
git merge "origin/$PR_BASE_BRANCH"
충돌 파일에 대해:
<<<<<<<, =======, >>>>>>>)를 제거한다.해결 후:
git diff --name-only --diff-filter=U # 비어 있어야 함
git status
git add -A
git commit
git fetch origin "$PR_BASE_BRANCH"
git rebase "origin/$PR_BASE_BRANCH"
충돌 해결 후:
git add -A
git rebase --continue
rebase 완료 후 push:
git push --force-with-lease
검증:
test, lint, build 중 가능한 것을 실행한다.push:
git push
mergeable 재확인:
gh pr view -R "$REPO_NWO" "$PR_NUMBER" --json mergeable --jq .mergeable
여전히 CONFLICTING이면:
git fetch origin "$PR_BASE_BRANCH" 후 4~7단계를 반복한다.아래를 한 번에 보고한다.
mergeable 상태--force, --force-with-lease)