@channel-io/create-repo-setting

원클릭 레포지토리 세팅 스크립트. channel-git-flow 브랜치 전략, CI 프리셋, AI review bot을 자동 구성합니다.

사용법

npx @channel-io/create-repo-setting

dry-run (실제 실행 없이 확인):

npx @channel-io/create-repo-setting --dry-run

기능

두 가지 모드

• 새 레포 생성: 템플릿 선택 → 브랜치 → Rulesets → CI → AI Review Bot
• 기존 레포에 세팅 추가: 현재 폴더 또는 레포명 입력 → 필요한 기능만 선택

대화형 설정

• 레포 이름: 입력 또는 현재 폴더 자동 감지
• 보일러플레이트: Go, Next.js, Python 등 org 템플릿 선택
• 브랜치: channel-git-flow (master + exp) 자동 생성
• Rulesets: 브랜치 보호 규칙 자동 적용
• CI: 언어별 빌드/테스트 워크플로우 (TypeScript, Go, Python)
• AI Review Bot: claude-code-action 또는 core-be-review-bot 선택

기존 레포 분석

• GitHub API로 원격 레포 자동 분석
• 언어 감지 (package.json, go.mod, pyproject.toml)
• 기존 CI/Review Bot/브랜치 존재 여부 확인
• 이미 있는 설정은 알려주고, 덮어쓸지 선택 가능

보일러플레이트 (org 템플릿)

| 템플릿 | 언어 | 설명 | |--------|------|------| | go-boilerplate | Go | Go 서비스 표준 | | golang-app-template | Go | Go 앱 | | next-template | TypeScript | Next.js | | python-boilerplate | Python | Python 서비스 | | cursor-cli | Go | CLI 도구 |

브랜치 전략 (channel-git-flow)

• master: 프로덕션 배포 브랜치 (default)
• exp: 개발 브랜치 (대부분의 PR 대상)

AI Review Bot

두 가지 옵션 중 선택:

• claude-code-action: 커스텀 에이전트 리뷰 (SKILL.md 기반)
• core-be-review-bot: 범용 리뷰 봇 (중앙 관리)

claude-code-action 커스터마이징

스크립트가 기본 리뷰 스킬(.claude/skills/code-review/SKILL.md)을 생성합니다. 프로젝트에 맞게 커스터마이징하려면:

1. SKILL.md 수정 — 리뷰 절차, 심각도 기준, 코멘트 문체를 프로젝트에 맞게 조정
2. 전문 에이전트 추가 — .claude/skills/code-review/agents/ 아래에 에이전트 파일 생성

에이전트 예시 (channel-labs):

.claude/skills/code-review/agents/
├── api-design.md      # API 설계, 라우트, 응답 포맷
├── code-quality.md    # 버그, 보안, 에러 핸들링
└── eda-pipeline.md    # 도메인 특화 리뷰

각 에이전트 파일에는 담당 영역과 체크리스트를 정의합니다. SKILL.md에서 에이전트를 병렬로 디스패치하면 멀티앵글 리뷰가 가능합니다.

참고: channel-labs 리뷰 봇 구현

필요한 Secrets

AI Review Bot 사용 시 아래 secrets가 org 또는 레포 레벨에 필요합니다:

| 종류 | 이름 | 용도 | |------|------|------| | Variable | CTO_PROPOSAL_CLIENT_ID | GitHub App ID (org 레벨에 이미 설정됨) | | Secret | CTO_PROPOSAL_PRIVATE_KEY | GitHub App private key (org 레벨에 이미 설정됨) | | Secret | ANTHROPIC_API_KEY | Claude API key (레포별 설정 필요) |

사전 요구사항

• Node.js 20+
• gh CLI 인증 (gh auth login)
• channel-io org 접근 권한

개발

npm install
npm run dev         # 로컬 실행
npm run dev -- --dry-run  # dry-run 모드
npm run build       # 빌드