6.3 KiB
Roo Codeへの貢献
Roo Codeへの貢献に興味を持っていただき、ありがとうございます。バグの修正、機能の追加、またはドキュメントの改善など、すべての貢献がRoo Codeをよりスマートにします!コミュニティを活気に満ちた歓迎的なものに保つため、すべてのメンバーは行動規範を順守する必要があります。
コミュニティに参加する
すべての貢献者にDiscordコミュニティへの参加を強く推奨します!Discordサーバーに参加することで以下のメリットがあります:
- 貢献に関するリアルタイムのヘルプとガイダンスを得られる
- 他の貢献者やコアチームメンバーとつながれる
- プロジェクトの開発と優先事項について最新情報を得られる
- Roo Codeの将来を形作るディスカッションに参加できる
- 他の開発者とのコラボレーションの機会を見つけられる
バグや問題の報告
バグレポートはRoo Codeをより良くするのに役立ちます!新しい課題を作成する前に、重複を避けるために既存の課題を検索してください。バグを報告する準備ができたら、関連情報の入力を手助けするテンプレートが用意されている課題ページにアクセスしてください。
🔐 重要: セキュリティ脆弱性を発見した場合は、Githubセキュリティツールを使用して非公開で報告してください。
取り組む内容の決定
良い最初の貢献を探していますか?Roo Code Issues 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
- ウェブビュー(Vite/ReactアプリとHMR)を起動します:
npm run dev
- デバッグ:
VSCodeで
F5キー(または実行→デバッグの開始)を押すと、Roo Codeがロードされた新しいセッションが開きます。
ウェブビューへの変更はすぐに反映されます。コア拡張機能への変更は、拡張機能ホストの再起動が必要です。
または、.vsixファイルをビルドしてVSCodeに直接インストールすることもできます:
npm run build
bin/ディレクトリに.vsixファイルが作成され、以下のコマンドでインストールできます:
code --install-extension bin/roo-cline-<version>.vsix
コードの作成と提出
誰でもRoo Codeにコードを貢献できますが、貢献がスムーズに統合されるように以下のガイドラインに従ってください:
-
プルリクエストを焦点を絞ったものにする
- PRを単一の機能またはバグ修正に限定する
- より大きな変更を小さく関連したPRに分割する
- 変更を独立してレビューできる論理的なコミットに分ける
-
コード品質
- すべてのPRはlintingとフォーマットの両方を含むCIチェックに合格する必要がある
- 提出前にESLintの警告やエラーを解決する
- 自動コードレビューツールであるEllipsisからのすべてのフィードバックに対応する
- TypeScriptのベストプラクティスに従い、型の安全性を維持する
-
テスト
- 新機能にはテストを追加する
npm testを実行してすべてのテストが合格することを確認する- 変更が影響する既存のテストを更新する
- 適切な場合は単体テストと統合テストの両方を含める
-
コミットガイドライン
- 明確で説明的なコミットメッセージを書く
- #issue-number を使用してコミットで関連する課題を参照する
-
提出前に
- 最新のmainブランチに対してあなたのブランチをリベースする
- あなたのブランチが正常にビルドされることを確認する
- すべてのテストが合格していることを再確認する
- デバッグコードやコンソールログがないか変更を見直す
-
プルリクエストの説明
- 変更内容を明確に説明する
- 変更をテストするための手順を含める
- 破壊的変更がある場合はリストアップする
- UI変更の場合はスクリーンショットを追加する
貢献同意
プルリクエストを提出することにより、あなたの貢献がプロジェクトと同じライセンス(Apache 2.0)の下でライセンスされることに同意したものとみなします。