문서
PR-TRAIN 소개
PR을 열면 리뷰, 빌드, 수정, 머지까지 알아서 합니다, GitHub 앱 하나로 켜고 저장소 파일은 고치지 않습니다
시작하기
PR-TRAIN은 GitHub 저장소의 PR을 받아 대기열에 세우고, 리뷰하고, XenoCI 머신에서 빌드하고, 빨간불은 AI가 고친 뒤, 조건이 맞으면 머지합니다. 워크플로 파일은 고치지 않습니다
- GitHub로 로그인GitHub 계정으로 로그인합니다, 따로 만드는 계정이나 키는 없습니다
- 앱 설치GitHub에서 Xeno-CI 앱을 조직에 설치하고 저장소를 고릅니다, 설치 중 GitHub의 2단계 인증(2FA)이나 본인 확인(sudo) 화면이 나올 수 있습니다
- PR 열기켜진 저장소의 PR은 라벨도 명령도 없이 들어옵니다
동작 순서
- 대기열: /prtrain urgent 가 맨 앞, 그다음 핫픽스, 작은 변경, 들어온 순서로 처리합니다
- 리뷰: diff와 호출부를 읽고 막는 지적(P0, P1)만 수정으로 넘깁니다
- 빌드: 자리가 비면 다음 PR이 기다리지 않고 XenoCI 머신에서 빌드합니다
- AI 수정: 리뷰에서 막는 지적이 나오거나 빌드가 깨지면 AI가 같은 PR 브랜치에 고친 커밋을 올리고 다시 빌드합니다, 최대 4번
- 머지: 아래 머지 조건이 모두 맞으면 PR의 base 브랜치로 머지합니다
설정 파일
저장소 루트의 .xenoci.yml 로 리뷰, 수정, 머지를 정합니다. 기본 브랜치에 머지된 파일만 읽습니다, PR 이 바꾼 값은 그 PR 에 쓰이지 않습니다. 파일이 없으면 기본값을 쓰고, .xenoci.yml 이 없을 때만 옛 .prtrain/config.yml 을 읽습니다
앱을 설치하면 주석 달린 기본 파일을 넣는 PR(XenoCI 설정 파일 추가)이 한 번 열립니다, 머지는 직접 합니다. 설치 뒤 나오는 설정 페이지(/setup)에서 저장소마다 리뷰만, 리뷰와 수정, 리뷰와 수정과 자동 머지 중 하나를 고르면 그 값으로 PR 의 파일을 바꿉니다
review:
language: ko # 리뷰 코멘트 언어: ko | en
ignore: ["docs/**"] # 리뷰에서 뺄 파일
focus: "결제 경로를 먼저 봐 주세요"
rules:
- "API 응답에 내부 오류 문구를 그대로 내보내지 않는다"
fix:
enabled: true # false 면 리뷰만
max_tries: 3 # PR 하나에 AI 수정 1~3번
merge:
auto: false # true 면 검증이 끝난 PR 을 사람 승인 없이 머지
build:
run: # 자동 추정 대신 돌릴 검증 명령
- npm ci
- npm test| 키 | 값 | 기본값 |
|---|---|---|
| review.language | ko 또는 en, 리뷰 코멘트 언어 | ko |
| review.ignore | glob 목록, 맞는 파일은 리뷰에서 뺍니다 | 없음 |
| review.focus | 문자열, 리뷰어에게 더 줄 지시 | 없음 |
| review.rules | 문자열 목록(또는 name, paths, priority, text 를 가진 항목), REVIEW.md 규칙과 함께 봅니다, 최대 10개 | 없음 |
| fix.enabled | true 또는 false, false 면 리뷰만 하고 AI 수정은 하지 않습니다 | true |
| fix.max_tries | 1~3, PR 하나에 AI 수정 시도 횟수 | 3 |
| merge.auto | true 또는 false, false 면 사람이 승인한 뒤 머지합니다 | 저장소 설정 |
| build.run | 문자열 하나 또는 문자열 목록, 자동 추정한 명령 대신 돌립니다(도구 설치 단계는 유지) | 자동 추정 |
| ai.pr_cap_won | PR 1건 AI 요금 상한(원), 1 이상 | 기본 상한 |
잘못된 값은 PR 코멘트 한 줄로 알리고 그 키만 기본값으로 진행합니다
PR 명령어
PR 코멘트에 한 줄로 적습니다. 저장소 write 권한 이상인 사람의 명령만 따르고, 권한이 없는 사람에게는 한 줄로 알립니다
| 명령 | 하는 일 |
|---|---|
| @xenoci review | 지금 head 를 다시 리뷰합니다 |
| @xenoci fix | 멈춘 PR 의 AI 수정을 다시 시작합니다 |
| @xenoci pause | 이 PR 의 자동 리뷰와 수정을 멈춥니다 |
| @xenoci resume | 멈춘 PR 을 다시 켭니다 |
| @xenoci merge | 사람 확인을 기다리던 초록 PR을 그 head로 머지합니다, 막는 지적이 남은 PR은 머지하지 않습니다 |
| @xenoci help | 명령 목록을 PR 에 답합니다 |
예전 /prtrain 명령도 그대로 됩니다
| 명령 | 하는 일 |
|---|---|
| /prtrain retry | 멈춘 PR을 같은 head로 다시 대기열에 넣습니다 |
| /prtrain merge | @xenoci merge 와 같습니다 |
| /prtrain cancel | PR-TRAIN 처리를 끝냅니다 |
| /prtrain approve | 바깥 기여자 PR을 처리하도록 허락합니다 |
| /prtrain urgent | 대기 중인 PR을 맨 앞으로 보냅니다 |
| /prtrain off | 이 PR을 PR-TRAIN에서 뺍니다 |
| /prtrain build: <명령> | 이 저장소의 검증 명령을 바꿉니다, /prtrain build: auto 는 자동 추정으로 되돌립니다 |
| 라벨 | 하는 일 |
|---|---|
| no-prtrain | /prtrain off 와 같습니다 |
| urgent, priority, prtrain:urgent | /prtrain urgent 와 같습니다 |
Slack을 연결했으면 사람이 봐야 할 PR을 버튼이 달린 메시지로 받고, 스레드 답장은 AI 수정 지시로 받습니다
자동 머지 조건
- 빌드와 시험 초록
- 막는 지적(P0, P1) 없음
- 위험 경로 아님
- 악용 검사 통과
- 충돌 없음
결제, 삭제, 인증, 보안 같은 위험 경로나 1천 줄이 넘는 변경은 머지하지 않고 PR 코멘트(와 Slack)로 사람 확인을 기다립니다, 확인 뒤 /prtrain merge 를 답니다
요금
PR 1건 500원(1,000줄까지), 넘으면 100줄마다 50원, 위험 PR은 줄 수를 3배로 셉니다. 고객 CI 필수 체크가 초록일 때만 내고, 3번 안에 초록이 안 되면 0원입니다. XenoCI 머신에서 빌드하면 쓴 분만큼 따로입니다. 공개 저장소는 무료입니다(2코어, 조직당 동시 2). 선불 충전한 금액에서 쓴 만큼 줄어듭니다
| 머신 | 라벨 | 분당 |
|---|---|---|
| 리눅스 2 vCPU | xenoci-2vcpu-ubuntu-2404 | 13원 |
| 리눅스 4 vCPU | xenoci-4vcpu-ubuntu-2404 | 19원 |
| 리눅스 8 vCPU | xenoci-8vcpu-ubuntu-2404 | 31원 |
| 리눅스 16 vCPU | xenoci-16vcpu-ubuntu-2404 | 55원 |
| 맥 | xenoci-standard | 60원 |
보안
AI 리뷰와 수정은 AI 모델 API로 처리하며, 고객 코드로 학습하지 않는 API 공급자만 씁니다. 버튼과 명령은 저장소 write 권한이 있는 사람만 쓸 수 있습니다