QA가 패치노트를 직접 만들게 된 날 (권한 대기중)

현재 사용 편리한 API 기준으로 작성한다.
필요 준비물은 이렇다.
1. 노션 API 키 발급
2. 커밋 메세지 규칙 정립
3. 노션 페이지 생성 (ID)

 

 

 

api는 키 값 요청해둔 상태여서 일단 보류

 

 

 

 

2. 커밋 메세지 규칙 정립 레쓰고

 

 

소스트리 커밋 → 노션 패치노트 자동화 1편: 설계 및 준비

배경

우리 팀은 패치노트를 아사나 작업리스트와 버그리포팅 내용 바탕으로 작성하고 있었다.
근데 인원이 모두 바뀌기도 했고, 체계를 만드려는 사람이 없어서~
소스트리에서 커밋하면 노션에 자동으로 정리되는 시스템을 만들기로 했다.

---

전체 구조

소스트리 커밋/푸시 → GitHub 저장소 → GitHub Actions → 노션 자동 업데이트

핵심은 GitHub Actions다.
소스트리로 푸시하면 GitHub가 자동으로 스크립트를 실행해서 노션에 써준다.
추가 서버도 없고, 유료 서비스도 없다. GitHub 계정만 있으면 된다.

---

준비물

• GitHub 저장소 (이미 소스트리로 연결된 것)
• 노션 워크스페이스
• 노션 API 키 (워크스페이스 소유자가 발급)  /  준비물 해결이 불가능하다 추후에 이어서 작성함

---

1단계: 노션 API 키 발급

노션 API 키는 워크스페이스 소유자 계정에서만 만들 수 있다.

1. https://www.notion.so/my-integrations 접속
2. + 새 연결 클릭
3. 이름 입력 (예: Patch-Bot) → 액세스 토큰 선택 → 워크스페이스 선택 → 연결 생성
4. secret_xxxxxxxxxx 형태의 키 복사해서 보관

주의: 여기서 막히는 경우가 있다.
워크스페이스 멤버 계정으로는 API 통합을 생성할 수 없다.
노션 설정 → 사람 탭에서 워크스페이스 소유자 확인 후 해당 계정으로 발급받거나 부탁해야 한다.

---

2단계: 커밋 메시지 규칙 정하기

자동화가 제대로 작동하려면 커밋 메시지에 일관된 규칙이 있어야 한다.
파싱할 패턴이 없으면 노션에 뭘 써야 할지 스크립트가 모른다.

우리 팀은 이미 이런 형식으로 쓰고 있었다:

[서버검증] 웨이브시작 페이지 셋업 + 로그뷰어 ph 항목 제더 enum표기
[플랫/MCP] com.coplaydev.unity-mcp 패키지 및 GameSpeedMenu 추가
[검증 v2] ShopEnter shopHash 기록 추가

[카테고리] 내용 형식이 이미 잡혀 있어서 이걸 그대로 파싱하기로 했다.

노션에는 이렇게 쌓인다:

날짜카테고리내용작성자

2026-06-26	서버검증	웨이브시작 페이지 셋업 + 로그뷰어	dhhwang
2026-06-26	플랫/MCP	unity-mcp 패키지 추가	oribori

---

다음 편 예고

• GitHub Actions 스크립트 작성
• 노션 패치노트 페이지 연결
• 실제 커밋 → 노션 자동 업데이트 테스트