AI-gestützte Entwicklung: Mit Vertrauen zu ownCloud beitragen
Erfahren Sie mehr über die KI-gestützte Beitragsstrategie von ownCloud. Lernen Sie unsere Erwartungen, Richtlinien für Entwickler und Prüfstandards kennen.
Unsere Position
ownCloud begrüßt Beiträge, die mit Unterstützung von KI-Tools erstellt wurden.
Wir sind überzeugt, dass großartige Ideen nicht an der Programmiererfahrung scheitern dürfen. Wenn Sie eine Vision haben, wie ownCloud verbessert werden kann – sei es eine neue Web-Erweiterung, ein optimierter Workflow oder eine klar beschreibbare Fehlerbehebung – und KI Ihnen hilft, diese Vision in funktionierenden Code umzusetzen, möchten wir Ihren Beitrag.
Wir haben auf owncloud.dev einen ausführlichen Leitfaden zur KI-gestützten Entwicklung für oCIS-Web-Erweiterungen veröffentlicht. Dieser Leitfaden beschreibt den gesamten Workflow: von Architekturgesprächen mit einem KI-Assistenten über Recherche, Gerüstbau, Implementierung bis hin zu Feinschliff und Beitrag. Wir empfehlen, diesem Leitfaden zu folgen.
Was wir erwarten
KI-gestützte Beiträge unterliegen denselben Qualitätsstandards wie alle anderen Beiträge. Im Review-Prozess zählt nicht, wie der Code entstanden ist, sondern dass er funktioniert, getestet, dokumentiert und wartbar ist.
Jeder KI-gestützte Pull Request muss diese Anforderungen erfüllen:
- Transparenz. Geben Sie in Ihrer PR-Beschreibung an, dass KI-Tools bei der Entwicklung verwendet wurden. Nennen Sie das Tool (z. B. Claude Code, GitHub Copilot, Cursor). Das ist kein Makel – sondern Transparenz. Wir erfassen dies, um unser Contributor-Ökosystem besser zu verstehen und unsere Review-Prozesse zu verbessern.
- Verständnis. Sie müssen wissen, was Ihr Code tut. Wenn ein Reviewer fragt: „Warum behandelt diese Funktion den Fehler so?“ und Ihre Antwort lautet: „Die KI hat das geschrieben“, reicht das nicht aus. Sie sind der Autor. Die KI ist Ihr Werkzeug. Können Sie den Code nicht erklären, ist er nicht bereit für die Einreichung.
- Tests. KI-generierter Code muss getestet werden. Unit-Tests für die Logik. Manuelles exploratives Testen für die UI. Der KI-Entwicklungsleitfaden beschreibt, wie Sie Browser-DevTools, HAR-Dateien und Konsolenausgaben effektiv zum Debuggen nutzen. PRs ohne ausreichende Testabdeckung werden zurückgegeben.
- Dokumentation. Dokumentieren Sie, was der Code tut, wie er genutzt wird und welche Konfigurationen erforderlich sind. Werden neue APIs, Umgebungsvariablen oder Erweiterungspunkte eingeführt, müssen diese dokumentiert werden.
- Codequalität. KI-generierter Code neigt zu redundanter Logik, ungenutzten Variablen, doppelten Styles und zu komplexen Bedingungen. Führen Sie vor der Einreichung einen Bereinigungsdurchlauf durch. Bitten Sie Ihr KI-Tool um Refactoring, entfernen Sie toten Code und vereinfachen Sie. Unsere CI-Pipeline prüft per Linting – PRs, die den Lint-Check nicht bestehen, werden zurückgegeben.
- Lizenz-Compliance. Stellen Sie sicher, dass Ihr KI-Tool keinen Code aus inkompatiblen Lizenzen übernommen hat. Sie sind für die Herkunft jeder Codezeile in Ihrem PR verantwortlich.
Was wir nicht tun
Wir lehnen Beiträge nicht ab, weil sie mit KI-Unterstützung entstanden sind. Wir verlangen nicht, dass Beitragende „Senior Developer“ sind. Wir machen keine Vorgaben, wie Sie den Code geschrieben haben.
Wir akzeptieren jedoch keine Beiträge, wenn die Beitragenden nicht am Review-Prozess teilnehmen können. Wenn ein Maintainer Änderungen verlangt und Sie diese nicht umsetzen können – sei es, weil Sie den Code nicht verstehen oder weil Sie das Projekt verlassen haben – kann der PR geschlossen werden. Das ist derselbe Standard, der für alle Beiträge gilt.
Hinweise für Maintainer und Reviewer
KI-gestützte Beiträge können mehr Aufwand im Review erfordern. Der Code ist oft syntaktisch korrekt, aber strukturell nicht optimal. Muster können ungewohnt oder nicht projekttypisch sein.
Reviewer sollten:
- Die gleichen Review-Standards wie bei jedem Beitrag anwenden. Keine niedrigere, aber auch keine höhere Messlatte.
- Feedback konkret formulieren. „Das entspricht nicht unseren Mustern“ ist weniger hilfreich als „Wir nutzen in diesem Modul Komposition statt Vererbung – siehe ExampleComponent.vue als Beispiel.“
- Geduld mit Beitragenden haben, die noch lernen. Ein Beitragender, dessen erster PR drei Review-Runden benötigt, kann zum langfristigen Maintainer werden. Genau das ist das Ziel.
- Darauf hinweisen, wenn KI-generierter Code Material aus anderen Projekten oder Frameworks mit inkompatiblen Lizenzen enthält.
KI in unserer eigenen Entwicklung
Auch die internen Engineering-Teams von ownCloud nutzen KI-Tools. Wir halten uns an dieselben Standards: Transparenz in Commit-Nachrichten, wo angebracht, vollständiges Verständnis des generierten Codes und menschliche Verantwortung für jeden Merge.
Wir sind überzeugt, dass verantwortungsvoll eingesetzte KI-gestützte Entwicklung die Hürden für Beiträge senkt, ohne die Qualität zu mindern. Das ist unser Ziel.
Häufig gestellte Fragen
Ja, ownCloud begrüßt Beiträge, die mithilfe von KI-Tools erstellt wurden. Sie sind der Meinung, dass großartige Ideen nicht durch Programmiererfahrung eingeschränkt werden sollten, und ermutigen Beitragende, KI zu nutzen, um ihre Visionen in funktionierenden Code umzusetzen. Es gibt jedoch entsprechende Richtlinien und Anforderungen.
KI-unterstützte Pull Requests müssen mehrere Anforderungen erfüllen: Offenlegung der Nutzung von KI-Tools in der PR-Beschreibung, vollständiges Verständnis des Codes durch den Beitragenden, ausreichende Tests (Unit- und manuelle Tests), angemessene Dokumentation, hohe Codequalität sowie Einhaltung der Lizenzbedingungen, um kopierten Code aus inkompatiblen Quellen zu vermeiden.
Nein, ownCloud lehnt Beiträge nicht allein aufgrund von KI-Unterstützung ab. Für alle Beiträge gelten die gleichen Standards, unabhängig davon, wie der Code entstanden ist.
ownCloud legt für KI-unterstützte Beiträge die gleichen Qualitätsstandards an wie für alle anderen Beiträge. Reviewer wenden einheitliche Kriterien an, geben gezieltes Feedback, zeigen Geduld bei lernenden Beitragenden und weisen auf potenzielle Lizenzprobleme bei kopiertem Material hin.