Signaler un Bug
Ceci est le point d'entrée de support pour chengfeng-videocut, pas une troisième étape de montage. Par défaut, seul un brouillon public d'Issue est généré ; toute écriture externe doit passer par une désensibilisation et une confirmation de l'utilisateur.
Description du problème
|
v
Diagnostic minimal en lecture seule -> Désensibilisation -> Affichage du dépôt / titre / corps
|
Confirmation explicite de l'utilisateur
|
v
Authentification + Vérification des labels + Détection de doublons
|
v
Création d'un GitHub Issue
1. Confirmer qu'il s'agit d'un Bug Reproductible
Commencez par distinguer :
- Bug : le comportement réel s'écarte d'un engagement existant, d'une interface, d'une capacité de version ou d'un résultat déterminé.
- Suggestion de fonctionnalité : le produit n'a jamais promis cette capacité ; ne la déguisez pas en Bug.
- Question d'utilisation : répondez ou diagnostiquez d'abord, ne signalez pas automatiquement.
Ne collectez que les faits minimaux nécessaires à la reproduction. N'installez pas de Runtime, ne démarrez pas Studio, ne modifiez pas le projet, ne remontez pas de séquence et ne téléchargez pas de média pour « apporter des preuves ». Si le Runtime existe, vous pouvez exécuter node scripts/ensure-runtime.cjs --json depuis la racine du répertoire des plugins pour une sonde en lecture seule, en ne conservant que state / kind / version / healthy / error.code ; n'incluez pas la sortie complète du diagnostic doctor. kind=desktop-managed indique uniquement que la source d'installation est l'application de bureau, et n'autorise pas cette compétence à démarrer l'application, le service ou à réinstaller. Si le Runtime n'est pas présent, écrivez « non détecté ».
2. Sélectionner le Dépôt Fixe
Le répertoire racine de l'espace de travail n'est pas forcément un dépôt Git ; il est interdit de deviner le remote à partir du répertoire courant :
| Composant du problème | cible | Dépôt GitHub |
|---|---|---|
| Runtime, Studio, UI, CLI, API, Timeline, Rendu | product | Agentchengfeng/chengfeng-videocut |
| Compétence, Marketplace, Installation, App MCP, Instructions de workflow | skills | Agentchengfeng/chengfeng-videocut-skills |
Pour les problèmes transversaux, donnez la priorité au dépôt dont le contrat a été violé en premier, et mentionnez l'autre composant dans le corps de l'Issue ; si vous ne pouvez pas décider, demandez d'abord à l'utilisateur.
3. Générer une Entrée Structurée
Avec umask 077, écrivez le candidat dans un fichier JSON du répertoire temporaire de la tâche en cours, sans modifier les fichiers de spécification du produit ; supprimez le JSON temporaire et le Markdown une fois la soumission terminée :
{
"schemaVersion": 1,
"target": "product",
"component": "Studio",
"title": "Runtime 0.1.1 ne peut pas ouvrir la vue de montage voix-off HyperFrames",
"summary": "Résumé de l'impact en une phrase",
"steps": ["Première étape", "Deuxième étape"],
"expected": "Comportement attendu",
"actual": "Comportement réel",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["Ne mettre que le diagnostic minimum et public"],
"acceptance": ["Conditions de correction vérifiables"]
}
Il est interdit d'inclure :
- Clé API, Token, Cookie,
.env; - Vidéo, audio, capture d'écran, journal complet ou transcription ;
- Nom du client, nom vidéo original,
projectIdréel, chemin absolu de l'utilisateur ; - Contenu de dépôt privé sans l'autorisation de l'utilisateur.
4. Générer et Afficher d'Abord un Brouillon Désensibilisé
Localisez le script à partir du présent SKILL.md :
Suivez d'abord l'étape de « Vérification de l'état de préparation » de la Vérification des mises à jour pour localiser la racine du plugin
(à partir du chemin réel du fichier source de cette compétence, remontez de deux niveaux ; n'exécutez pas codex plugin list et ne cherchez pas
dans un autre cache ; toutes les occurrences de <racine_plugin> ci-dessous se réfèrent à ce chemin littéral). Cette compétence n'utilise ce chemin que pour localiser le script,
n'installe pas le Runtime et ne démarre pas de service :
node "<racine_plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" draft --input "<fichier_JSON_rapport>" --output "<fichier_sortie_brouillon>" --json
La valeur de target doit être explicitement product ou skills ; en cas d'absence ou de faute de frappe, le processus doit s'arrêter, et ne pas signaler silencieusement un autre dépôt. Le script nettoie les clés courantes, les noms d'utilisateur locaux, les noms de volume, les fragments de chemin et les paramètres de requête localhost ; la désensibilisation automatique ne peut pas reconnaître tous les noms de clients, une relecture humaine reste nécessaire. Présentez à l'utilisateur :
dépôt
label=bug
titre
Corps désensibilisé complet
Enregistrez le confirmationReceipt retourné et affichez à l'utilisateur le confirmationToken ainsi que la date d'expiration. Arrêtez-vous si l'utilisateur n'a pas explicitement confirmé ce contenu public ; le simple fait de détecter une erreur ne vaut pas accord pour un signalement. Le jeton est lié uniquement au contenu du brouillon et ne prouve pas en soi le consentement de l'utilisateur ; l'agent doit toujours attendre une réponse explicite. La confirmation n'est valable que pour la soumission immédiatement suivante dans la tâche en cours, expire après 30 minutes, et ne peut pas être réutilisée entre différentes tâches.
5. Soumettre après Confirmation
Ne soumettez que le brouillon qui vient d'être affiché et dont le contenu n'a pas changé :
node "<racine_plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<fichier_JSON_rapport>" --target "<dépôt_cible>" --confirmed --confirm-token "<jeton_confirmation>" --receipt "<fichier_accusé_réception>" --json
Règles fixes :
- Avant la soumission, le script vérifie
gh auth status, les Issues du dépôt cible et le labelbug; en cas d'échec, le brouillon est conservé. - Si une empreinte numérique identique (même composant, mêmes étapes de reproduction et même comportement réel) existe déjà, l'URL de l'Issue original est retournée ; un titre vague ne doit pas être utilisé pour simuler un doublon.
- Si le corps de l'Issue a changé après la confirmation, le script retourne
confirmation_mismatch, et une nouvelle prévisualisation est nécessaire. - Si les informations d'identification de confirmation ont expiré ou ont déjà été utilisées, le script retourne
confirmation_expired / confirmation_replayed, et une nouvelle prévisualisation est nécessaire. - Si le résultat de la création ne contient pas d'URL explicite de l'Issue, ne réessayez pas automatiquement ; l'Issue a peut-être déjà été créée.
- Vous ne pouvez dire « signalé » que lorsque vous avez obtenu l'URL de l'Issue GitHub.
Gestion des Échecs
github_auth_required: indiquez que le brouillon est terminé mais n'a pas été soumis, et interdisez d'affirmer un succès.github_issue_create_failed: conservez le brouillon et l'accès manuel, ne réessayez pas en boucle.confirmation_required/confirmation_mismatch: réaffichez le contenu public exact.- Pas d'autorisation ou dépôt cible invisible : ne signalez pas vers un autre dépôt arbitraire ; laissez l'utilisateur décider s'il souhaite signaler vers un dépôt public de compétences.