Roo-Code/locales/zh-TW/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 是一個由社群驅動的專案，我們非常重視每一份貢獻。為了簡化協作流程，我們採用 「Issue 優先」的方法，這意味著所有的 Pull Request (PR) 都必須先連結到一個 GitHub Issue。請仔細閱讀本指南。

目錄

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

在您貢獻之前

1. 行為準則

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

2. 專案路線圖

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

可靠性第一 (Reliability First)

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

增強的使用者體驗 (Enhanced User Experience)

• 簡化 UI/UX，提高清晰度和直覺性。
• 持續改進工作流程，以滿足開發者對日常使用工具的高期望。

在 Agent 效能上領先 (Leading on Agent Performance)

• 建立全面的評估基準 (Evals) 來衡量實際應用的生產力。
• 讓每個人都能輕鬆執行和解讀這些評估結果。
• 發布能顯示評估分數有明顯提升的改進。

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

3. 加入 Roo Code 社群

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

尋找和規劃您的貢獻

貢獻類型

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

Issue 優先方法

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

• 檢查現有 Issue：在 GitHub Issues 中搜尋。
• 使用以下範本建立 Issue：
  • 增強功能： 「Enhancement Request」範本（著重於使用者利益的淺顯描述）。
  • 錯誤 「Bug Report」範本（最少的重現步驟 + 預期與實際結果 + 版本）。
• 想參與其中嗎？ 在 Issue 上留言「Claiming」，並在 Discord 上私訊 Hannes Rudolph (hrudolph) 以獲得分配。分配結果將在討論串中確認。
• PR 必須連結到 Issue。 未連結的 PR 可能會被關閉。

決定做什麼

• 查看 GitHub 專案 中的「Issue [Unassigned]」。
• 如需文件，請造訪 Roo Code Docs。

回報錯誤

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

開發和提交流程

開發設定

1. Fork 與 Clone：

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

2. 安裝相依套件：

pnpm install

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

程式碼撰寫指南

• 每個功能或修復使用一個單一目的的 PR。
• 遵循 ESLint 和 TypeScript 的最佳實務。
• 撰寫清晰、描述性的 Commit 訊息，並引用 Issue（例如，Fixes #123）。
• 提供全面的測試（npm test）。
• 在提交前 Rebase 到最新的 main 分支。

提交 Pull Request

• 如果希望獲得早期回饋，請以 Draft PR 開始。
• 遵循 Pull Request 範本，清晰地描述您的變更。
• 在 PR 描述/標題中連結 Issue（例如，「Fixes #123」）。
• 為使用者介面變更提供螢幕截圖/影片。
• 指明是否需要更新文件。

Pull Request 政策

• 必須引用一個已指派的 GitHub Issue。如要被指派：請在 Issue 上留言「Claiming」，並在 Discord 上私訊 Hannes Rudolph (hrudolph)。指派結果將可在討論串中確認。
• 未連結 Issue 的 PR 可能會被關閉。
• PR 必須通過 CI 測試，與路線圖保持一致，並有清晰的文件。

審查流程

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

法律資訊

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