Source Control

Kiro의 Source Control 뷰는 표준 Git 기능 위에 AI 보조 기능을 더해, 변경 사항을 더 빠르게 정리하고 커밋 메시지를 자연스럽게 작성할 수 있도록 돕습니다.

개요

Kiro의 Source Control 패널은 VS Code 계열의 친숙한 Git UI를 그대로 제공하면서, 스테이징된 변경 내용을 모델이 이해해 의미 있는 커밋 메시지를 만들어 주거나 채팅에서 변경 사항을 직접 다룰 수 있도록 확장합니다. 일상적인 stage → commit → push 흐름을 유지하면서도, 메시지 작성이나 충돌 해결처럼 시간을 잡아먹던 단계를 단축할 수 있습니다.

AI 커밋 메시지 생성

스테이징된 diff를 분석해 Conventional Commits 형식에 맞는 커밋 메시지를 자동으로 작성합니다. 변경 범위와 의도를 한 번에 정리할 수 있어, 매번 메시지 양식을 떠올리는 부담이 줄어듭니다.

1. Source Control 패널에서 커밋할 파일을 스테이징합니다.
2. 커밋 메시지 입력란 옆의 마법봉 아이콘(🪄) 버튼을 클릭합니다.
3. 생성된 메시지를 확인하고 필요한 부분만 다듬습니다.
4. Commit 버튼을 눌러 변경 사항을 기록합니다.

메시지 형식

생성되는 메시지는 Conventional Commits 규약을 따릅니다. 첫 줄은 타입과 스코프, 요약으로 구성되며 그 아래에는 변경 내용을 항목 단위로 풀어 둡니다.

<type>(<scope>): <subject>
- First change or addition
- Second change or improvement
- Third change if applicable
- Why this change was needed (if relevant)

주요 타입

• feat — 새 기능 추가
• fix — 버그 수정
• docs — 문서 변경
• style — 코드 스타일/포맷
• refactor — 동작 변화 없는 구조 개선
• test — 테스트 추가/수정
• chore — 빌드, 설정 등 잡무
• perf — 성능 개선
• ci — CI/CD 파이프라인 변경

실제 생성 예시

feat(docs): add comprehensive Source Control documentation
- Create new documentation page for Source Control features
- Update interface documentation to link to Source Control page
- Provide detailed explanation of AI-powered commit message generation
- Describe diff context provider and commit message generation process

#Git Diff 컨텍스트 프로바이더

채팅 입력창에서 #Git Diff를 입력하면, 현재 작업 트리에 있는 staged·unstaged 변경 사항이 함께 모델로 전달됩니다. 변경된 코드를 직접 붙여 넣지 않아도 Kiro가 맥락을 파악하므로, 리뷰·리팩터링·충돌 해결 같은 작업을 자연어로 의뢰하기 좋습니다.

Hey Kiro, can you fix the merge conflicts? #Git Diff

문제 해결

Git 명령이 실패하거나 메시지 생성이 동작하지 않는다면 다음을 먼저 확인합니다.

• 로컬 Git 설정과 인증 정보(user.name, user.email, 자격 증명 헬퍼)가 올바른지 점검합니다.
• 현재 사용자가 해당 저장소에 대한 적절한 읽기/쓰기 권한을 가지고 있는지 확인합니다.
• 스테이징된 변경이 비어 있으면 메시지 생성이 호출되지 않으므로, 최소 한 개 이상의 파일을 스테이징해야 합니다.