CONTRIBUTING.md

English • Català • Deutsch • Español • Français • हिंदी • Bahasa Indonesia • Italiano • 日本語

한국어 • Nederlands • Polski • Português (BR) • Русский • Türkçe • Tiếng Việt • 简体中文 • 繁體中文

為 Roo Code 做出貢獻

Roo Code 是一個由社群驅動的專案，我們非常重視每一份貢獻。為了簡化協作，我們採用 「問題優先」的方法，這意味著所有的 拉取請求 (PR) 都必須先連結到一個 GitHub 問題。請仔細閱讀本指南。

目錄

• 在您貢獻之前
• 尋找和規劃您的貢獻
• 開發和提交流程
• 法律

在您貢獻之前

1. 行為準則

所有貢獻者都必須遵守我們的 行為準則。

2. 專案路線圖

我們的路線圖指導著專案的方向。請將您的貢獻與這些關鍵目標保持一致：

可靠性第一

• 確保差異編輯和命令執行始終可靠。
• 減少阻礙常規使用的摩擦點。
• 保證在所有地區和平台上的流暢操作。
• 擴大對各種人工智慧提供商和模型的強大支援。

增強的使用者體驗

• 簡化使用者介面/使用者體驗，以提高清晰度和直觀性。
• 不斷改進工作流程，以滿足開發人員對日常使用工具的高期望。

在代理效能上領先

• 建立全面的評估基準 (evals) 來衡量真實世界的生產力。
• 讓每個人都能輕鬆執行和解釋這些評估。
• 發布能顯示評估分數明顯提高的改進。

在您的 PR 中提及與這些領域的一致性。

3. 加入 Roo Code 社群

• 主要方式： 加入我們的 Discord 並私訊 Hannes Rudolph (hrudolph)。
• 替代方式： 經驗豐富的貢獻者可以透過 GitHub 專案 直接參與。

尋找和規劃您的貢獻

貢獻類型

• 錯誤修復： 解決程式碼問題。
• 新功能： 新增功能。
• 文件： 改進指南和清晰度。

問題優先方法

所有貢獻都始於使用我們精簡範本的 GitHub 問題。

• 檢查現有問題：在 GitHub 問題 中搜尋。
• 使用以下範本建立問題：
  • 增強功能： 「增強請求」範本（著重於使用者利益的簡單語言）。
  • 錯誤： 「錯誤報告」範本（最少的重現步驟 + 預期與實際 + 版本）。
• 想參與其中嗎？ 在問題上評論“領取”，並在Discord上私訊 Hannes Rudolph (hrudolph) 以獲得分配。分配將在帖子中確認。
• PR 必須連結到問題。 未連結的 PR 可能會被關閉。

決定做什麼

• 查看 GitHub 專案 中的「問題 [未分配]」問題。
• 如需文件，請造訪 Roo Code 文件。

報告錯誤

• 首先檢查現有的報告。
• 使用 「錯誤報告」範本 建立一個新錯誤，並提供：
  • 清晰、編號的重現步驟
  • 預期與實際結果
  • Roo Code 版本（必需）；如果相關，還需提供 API 提供商/模型
• 安全問題：透過 安全公告 私下報告。

開發和提交流程

開發設定

1. 複製和克隆：

git clone https://github.com/您的使用者名稱/Roo-Code.git

2. 安裝依賴項：

pnpm install

3. 偵錯： 使用 VS Code 開啟（F5）。

編碼指南

• 每個功能或修復一個集中的 PR。
• 遵循 ESLint 和 TypeScript 的最佳實踐。
• 編寫清晰、描述性的提交，並引用問題（例如，修復 #123）。
• 提供全面的測試（npm test）。
• 在提交前變基到最新的 main 分支。

提交拉取請求

• 如果希望獲得早期回饋，請以 草稿 PR 開始。
• 遵循拉取請求範本，清晰地描述您的變更。
• 在 PR 描述/標題中連結問題（例如，“修復 #123”）。
• 為使用者介面變更提供螢幕截圖/影片。
• 指明是否需要更新文件。

拉取請求政策

• 必須引用一個已分配的 GitHub 問題。要獲得分配：在問題上評論“領取”，並在Discord上私訊 Hannes Rudolph (hrudolph)。分配將在帖子中確認。
• 未連結的 PR 可能會被關閉。
• PR 必須通過 CI 測試，與路線圖保持一致，並有清晰的文件。

審查流程

• 每日分類： 維護人員進行快速檢查。
• 每週深入審查： 全面評估。
• 根據回饋及時迭代。

法律

透過貢獻，您同意您的貢獻將根據 Apache 2.0 授權進行授權，這與 Roo Code 的授權一致。