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 un aperçu anonymisé et une confirmation de l'utilisateur.
Description du problème
|
v
Diagnostic minimal en lecture seule -> Anonymisation -> Affichage du dépôt / titre / corps
|
Confirmation explicite de l'utilisateur
|
v
Authentification + Vérification des étiquettes + Dédoublonnage
|
v
Création de l'Issue GitHub
1. Confirmer qu'il s'agit d'un bug reproductible
Distinguer d'abord :
- Bug : le comportement réel s'écarte d'un contrat, d'une interface, d'une capacité de version ou d'un résultat déterministe existant.
- Suggestion de fonctionnalité : le produit n'a jamais promis cette capacité ; ne pas faire passer pour un bug.
- Question d'utilisation : répondre ou diagnostiquer d'abord, ne pas remonter automatiquement.
Ne collecter que les faits minimaux nécessaires à la reproduction. Ne pas installer de Runtime, lancer Studio, modifier le projet, remonter la vidéo ou télécharger des médias pour « compléter les preuves ». Si le Runtime est présent, exécuter depuis la racine du plugin node scripts/ensure-runtime.cjs --json pour une détection en lecture seule, ne conserver que state / kind / version / healthy / error.code ; ne pas joindre la sortie complète du doctor. kind=desktop-managed indique seulement que la source d'installation est l'application de bureau, n'autorise pas cette compétence à lancer l'App, le service ou à réinstaller. Si absent, écrire « non détecté ».
2. Choisir le dépôt fixe
La racine de l'espace de travail n'est pas forcément un dépôt Git ; il est interdit de deviner le remote depuis le répertoire courant :
| Composant du problème | cible | Dépôt GitHub |
|---|---|---|
| Runtime, Studio, UI, CLI, API, Timeline, Rendu | product | Agentchengfeng/chengfeng-videocut |
| Skill, Marketplace, Orchestration d'installation, MCP App, Instructions de workflow | skills | Agentchengfeng/chengfeng-videocut-skills |
Pour les problèmes transverses, prioriser le dépôt qui viole en premier le contrat, et mentionner l'autre composant dans le corps ; en cas de doute, demander à l'utilisateur.
3. Générer une entrée structurée
Avec umask 077, écrire le candidat dans un fichier JSON du répertoire temporaire de la tâche en cours, sans toucher au fichier de spécification du produit ; supprimer le JSON et le Markdown temporaires après soumission :
{
"schemaVersion": 1,
"target": "product",
"component": "Studio",
"title": "Runtime 0.1.1 ne peut pas ouvrir la vue HyperFrames du top-level cut broadcast",
"summary": "Description 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 des diagnostics minimaux et publics"],
"acceptance": ["Conditions de correction vérifiables"]
}
Ne pas inclure :
- API Key, Token, Cookie,
.env; - Vidéos, fichiers audio, captures d'écran, logs complets ou retranscriptions inté grales ;
- Noms de clients, noms de vidéos originales,
projectIdréel, chemins absolus de l'utilisateur ; - Contenu de dépôts privés sans autorisation de l'utilisateur.
4. Générer puis afficher le brouillon anonymisé
Depuis ce SKILL.md, localiser le script :
Suivre d'abord Vérification des mises à jour « Prêt pour la vérification » première étape pour localiser la racine du plugin
(à partir du chemin réel du fichier source de cette compétence, remonter de deux niveaux ; ne pas exécuter codex plugin list ni chercher dans d'autres
cache ; <racine_du_plugin> ci-dessous correspond à ce chemin littéral). Cette compétence ne l'utilise que pour localiser le script,
sans installer de Runtime ni lancer de service :
node "<racine_du_plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" draft --input "<fichier_JSON_du_rapport>" --output "<fichier_de_sortie_du_brouillon>" --json
target doit être explicitement product ou skills ; en cas d'absence ou de faute, s'arrêter, ne pas silencieusement rediriger vers un autre dépôt. Le script nettoie les clés communes, noms d'utilisateur locaux, noms de volumes, fragments de chemins et paramètres de requête localhost ; l'anonymisation automatique ne peut pas reconnaître n'importe quel nom de client, une relecture manuelle reste obligatoire. Afficher à l'utilisateur :
repo
label=bug
title
Corps complet anonymisé
Conserver le confirmationReceipt retourné, et présenter à l'utilisateur le confirmationToken ainsi que sa date d'expiration. S'arrêter tant que l'utilisateur n'a pas explicitement confirmé ce contenu public ; la simple détection d'une erreur ne vaut pas consentement à la remontée. Le jeton n'est lié qu'au contenu du brouillon, 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 au bout de 30 minutes, et ne peut pas être réutilisée entre tâches ou de manière répétée.
5. Soumettre après confirmation
Soumettre uniquement le brouillon qui vient d'être affiché et dont le contenu n'a pas changé :
node "<racine_du_plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<fichier_JSON_du_rapport>" --target "<dépôt_cible>" --confirmed --confirm-token "<token_de_confirmation>" --receipt "<fichier_de_confirm>" --json
Règles fixes :
- Avant soumission, le script vérifie
gh auth status, les Issues du dépôt cible et l'étiquettebug; en cas d'échec, conserver le brouillon. - Si une Issue existe déjà avec les mêmes empreintes de composant, étapes de reproduction et résultat réel, retourner l'URL de l'Issue originale, ne pas faire passer un titre vague pour un doublon.
- Si le corps change après confirmation, retourner
confirmation_mismatch; une nouvelle prévisualisation est nécessaire. - Si le jeton de confirmation est expiré ou déjà utilisé, retourner
confirmation_expired / confirmation_replayed; une nouvelle prévisualisation est nécessaire. - Si le résultat de création n'a pas d'URL d'Issue explicite, ne pas réessayer automatiquement ; l'Issue a peut-être déjà été créée.
- Ce n'est qu'avec une URL GitHub Issue que l'on peut dire « a été remonté ».
Gestion des échecs
github_auth_required: indiquer que le brouillon est prêt mais non soumis, ne pas prétendre au succès.github_issue_create_failed: conserver le brouillon et le point d'entrée manuel, ne pas boucler de réessais.confirmation_required/confirmation_mismatch: réafficher exactement le contenu public.- Dépôt cible sans permission ou invisible : ne pas rediriger vers un autre dépôt ; laisser l'utilisateur décider de rediriger vers un dépôt Skills public.