메뉴
버그 상황과 로그를 받아 재현을 최우선으로 수행하고, git 변경/프로젝트 문서 기반 원인 가설을 반복 검증해 해결한다. 방향 변경이 필요하면 사용자 승인 후 진행한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
GitHub PR URL을 인자로 받아 merge conflict(병합 충돌) 유무를 판정하고, 충돌이 없으면 즉시 종료한다. 충돌이 있으면 충돌 파일/원인 커밋을 추적해 어떤 PR/브랜치에서 유입된 변경인지 식별한 뒤, 양쪽 PR/이슈의 plans(또는 docs/plan) 문서를 찾아 의도한 구현을 모두 보존하는 형태로 충돌을 해결하고 commit+push 해서 PR이 다시 mergeable 해질 때까지 확인한다. PR 병합 충돌 해결을 요청받으면 사용한다.
GitHub PR URL을 인자로 받아 현재 브랜치가 PR의 head branch와 일치하는지 검증한 뒤, GitHub Actions CI 실패 원인을 분석/수정하고 commit+push 후 CI 성공을 폴링으로 확인하는 복구 루프를 수행한다. CodeRabbit/Copilot 같은 코드리뷰 체크는 제외하고 GitHub Actions run만 대상으로 한다. PR CI 실패 복구를 요청받으면 사용한다.
변경사항 커밋/푸시 워크플로우 자동화. 이슈 생성, 브랜치 생성, 원자적 커밋, 검증, push, PR 생성 후 CI 폴링/실패 복구까지 한 번에 진행해 달라는 명시적 요청에서 사용한다.
구현 계획 문서를 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.
| name | debug-loop |
| description | 버그 상황과 로그를 받아 재현을 최우선으로 수행하고, git 변경/프로젝트 문서 기반 원인 가설을 반복 검증해 해결한다. 방향 변경이 필요하면 사용자 승인 후 진행한다. |
| argument-hint | [bug-scenario] [log-path-or-snippet] [doc-path(optional)] |
| disable-model-invocation | true |
버그를 빠르게 고치기 위한 반복 디버깅 스킬이다.
핵심 원칙:
$ARGUMENTS로 버그 상황과 로그(파일 경로 또는 요약 텍스트), 선택적 문서 경로를 받는다.재현 성공 후 아래를 우선 수집한다.
AGENTS.mddocs/ 하위 문서plans/ 하위 문서결과로 "우선 확인 파일 목록"을 만든다.
최소 1개, 권장 2~3개 가설을 만든다.
가설마다:
아래 상황이면 반드시 사용자 승인 후 진행한다.
보고 템플릿:
[승인 필요]
- 현재 상황: {요약}
- 계획대로 어려운 이유: {이유}
- 제안안 A: {내용}
- 제안안 B: {내용}
- 권장안: {A/B + 이유}
- 영향 범위: {파일/리스크/테스트 영향}
아래 루프를 반복한다.
권장:
수정 후 아래를 수행한다.
최종 보고에 아래를 포함한다.
코드 수정/테스트 안정화가 끝나면 문서 업데이트 필요 여부를 점검한다.
$ARGUMENTS에 문서 경로가 있으면 최우선 점검 대상으로 포함한다.AGENTS.md를 읽고 문서 관련 규칙/구조에 나온 경로를 점검 후보에 포함한다.
README.md, docs/, plans/, CLAUDE.md, .claude/AGENTS.md