[TIL] 2026-02-12 | 협업하기

언제나 위기는 온다.

1. GitHub

- 규칙 세우기

브랜치는 용도를 다했으면 미련없이 갈아 끼우자!

병합 전에 대상 확인 잘하자.

main에 실수로 올릴 경우 커밋 기록에서 새 브랜치로 갈자.. 'Create branch from commit'

 

- Pull Request 템플릿 사용

## 변경 사항
<!-- 무엇을 왜 수정했는지 작성 -->
- 

---

## PR 유형
<!-- 하나 이상 선택 -->
- [ ] 기능 추가
- [ ] 버그 수정
- [ ] UI 변경
- [ ] 블루프린트 수정
- [ ] C++ 수정
- [ ] 에셋 수정/추가
- [ ] 리팩토링
- [ ] 기타

---

## 테스트
- [ ] 에디터에서 정상 동작 확인 (PIE)
- [ ] 기존 기능 이상 없음

---

## 참고 사항
<!-- 리뷰어가 알면 좋은 내용 있으면 작성 -->
-

pull_request_template.md

0.00MB

 

git의 main에서 루트 폴더에 파일을 추가 해두면 pr 올릴 때 자동으로 템플릿이 적용된다 👍

into 대상 더블 체크 할 수 있는 내용을 추가하면 더 좋을 것 같다.

 

2. 애자일

매일 아침 저녁 스크럼 진행 (스크럼 마스터 주도)

주차별 스프린트로 진행 상황 체크 ( 4시간? 정도 작업 단위가 좋음)

 

- Merge

기능 개발 브랜치를 develop 브랜치에 병합 진행

일주일에 한 번씩?

 

3. 코드 컨벤션

기본 언리얼 규칙 준수

[Project Sanzo] 코드 컨벤션

1. 🎯 기본 원칙

• UE 표준 준수: 기본적으로 Unreal Engine 코딩 표준을 따릅니다.
• 가독성 우선: "왜"와 "무엇"을 설명하는 코드를 작성합니다.

2. 네이밍 규칙 (Naming Conventions)

명확성과 일관성을 위해 PascalCase를 사용하며, 줄임말 사용을 지양합니다.

📁 클래스 및 에셋 명명

• 프로젝트 접두사: 커스텀 클래스에는 **Sanzo*를 붙입니다. (예: ASanzoCharacter)
• C++ 클래스: 생성 시 별도의 접미사 없이 이름만 사용합니다. (엔진 표준 접두사 A, U, F 등은 자동 적용)
• 블루프린트: 파생된 블루프린트 에셋은 반드시 BP_ 접두사를 붙입니다.
  • Good: BP_SanzoCharacter
  • Bad: SanzoCharacter_BP, MyCharacter

✍️ 변수 및 함수

• 원칙: 읽는 사람이 바로 이해할 수 있도록 명확하고 간결하게 짓습니다.
• 줄임말 지양: 부득이한 경우를 제외하고는 풀네임을 사용합니다.
  • Good: LastUpdateTime
  • Bad: LUT

클래스 및 함수

• 새 클래스 생성 시 접근자는 **public*으로 시작합니다.
• 기능 단위로 **#region ~ #endregion*을 사용하여 구획을 나눕니다.
• 인자가 길어지는 함수는 한 줄에 인자 하나씩 작성하여 가독성을 높입니다.

C++

// Bad
GetWorldTimerManager().SetTimer(Handle, this, &ASparta::Func, 0.1f, true);

// Good
GetWorldTimerManager().SetTimer(
    HUDUpdateTimerHandle,
    this,
    &ASpartaGameState::UpdateHUD,
    0.1f,
    true
);

제어문

• 내용이 한 줄인 if 문은 중괄호 없이 한 줄로 처리합니다.

C++

// Good
if (!character) return nullptr;

4. 💬 주석 가이드 (Comments)

• 위치: 구현부(함수) 바로 위에 작성합니다.
• 내용: 단순 동작 설명보다는 **"의도(Why)"**와 **"맥락(What)"**을 적습니다.

C++

// Bad: 체력을 0으로 만듦
// Good: 사망 처리를 위해 체력을 초기화하고 랙돌 모드로 전환 준비
Health = 0.0f;

---

Tip: 위 내용을 팀 공지방에 바로 올리시거나, .clang-format 파일만 프로젝트 저장소에 커밋해 두시면 별도 공지 없이도 팀원들의 코드 스타일이 자동으로 맞춰질 것입니다.

코드 블록 지정

#pragma region 기능 설명
#pragma endregion 이름

 

4. 소통

소통을 잘 하자

충돌을 예방하자