Roo Code에 기여하기

Roo Code에 기여하는 데 관심을 가져주셔서 기쁩니다. 버그를 수정하든, 기능을 추가하든, 문서를 개선하든, 모든 기여는 Roo Code를 더 스마트하게 만듭니다! 우리 커뮤니티를 활기차고 친절하게 유지하기 위해, 모든 구성원은 우리의 행동 강령을 준수해야 합니다.

우리 커뮤니티에 참여하세요

모든 기여자가 우리의 Discord 커뮤니티에 참여할 것을 강력히 권장합니다! Discord 서버의 일원이 되면 다음과 같은 도움을 받을 수 있습니다:

기여에 대한 실시간 도움과 지침 얻기
다른 기여자 및 핵심 팀원과 연결
프로젝트 개발 및 우선순위에 대한 최신 정보 유지
Roo Code의 미래를 형성하는 토론에 참여
다른 개발자와의 협업 기회 찾기

버그 또는 이슈 보고하기

버그 보고는 모두를 위해 Roo Code를 더 좋게 만드는 데 도움이 됩니다! 새 이슈를 만들기 전에, 중복을 피하기 위해 기존 이슈 검색을 해주세요. 버그를 보고할 준비가 되면, 관련 정보를 작성하는 데 도움이 되는 템플릿이 있는 이슈 페이지로 이동하세요.

🔐 중요: 보안 취약점을 발견한 경우, 비공개로 보고하기 위해 Github 보안 도구를 사용하세요.

작업할 내용 결정하기

첫 기여를 위한 좋은 시작점을 찾고 계신가요? 우리의 Roo Code 이슈 Github 프로젝트의 "Issue [Unassigned]" 섹션에서 이슈를 확인하세요. 이러한 이슈들은 새로운 기여자와 우리가 도움을 필요로 하는 영역을 위해 특별히 선별되었습니다!

우리는 문서에 대한 기여도 환영합니다! 오타 수정, 기존 가이드 개선 또는 새로운 교육 콘텐츠 생성 등 - 모든 사람이 Roo Code를 최대한 활용할 수 있도록 도와주는 커뮤니티 기반 리소스 저장소를 구축하고 싶습니다. 모든 페이지에서 "Edit this page"를 클릭하여 파일을 편집할 수 있는 Github의 적절한 위치로 빠르게 이동하거나, https://github.com/RooVetGit/Roo-Code-Docs에 직접 접근할 수 있습니다.

더 큰 기능 작업을 계획하고 있다면, Roo Code의 비전과 일치하는지 논의할 수 있도록 먼저 기능 요청을 생성해주세요.

개발 설정

저장소 클론:

git clone https://github.com/RooVetGit/Roo-Code.git

의존성 설치:

npm run install:all

웹뷰 시작(HMR이 있는 Vite/React 앱):

npm run dev

디버깅: VSCode에서 F5를 누르거나(실행 → 디버깅 시작) Roo Code가 로드된 새 세션을 엽니다.

웹뷰의 변경 사항은 즉시 나타납니다. 코어 확장에 대한 변경 사항은 확장 호스트를 다시 시작해야 합니다.

또는 .vsix를 빌드하고 VSCode에 직접 설치할 수 있습니다:

npm run build

bin/ 디렉토리에 .vsix 파일이 나타나며 다음 명령으로 설치할 수 있습니다:

code --install-extension bin/roo-cline-<version>.vsix

코드 작성 및 제출

누구나 Roo Code에 코드를 기여할 수 있지만, 기여가 원활하게 통합될 수 있도록 다음 지침을 따라주시기 바랍니다:

Pull Request 집중
- PR을 단일 기능 또는 버그 수정으로 제한
- 더 큰 변경사항을 더 작고 관련된 PR로 분할
- 독립적으로 검토할 수 있는 논리적인 커밋으로 변경사항 분할
코드 품질
- 모든 PR은 린팅 및 포맷팅을 포함한 CI 검사를 통과해야 함
- 제출하기 전에 모든 ESLint 경고나 오류 해결
- Ellipsis, 자동화된 코드 리뷰 도구의 모든 피드백에 응답
- TypeScript 모범 사례를 따르고 타입 안전성 유지
테스팅
- 새로운 기능에 대한 테스트 추가
- 모든 테스트가 통과하는지 확인하기 위해 npm test 실행
- 변경사항이 영향을 미치는 경우 기존 테스트 업데이트
- 적절한 경우 단위 테스트와 통합 테스트 모두 포함
커밋 가이드라인
- 명확하고 설명적인 커밋 메시지 작성
- #이슈-번호를 사용하여 커밋에서 관련 이슈 참조
제출 전
- 최신 main에 브랜치 리베이스
- 브랜치가 성공적으로 빌드되는지 확인
- 모든 테스트가 통과하는지 다시 확인
- 디버깅 코드나 콘솔 로그가 있는지 변경사항 검토
Pull Request 설명
- 변경사항이 무엇을 하는지 명확하게 설명
- 변경사항을 테스트하는 단계 포함
- 모든 주요 변경사항 나열
- UI 변경사항에 대한 스크린샷 추가

기여 동의

Pull request를 제출함으로써, 귀하의 기여는 프로젝트와 동일한 라이선스(Apache 2.0)에 따라 라이선스가 부여된다는 데 동의합니다.

5.5 KiB Raw Permalink Blame History