최소 Git 커밋
목표
현재 에이전트 작업에 대해 하나 이상의 원자적인 커밋을 생성합니다. 생성되는 모든 커밋 메시지는 Conventional Commits를 따릅니다. 일반적인 요청은 낮은 컨텍스트로 유지하고, 완전한 diff 분석은 명시적인 전체 모드 요청이 있을 때만 수행합니다.
모드 선택
- 기본적으로 빠른 모드를 사용합니다.
- 사용자가
full이라고 말하거나, 전체 diff 스캔/분석을 요청하거나, 모든 변경 사항을 명시적으로 확인하라고 요청하는 경우에만 전체 모드를 사용합니다. - 빠른 모드를 전체 모드로 무단 업그레이드하지 마십시오. 빠른 모드에 충분한 정보가 없으면 변경 요약을 요청하거나 사용자에게 전체 모드를 선택하도록 요청하십시오.
빠른 모드
먼저 에이전트가 명시적으로 요약한 현재 작업을 우선 사용합니다. 필요한 경우에만 다음을 확인합니다.
git status --short
git diff --stat
전체 diff나 히스토리를 읽지 마십시오. 요약에 없는 변경 사항에 대해 추측하지 마십시오. 명시된 변경 사항을 원자적인 커밋으로 그룹화하고 해당 메시지를 생성합니다. 사용자가 명시적으로 커밋을 요청한 경우, 파일 경계가 불분명하면 인덱스를 변경하거나 커밋을 생성하기 전에 계획된 파일/메시지를 먼저 보여줍니다.
전체 모드
관련된 모든 워킹 트리와 스테이징된 diff를 읽고, 변경된 모든 파일을 검사하며, Conventional Commits 참조를 읽습니다. 누락된 기능, 테스트, 문서, 설정, 관련 없는 파일, 민감한 파일, 생성된 파일, 독립적인 논리적 변경 사항이 있는지 확인합니다. 생성된 파일이 버전 관리에 포함되어야 하는지 확인합니다: 잠금 파일이나 마이그레이션과 같은 프로젝트 필수 출력물은 유지하고, 빌드 아티팩트와 로컬 출력물은 제외합니다. 독립적인 기능, 버그 수정, 리팩터, 형식만 변경된 사항은 원자적인 커밋으로 분할하며, 밀접하게 결합되어 독립적으로 테스트하거나 되돌릴 수 없는 변경 사항은 함께 유지합니다. 기존 프로젝트 명령어를 사용하여 변경된 파일과 관련된 검사를 실행합니다. 기본적으로 전체 테스트, 린트, 타입 검사 스위트를 실행하지 말고, 작업 중 이미 실행된 검사를 재사용하며, 요청되거나 변경 사항에 필요한 경우에만 검증을 확장합니다. 명시적으로 요청하지 않는 한 히스토리를 검사하지 마십시오.
git add 또는 git commit 전에 현재 작업 범위 밖의 사용자 변경 사항을 보존하십시오. 사용자가 명시적으로 커밋을 요청할 때만 해당 변경을 실행합니다. 이 스킬의 일부로 푸시하지 마십시오.
커밋 규칙
다음 형식을 사용합니다.
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
- 새 기능에는
feat를, 버그 수정에는fix를 사용합니다. - 프로젝트 유형
docs,style,refactor,perf,test,build,ci,chore,revert가 변경 사항을 정확히 설명하는 경우 우선 사용합니다. - 유용한 컨텍스트를 제공하는 경우에만 괄호 안에 명사형 범위를 사용합니다.
- 콜론 앞에
!를 표시하거나 대문자BREAKING CHANGE:푸터를 사용하여 주요 변경 사항을 표시합니다. - 설명은 간결하고, 현재 시제, 명령형으로 작성하며, 가급적 72자 미만으로 유지합니다.
- 하나의 커밋은 하나의 논리적 변경을 나타냅니다. 가능하면 독립적인 기능, 수정, 테스트, 문서, 리팩터를 분할합니다.
fix는 SemVer PATCH에,feat는 MINOR에, 주요 변경 사항은 MAJOR에 매핑됩니다. 별도로 요청되지 않는 한 버전 파일을 변경하지 마십시오.
안전 및 확인
- 기본적으로
git add .를 사용하지 말고, 현재 작업에 속한 파일만 추가합니다. .env, 자격 증명, 토큰, 개인 키 또는 기타 비밀을 커밋하지 마십시오.- 전체 모드에서는 스테이징된 콘텐츠에 비밀이 있는지 검토하고, 포함하기 전에 생성된 파일이나 빌드 파일이 프로젝트에서 예상하는 파일인지 확인합니다.
- 사용자가 명시적으로 요청하지 않는 한 Git 구성을 수정하거나, 훅을 건너뛰거나, 강제 푸시하거나, 기존 커밋을 수정하지 마십시오.
- 기존 사용자 변경 사항과 에이전트의 변경 사항을 섞지 마십시오.
- 작업 경계, 파일 소유권, 논리적 분할 또는 민감한 파일 상태가 불분명하면 중단하고 질문하십시오.
- 메시지를 생성하는 것이 커밋을 생성할 권한을 의미하지는 않습니다.
git add또는git commit전에 명시적인 커밋 요청이 필요합니다.
참조
전체 모드에서 또는 유형, 푸터, 주요 변경 사항, 되돌리기, SemVer 또는 FAQ 질문에 대한 자세한 처리가 필요할 때 references/conventional-commits.md를 읽습니다.