mirror of
https://github.com/RooVetGit/Roo-Code.git
synced 2026-09-05 08:10:14 +00:00
141 lines
6.4 KiB
Markdown
Generated
141 lines
6.4 KiB
Markdown
Generated
<div align="center">
|
|
<sub>
|
|
|
|
[English](../../CONTRIBUTING.md) • [Català](../ca/CONTRIBUTING.md) • [Deutsch](../de/CONTRIBUTING.md) • [Español](../es/CONTRIBUTING.md) • [Français](../fr/CONTRIBUTING.md) • [हिंदी](../hi/CONTRIBUTING.md) • [Bahasa Indonesia](../id/CONTRIBUTING.md) • <b>Italiano</b> • [日本語](../ja/CONTRIBUTING.md)
|
|
|
|
</sub>
|
|
<sub>
|
|
|
|
[한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • [Polski](../pl/CONTRIBUTING.md) • [Português (BR)](../pt-BR/CONTRIBUTING.md) • [Русский](../ru/CONTRIBUTING.md) • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)
|
|
|
|
</sub>
|
|
</div>
|
|
|
|
# Contribuire a Roo Code
|
|
|
|
Roo Code è un progetto guidato dalla comunità e apprezziamo profondamente ogni contributo. Per semplificare la collaborazione, operiamo su una base [Issue-First](#approccio-issue-first), il che significa che tutte le [Pull Request (PR)](#invio-di-una-pull-request) devono prima essere collegate a un'issue di GitHub. Si prega di leggere attentamente questa guida.
|
|
|
|
## Sommario
|
|
|
|
- [Prima di contribuire](#prima-di-contribuire)
|
|
- [Trovare e pianificare il tuo contributo](#trovare-e-pianificare-il-tuo-contributo)
|
|
- [Processo di sviluppo e invio](#processo-di-sviluppo-e-invio)
|
|
- [Legale](#legale)
|
|
|
|
## Prima di contribuire
|
|
|
|
### 1. Codice di condotta
|
|
|
|
Tutti i contributori devono attenersi al nostro [Codice di condotta](./CODE_OF_CONDUCT.md).
|
|
|
|
### 2. Roadmap del progetto
|
|
|
|
La nostra roadmap guida la direzione del progetto. Allinea i tuoi contributi a questi obiettivi chiave:
|
|
|
|
### Affidabilità prima di tutto
|
|
|
|
- Assicurati che la modifica dei diff e l'esecuzione dei comandi siano costantemente affidabili.
|
|
- Riduci i punti di frizione che scoraggiano l'uso regolare.
|
|
- Garantisci un funzionamento fluido in tutte le localizzazioni e piattaforme.
|
|
- Espandi un supporto solido per un'ampia varietà di provider e modelli di intelligenza artificiale.
|
|
|
|
### Esperienza utente migliorata
|
|
|
|
- Semplifica l'interfaccia utente/esperienza utente per chiarezza e intuitività.
|
|
- Migliora continuamente il flusso di lavoro per soddisfare le elevate aspettative che gli sviluppatori hanno per gli strumenti di uso quotidiano.
|
|
|
|
### Leader nelle prestazioni degli agenti
|
|
|
|
- Stabilisci benchmark di valutazione completi (eval) per misurare la produttività nel mondo reale.
|
|
- Semplifica per tutti l'esecuzione e l'interpretazione di queste valutazioni.
|
|
- Fornisci miglioramenti che dimostrino chiari aumenti nei punteggi di valutazione.
|
|
|
|
Menziona l'allineamento con queste aree nelle tue PR.
|
|
|
|
### 3. Unisciti alla community di Roo Code
|
|
|
|
- **Principale:** Unisciti al nostro [Discord](https://discord.gg/roocode) e invia un DM a **Hannes Rudolph (`hrudolph`)**.
|
|
- **Alternativa:** I contributori esperti possono interagire direttamente tramite i [progetti GitHub](https://github.com/orgs/RooCodeInc/projects/1).
|
|
|
|
## Trovare e pianificare il tuo contributo
|
|
|
|
### Tipi di contributi
|
|
|
|
- **Correzioni di bug:** risoluzione di problemi di codice.
|
|
- **Nuove funzionalità:** aggiunta di funzionalità.
|
|
- **Documentazione:** miglioramento di guide e chiarezza.
|
|
|
|
### Approccio Issue-First
|
|
|
|
Tutti i contributi iniziano con un'issue di GitHub utilizzando i nostri modelli snelli.
|
|
|
|
- **Controlla le issue esistenti**: cerca nelle [issue di GitHub](https://github.com/RooCodeInc/Roo-Code/issues).
|
|
- **Crea un'issue** utilizzando:
|
|
- **Miglioramenti:** modello "Richiesta di miglioramento" (linguaggio semplice incentrato sul vantaggio per l'utente).
|
|
- **Bug:** modello "Segnalazione di bug" (riproduzione minima + previsto vs effettivo + versione).
|
|
- **Vuoi lavorarci?** Commenta "Rivendico" sull'issue e invia un DM a **Hannes Rudolph (`hrudolph`)** su [Discord](https://discord.gg/roocode) per essere assegnato. L'assegnazione verrà confermata nel thread.
|
|
- **Le PR devono essere collegate all'issue.** Le PR non collegate possono essere chiuse.
|
|
|
|
### Decidere su cosa lavorare
|
|
|
|
- Controlla il [progetto GitHub](https://github.com/orgs/RooCodeInc/projects/1) per le issue "Issue [Non assegnata]".
|
|
- Per la documentazione, visita [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs).
|
|
|
|
### Segnalazione di bug
|
|
|
|
- Controlla prima le segnalazioni esistenti.
|
|
- Crea un nuovo bug utilizzando il [modello "Segnalazione di bug"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) con:
|
|
- Passaggi di riproduzione chiari e numerati
|
|
- Risultato previsto vs effettivo
|
|
- Versione di Roo Code (obbligatoria); provider/modello di intelligenza artificiale se pertinente
|
|
- **Problemi di sicurezza**: segnala in privato tramite [avvisi di sicurezza](https://github.com/RooCodeInc/Roo-Code/security/advisories/new).
|
|
|
|
## Processo di sviluppo e invio
|
|
|
|
### Configurazione dello sviluppo
|
|
|
|
1. **Esegui il fork e clona:**
|
|
|
|
```
|
|
git clone https://github.com/TUO_NOME_UTENTE/Roo-Code.git
|
|
```
|
|
|
|
2. **Installa le dipendenze:**
|
|
|
|
```
|
|
pnpm install
|
|
```
|
|
|
|
3. **Debug:** apri con VS Code (`F5`).
|
|
|
|
### Linee guida per la scrittura del codice
|
|
|
|
- Una PR mirata per funzionalità o correzione.
|
|
- Segui le migliori pratiche di ESLint e TypeScript.
|
|
- Scrivi commit chiari e descrittivi che facciano riferimento alle issue (ad es. `Risolve #123`).
|
|
- Fornisci test approfonditi (`npm test`).
|
|
- Esegui il rebase sul ramo `main` più recente prima dell'invio.
|
|
|
|
### Invio di una Pull Request
|
|
|
|
- Inizia come **bozza di PR** se cerchi un feedback iniziale.
|
|
- Descrivi chiaramente le tue modifiche seguendo il modello di Pull Request.
|
|
- Collega l'issue nella descrizione/titolo della PR (ad es. "Risolve #123").
|
|
- Fornisci screenshot/video per le modifiche all'interfaccia utente.
|
|
- Indica se sono necessari aggiornamenti alla documentazione.
|
|
|
|
### Politica sulle Pull Request
|
|
|
|
- Deve fare riferimento a un'issue di GitHub assegnata. Per essere assegnato: commenta "Rivendico" sull'issue e invia un DM a **Hannes Rudolph (`hrudolph`)** su [Discord](https://discord.gg/roocode). L'assegnazione verrà confermata nel thread.
|
|
- Le PR non collegate possono essere chiuse.
|
|
- Le PR devono superare i test di integrazione continua, essere in linea con la roadmap e avere una documentazione chiara.
|
|
|
|
### Processo di revisione
|
|
|
|
- **Triage giornaliero:** controlli rapidi da parte dei manutentori.
|
|
- **Revisione approfondita settimanale:** valutazione completa.
|
|
- **Itera prontamente** in base al feedback.
|
|
|
|
## Legale
|
|
|
|
Contribuendo, accetti che i tuoi contributi siano concessi in licenza con la licenza Apache 2.0, in coerenza con la licenza di Roo Code.
|