Bug melden
Dies ist der Support-Einstieg für chengfeng-videocut, nicht der dritte Workflow. Standardmäßig wird nur ein öffentlicher Issue-Entwurf erstellt. Externes Schreiben erfordert vorher eine Anonymisierung und Freigabe durch den Nutzer.
Problembeschreibung
|
v
Minimale Read-only-Diagnose -> Anonymisierung -> Anzeige von Repository / Titel / Beschreibung
|
Klare Nutzerbestätigung
|
v
Authentifizierung + Label-Prüfung + Dublettencheck
|
v
GitHub-Issue erstellen
1. Sicherstellen, dass es sich um einen reproduzierbaren Bug handelt
Zunächst unterscheiden:
- Bug – Tatsächliches Verhalten weicht von bestehenden Zusagen, Schnittstellen, Versionen oder deterministischen Ergebnissen ab.
- Feature-Wunsch – Das Produkt hat diese Fähigkeit nie versprochen. Nicht als Bug tarnen.
- Anwendungsfrage – Zuerst beantworten oder diagnostizieren, nicht automatisch melden.
Es werden nur die minimalen, zur Reproduktion nötigen Fakten gesammelt. Keine Runtime installieren, kein Studio starten, keine Projekte ändern, keine Clips neu schneiden oder Medien hochladen, um „Beweise“ zu sammeln. Falls die Runtime vorhanden ist, kann im Plugin-Stammverzeichnis der Befehl node scripts/ensure-runtime.cjs --json als reiner Lesevorgang ausgeführt werden. Davon nur state / kind / version / healthy / error.code behalten; keine vollständige Doctor-Ausgabe anhängen. kind=desktop-managed bedeutet nur, dass die Installation über die Desktop-App erfolgte, und berechtigt diese Skill nicht, die App, Dienste oder die Runtime neu zu installieren. Fehlt die Runtime, wird „Nicht erkannt“ eingetragen.
2. Festes Repository auswählen
Das Arbeitsverzeichnis ist nicht zwingend ein Git-Repository. Es ist verboten, das Remote aus dem aktuellen Verzeichnis zu erraten:
| Betroffene Komponente | Ziel | GitHub-Repository |
|---|---|---|
| Runtime, Studio, UI, CLI, API, Timeline, Rendering | product | Agentchengfeng/chengfeng-videocut |
| Skill, Marketplace, Installationsorchestrierung, MCP-App, Workflow-Dokumentation | skills | Agentchengfeng/chengfeng-videocut-skills |
Bei komponentenübergreifenden Problemen wird vorrangig das Repository gemeldet, das den Vertrag zuerst verletzt, und die andere Komponente im Beschreibungstext erwähnt. Kann dies nicht entschieden werden, wird der Nutzer zuerst gefragt.
3. Strukturierte Eingabe generieren
Mit umask 077 den Kandidaten als JSON in das temporäre Verzeichnis des aktuellen Tasks schreiben, nicht in Produkt-Spezifikationsdateien. JSON und Markdown nach Abschluss des Vorgangs löschen:
{
"schemaVersion": 1,
"target": "product",
"component": "Studio",
"title": "Runtime 0.1.1 kann HyperFrames-Ansicht der oberen Schnittansicht nicht öffnen",
"summary": "Ein Satz zur Auswirkung",
"steps": ["Erster Schritt", "Zweiter Schritt"],
"expected": "Erwartetes Verhalten",
"actual": "Tatsächliches Verhalten",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["Nur minimale, öffentliche Diagnose"]
}
Nicht erlaubt:
- API-Key, Token, Cookie,
.env; - Video, Audio, Screenshots, vollständige Logs oder Transkripte;
- Kundenname, Originalname des Videos, echte
projectIdoder absolute Nutzerpfade; - private Repository-Inhalte ohne Zustimmung des Nutzers.
4. Zunächst Entwurf anzeigen und anonymisieren
Vom aktuellen SKILL.md aus das Skript lokalisieren:
Zunächst gemäß Auf Updates prüfen „Bereitschaftsprüfung“ Schritt 1 die Plugin-Wurzel ermitteln
(vom tatsächlichen Quellpfad dieser Skill zwei Ebenen nach oben; codex plugin list oder andere
Cache-Durchsuchungen sind nicht erlaubt; <Plugin-Wurzel> wird überall durch den ermittelten absoluten Pfad ersetzt). Diese Skill verwendet die Plugin-Wurzel nur, um das Skript zu finden, nicht um die Runtime zu installieren oder Dienste zu starten:
node "<Plugin-Wurzel>/skills/chengfeng-report-bug/scripts/report-bug.cjs" draft --input "<JSON-Bericht>" --output "<Entwurfsausgabedatei>" --json
target muss explizit product oder skills sein. Fehlt der Wert oder ist er falsch geschrieben, wird der Vorgang abgebrochen; es darf nicht stillschweigend ein anderes Repository gemeldet werden. Das Skript entfernt gängige Secrets, lokale Benutzernamen, Volume-Namen, Pfadreste und lokale Host-Anfrageparameter. Die automatische Anonymisierung erkennt nicht jede beliebige Kundenbezeichnung; eine manuelle Durchsicht ist dennoch erforderlich. Dem Nutzer anzeigen:
repo
label=bug
title
vollständiger anonymisierter Text
Gleichzeitig die zurückgegebene confirmationReceipt speichern und dem Nutzer den confirmationToken sowie die Ablaufzeit anzeigen. Der Vorgang wird angehalten, bis der Nutzer den öffentlichen Inhalt ausdrücklich bestätigt hat. Allein die Erkennung eines Fehlers ist keine Zustimmung zur Meldung. Der Token ist nur an den Inhalt des Entwurfs gebunden und beweist nicht von selbst die Nutzerzustimmung. Der Agent muss weiterhin auf eine explizite Antwort warten. Die Bestätigung gilt nur für den unmittelbar folgenden Einreichungsvorgang im selben Task und verfällt nach 30 Minuten. Sie darf nicht über Tasks hinweg oder mehrfach verwendet werden.
5. Nach Bestätigung einreichen
Nur den soeben angezeigten, unveränderten Entwurf einreichen:
node "<Plugin-Wurzel>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<JSON-Bericht>" --target "<Ziel-Repository>" --confirmed --confirm-token "<Bestätigungs-Token>" --receipt "<Bestätigungsbeleg-Datei>" --json
Feste Regeln:
- Vor der Einreichung prüft das Skript
gh auth status, die Issues des Ziel-Repositorys und dasbug-Label. Bei Fehlschlag wird der Entwurf beibehalten. - Wenn ein Issue mit identischer Komponente, Reproduktionsschritten und tatsächlichem Verhalten bereits existiert, wird die URL des bestehenden Issues zurückgegeben. Keine weit gefassten Titel verwenden, um ein Duplikat vorzutäuschen.
- Wenn sich der Text nach der Bestätigung ändert, wird
confirmation_mismatchzurückgegeben; der Entwurf muss erneut geprüft werden. - Wenn der Bestätigungsbeleg abgelaufen oder bereits verwendet wurde, wird
confirmation_expired / confirmation_replayedzurückgegeben; der Entwurf muss erneut geprüft werden. - Wenn das Erstellungsresultat keine eindeutige Issue-URL enthält, wird kein automatischer Wiederholungsversuch unternommen; das Issue könnte bereits angelegt sein.
- Erst wenn eine GitHub-Issue-URL vorliegt, darf der Vorgang als „gemeldet“ bezeichnet werden.
Fehlerbehandlung
github_auth_required: Hinweis, dass der Entwurf fertig, aber nicht eingereicht ist. Keine Erfolgsmeldung erlaubt.github_issue_create_failed: Entwurf und manuelle Eingabemöglichkeit beibehalten; keine Wiederholungsschleife.confirmation_required/confirmation_mismatch: Exakten öffentlichen Inhalt erneut anzeigen.- Keine Berechtigung oder Sichtbarkeit für das Ziel-Repository: Nicht stillschweigend ein anderes Repository melden. Der Nutzer entscheidet, ob auf das öffentliche Skills-Repository umgeleitet werden soll.