본문으로 건너뛰기

문서

PR-TRAIN 소개

PR을 열면 리뷰, 빌드, 수정, 머지까지 알아서 합니다, GitHub 앱 하나로 켜고 저장소 파일은 고치지 않습니다

시작하기

PR-TRAIN은 GitHub 저장소의 PR을 받아 대기열에 세우고, 리뷰하고, XenoCI 머신에서 빌드하고, 빨간불은 AI가 고친 뒤, 조건이 맞으면 머지합니다. 워크플로 파일은 고치지 않습니다

  1. GitHub로 로그인GitHub 계정으로 로그인합니다, 따로 만드는 계정이나 키는 없습니다
  2. 앱 설치GitHub에서 Xeno-CI 앱을 조직에 설치하고 저장소를 고릅니다, 설치 중 GitHub의 2단계 인증(2FA)이나 본인 확인(sudo) 화면이 나올 수 있습니다
  3. 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.languageko 또는 en, 리뷰 코멘트 언어ko
review.ignoreglob 목록, 맞는 파일은 리뷰에서 뺍니다없음
review.focus문자열, 리뷰어에게 더 줄 지시없음
review.rules문자열 목록(또는 name, paths, priority, text 를 가진 항목), REVIEW.md 규칙과 함께 봅니다, 최대 10개없음
fix.enabledtrue 또는 false, false 면 리뷰만 하고 AI 수정은 하지 않습니다true
fix.max_tries1~3, PR 하나에 AI 수정 시도 횟수3
merge.autotrue 또는 false, false 면 사람이 승인한 뒤 머지합니다저장소 설정
build.run문자열 하나 또는 문자열 목록, 자동 추정한 명령 대신 돌립니다(도구 설치 단계는 유지)자동 추정
ai.pr_cap_wonPR 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 cancelPR-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 vCPUxenoci-2vcpu-ubuntu-240413원
리눅스 4 vCPUxenoci-4vcpu-ubuntu-240419원
리눅스 8 vCPUxenoci-8vcpu-ubuntu-240431원
리눅스 16 vCPUxenoci-16vcpu-ubuntu-240455원
맥xenoci-standard60원

보안

AI 리뷰와 수정은 AI 모델 API로 처리하며, 고객 코드로 학습하지 않는 API 공급자만 씁니다. 버튼과 명령은 저장소 write 권한이 있는 사람만 쓸 수 있습니다

PR만 올리면
초록으로 돌아옵니다

GitHub에 설치