Git

• 저장소 작업: Git 저장소를 다루는 모든 작업 — 브랜치 생성, 변경 사항 스테이징, 커밋, 푸시, 또는 풀 리퀘스트 열기.
• 팀 협업: 히스토리 안전성이 중요하고 피처 브랜치 플로우, 핫픽스 워크플로우, 또는 PR 준비 커밋 위생을 자동으로 적용해야 할 때.
• 히스토리 디버깅: git bisect으로 회귀를 추적하거나, git reflog를 통해 손실된 커밋을 복구하거나, 변경 사항을 안전하게 되돌려야 할 때.
• 충돌 해결: 병합 또는 리베이스 시 충돌이 발생하고 에이전트가 이를 해결하기 위한 체계적이고 검증된 접근 방식이 필요할 때.

• Non-Git 버전 관리: 프로젝트가 Mercurial, SVN 또는 다른 VCS를 사용하는 경우, 이 스킬의 명령어는 적용되지 않습니다.
• 읽기 전용 분석 작업: 에이전트가 Git과 전혀 상호작용하지 않고 소스 코드만 읽으면 되는 경우, 이 스킬은 불필요한 오버헤드를 추가합니다.

이 스킬은 팀원의 작업을 덮어쓰는 것을 방지하기 위해 --force 대신 --force-with-lease 사용을 강제하며, main/master와 같은 공유 브랜치에 강제 푸시하는 것을 금지합니다. reset --hard 또는 rebase와 같은 파괴적인 작업을 수행하기 전에 내장된 안전 체크리스트를 반드시 충족해야 합니다.

Feature Branch 및 Hotfix 시나리오에 대한 단계별 흐름을 포함하며, 커밋을 스쿼시해야 할 시점, git fetch --all --prune으로 동기화하는 방법, 릴리스에 태그를 지정하는 방법을 다룹니다. 트렁크 기반 및 gitflow 스타일 팀 모두에 맞게 설계되었습니다.

충돌된 파일을 편집한 후, 이 스킬은 grep을 사용하여 충돌 마커가 남아 있지 않은지 확인하고, 코드가 빌드되는지 검증하며, 머지가 너무 복잡해질 경우 git merge --abort를 통한 탈출 수단을 제공합니다. 머지가 복잡해질 때는 대안으로 리베이스(rebase)가 제안됩니다.

분실된 커밋을 복구하기 위한 git reflog 사용법(최대 약 90일), SHA를 이용한 삭제된 브랜치 복원, 그리고 git reset --soft를 사용하여 작업 내용을 잃지 않고 커밋을 되돌리는 방법을 다룹니다. 또한 회귀를 유발한 커밋을 정확히 찾아내기 위한 전체 git bisect 워크플로우도 포함됩니다.

이 스킬은 72자 이내의 첫 번째 줄에 type(scope): description 형식의 커밋 메시지를 사용하도록 강제하며, 표준 타입(feat, fix, docs, refactor 등)을 활용합니다. 이를 통해 Git 히스토리의 가독성을 유지하고 자동화된 체인지로그 도구와의 호환성을 확보할 수 있습니다.

자주 발생하는 Git 함정들을 문서화하고 방지합니다: 분리된 HEAD 상태, macOS/Windows와 Linux CI 간의 대소문자 구분 문제, 서브모듈 클론 오류, stash-pop 충돌, 대용량 파일 또는 민감한 정보 커밋. 세밀한 부분 스테이징을 위해 git add -p를 사용하세요.

에이전트가 새로운 기능을 스캐폴딩하고, main에서 브랜치를 생성하며, 컨벤셔널 메시지로 점진적으로 커밋하고, 푸시 전에 최신 main 위로 리베이스하고, 픽스업 커밋을 스쿼시한 후, PR 준비가 완료된 브랜치를 오픈합니다 — 이 모든 과정이 수동 Git 개입 없이 이루어집니다.

프로덕션 버그가 발견되면, 에이전트는 main에서 hotfix/ 브랜치를 체크아웃하고, 수정 사항을 적용한 후 main과 develop 양쪽에 병합하고, 릴리즈에 태그를 달고, 브랜치를 정리합니다 — 문서화된 핫픽스 흐름을 정확히 따릅니다.

에이전트는 git bisect를 실행하여 커밋 히스토리를 이진 탐색 방식으로 탐색하며, 자동화된 테스트 결과를 기반으로 각 커밋을 정상(good) 또는 불량(bad)으로 표시하여 버그가 도입된 정확한 커밋을 식별합니다.

장기간 실행되는 기능 리베이스 중에, 에이전트는 파일별로 충돌을 해결하고, <<</>>> 마커가 남아 있지 않은지 확인하며, 빌드가 통과되는지 검증한 후 리베이스를 계속 진행합니다. 충돌이 너무 복잡한 경우에는 깔끔하게 중단(abort)합니다.