菜单
GitHub PR URL을 인자로 받아 merge conflict(병합 충돌) 유무를 판정하고, 충돌이 없으면 즉시 종료한다. 충돌이 있으면 충돌 파일/원인 커밋을 추적해 어떤 PR/브랜치에서 유입된 변경인지 식별한 뒤, 양쪽 PR/이슈의 plans(또는 docs/plan) 문서를 찾아 의도한 구현을 모두 보존하는 형태로 충돌을 해결하고 commit+push 해서 PR이 다시 mergeable 해질 때까지 확인한다. PR 병합 충돌 해결을 요청받으면 사용한다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 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)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.