Kurzantwort
OpenCode-Regeln: Kurzantwort
OpenCode-Regeln sind dauerhafte Anweisungen für eine Sitzung. Projektregeln gehören zu den Repository-Konventionen, globale Regeln zu stabilen persönlichen Gewohnheiten und URL-Anweisungen nur zu geprüften, vertrauenswürdigen Quellen.
Das Similarweb-Cluster `opencode rules` zeigt eine Konfigurationsabsicht rund um Regeldateien sowie globale und projektbezogene Regeln. Die offizielle Dokumentation trennt Rules, Skills, Agents, Permissions und Config; diese Anleitung erklärt die Grenzen.
Definieren Sie zuerst den Geltungsbereich und testen Sie lesend. Eine kurze überprüfbare Regel ist sicherer als ein langer Block mit Verfahren, Rechten und Deployment.
Verwandte Anleitungen: OpenCode-Skills-Leitfaden, OpenCode-Agents-Leitfaden, OpenCode-Permissions-Leitfaden, OpenCode-Konfiguration.
1. Den kleinsten passenden Geltungsbereich wählen
Projektregeln enthalten Testbefehle, generierte Ordner, Zuständigkeiten und Sicherheitsgrenzen des Repositories. Globale Regeln sind persönliche Gewohnheiten. Eine URL bringt Netzwerk- und Herkunftsrisiken; prüfen Sie die Domain und behalten Sie für kritische Schutzregeln eine lokale Kopie.
| Geltungsbereich | Einsatz | Risiko |
|---|---|---|
| Projekt | Repository-Konventionen | Veraltete Regel |
| Global | Persönliche Gewohnheit | Überraschung in anderen Projekten |
| URL | Vertrauenswürdiger Kontext | Änderung ohne Review |
2. Regel-Erkennung durch OpenCode prüfen
Die offizielle Rules-Seite behandelt Initialisierung, Typen, Priorität, eigene Anweisungen und externe Dateien. Nutzen Sie die Initialisierung Ihrer installierten Version und raten Sie den Pfad nicht aus einem anderen Framework.
3. Priorität als überprüfbare Entscheidung behandeln
Globale und Projektregeln können sich widersprechen. Erstellen Sie einen kleinen Konflikttest und beobachten Sie die dokumentierte Reihenfolge. Die Projektgrenze bleibt maßgeblich; doppelte Formulierungen gehören entfernt.
4. Eigene Anweisungen als kurzen Vertrag schreiben
Eine gute Regel nennt Geltungsbereich, Pflicht, Verbot, Nachweis und Rollback. Repository-Fakten gehören in die Projektregel, persönliche Stilwünsche eher in eine globale Regel oder Skill.
5. Vertrauen vor externen Dateien prüfen
Externe Dateien können gemeinsame Hinweise liefern, sich aber ohne Review ändern. Prüfen Sie Transport, Eigentümer und Historie; lassen Sie Geheimnisse und Deployment lokal.
6. Rules von Skills, Agents, Permissions und Config trennen
Rules beschreibt dauerhafte Grenzen, Skills Verfahren, Agents Rollen und Werkzeuge, Permissions allow/ask/deny und Config Produkteinstellungen. Verstecken Sie keinen automatischen Release in einer Regel.
7. Wirksame Regeln vor echten Änderungen testen
Testen Sie in einem Wegwerf-Branch: Erklärung, Leseaufgabe, kleiner Diff und Rollback. Wiederholen Sie die Aufgabe nach dem Entfernen der Regel.
FAQ zu OpenCode-Regeln
Was sind OpenCode-Regeln?
Dauerhafte Anweisungen für einen Projekt-, globalen oder vertrauenswürdigen externen Geltungsbereich.
Wo liegen Projektregeln?
Bestätigen Sie den Pfad in der Rules-Dokumentation Ihrer Version und halten Sie die Datei im Repository.
Sind Rules und Skills gleich?
Nein. Rules definiert dauerhafte Grenzen, Skills beschreibt wiederverwendbare Abläufe.
Kann eine globale Regel die Projektregel überschreiben?
Das hängt von Typ und dokumentierter Priorität ab. Testen Sie einen kleinen Konflikt.
Sind URL-Regeln sicher?
Nur bei vertrauenswürdiger, geprüfter Quelle; kritische Regeln bleiben lokal.
Offizielle Quellen
Die Dokumentation zu Rules, Config, Permissions, Skills und Agents wurde am 31. Oktober 2026 geprüft. Bestätigen Sie die Syntax auf der offiziellen Seite Ihrer Version.