Reportar Bug
Esta es la entrada de soporte para chengfeng-videocut, no es el tercer flujo de edición. Por defecto solo genera un borrador de Issue público; cualquier escritura externa debe pasar por una previsualización desensibilizada y la confirmación del usuario.
Descripción del problema
|
v
Diagnóstico mínimo de solo lectura -> Desensibilización -> Mostrar repositorio / título / cuerpo
|
Confirmación explícita del usuario
|
v
Autenticación + verificación de etiquetas + detección de duplicados
|
v
Crear GitHub Issue
1. Confirmar que es un Bug Reproducible
Primero distinga:
- Bug: El comportamiento real se desvía de un contrato existente, interfaz, capacidad de versión o resultado determinista.
- Sugerencia de funcionalidad: El producto nunca prometió esa capacidad; no lo disfrace como un Bug.
- Duda de uso: Primero responda o diagnostique, no lo reporte automáticamente.
Solo recolecte los hechos mínimos necesarios para la reproducción. No instale Runtime, inicie Studio, modifique proyectos, vuelva a editar videos ni suba archivos multimedia para "complementar evidencia". Si Runtime existe, puede ejecutar node scripts/ensure-runtime.cjs --json desde la raíz del plugin para una detección de solo lectura, conservando únicamente state / kind / version / healthy / error.code; no adjunte la salida completa de doctor. kind=desktop-managed solo indica que la fuente de instalación es la App de escritorio, no autoriza a esta Skill a iniciar la App, servicios o reinstalar. Si no existe, escriba "no detectado".
2. Seleccionar el Repositorio Fijo
El directorio raíz del espacio de trabajo no es necesariamente un repositorio Git; está prohibido adivinar el remote desde el directorio actual:
| Componente del problema | target | Repositorio GitHub |
|---|---|---|
| Runtime, Studio, UI, CLI, API, Línea de tiempo, Renderizado | product | Agentchengfeng/chengfeng-videocut |
| Skill, Marketplace, Orquestación de instalación, MCP App, Documentación del flujo de trabajo | skills | Agentchengfeng/chengfeng-videocut-skills |
Para problemas que abarcan varios componentes, reporte primero en el repositorio que violó el contrato, y mencione el otro componente en el cuerpo; si no puede determinarlo, pregunte al usuario primero.
3. Generar Entrada Estructurada
Con umask 077 escriba el candidato como JSON en el directorio temporal de la tarea actual, no en archivos de especificación del producto; después del envío, elimine el JSON temporal y el Markdown:
{
"schemaVersion": 1,
"target": "product",
"component": "Studio",
"title": "Runtime 0.1.1 no puede abrir la vista de capa de edición de HyperFrames",
"summary": "Descripción del impacto en una línea",
"steps": ["Paso uno", "Paso dos"],
"expected": "Comportamiento esperado",
"actual": "Comportamiento real",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["Solo el diagnóstico mínimo y público"],
"acceptance": ["Condiciones de reparación verificables"]
}
Prohibido incluir:
- API Key, Token, Cookie,
.env; - Video, audio, capturas de pantalla, registros completos o transcripciones;
- Nombre del cliente, nombre del video original,
projectIdreal, rutas absolutas del usuario; - Contenido de repositorios privados sin permiso del usuario.
4. Generar y Mostrar Borrador Desensibilizado
Localice el script desde el SKILL.md actual:
Primero, según Verificar actualizaciones "Verificación de preparación" paso 1, localice la raíz del plugin
(a partir de la ruta real del archivo fuente de esta Skill subiendo dos niveles; no ejecute codex plugin list ni busque en otro
cache; el <raíz del plugin> mencionado a continuación se reemplaza por esa ruta literal). Esta Skill solo lo usa para localizar el script,
no instala Runtime ni inicia servicios:
node "<raíz del plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" draft --input "<archivo JSON de informe>" --output "<archivo de salida del borrador>" --json
target debe ser explícitamente product o skills; si falta o está mal escrito, debe detenerse, no cambiar silenciosamente a otro repositorio. El script limpia claves comunes, nombres de usuario locales, nombres de volúmenes, fragmentos de rutas y parámetros de consulta de localhost; la desensibilización automática no puede reconocer nombres de cliente arbitrarios, aún debe revisarse manualmente. Muestre al usuario:
repo
label=bug
title
Cuerpo completo desensibilizado
Al mismo tiempo, guarde el confirmationReceipt devuelto y muestre al usuario el confirmationToken y el tiempo de expiración. Deténgase si el usuario no confirma explícitamente este contenido público; el simple hecho de detectar un error no equivale a consentimiento para reportar. El token solo está vinculado al contenido del borrador, no prueba por sí mismo el consentimiento del usuario; el agente aún debe esperar una respuesta explícita. La confirmación solo es válida para el siguiente envío inmediato en la tarea actual, expira en 30 minutos y no puede reutilizarse entre tareas.
5. Enviar Después de la Confirmación
Solo envíe el borrador que acaba de mostrar y cuyo contenido no ha cambiado:
node "<raíz del plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<archivo JSON de informe>" --target "<repositorio objetivo>" --confirmed --confirm-token "<token de confirmación>" --receipt "<archivo de recibo de confirmación>" --json
Reglas fijas:
- Antes de enviar, el script verifica
gh auth status, los Issues del repositorio objetivo y la etiquetabug; si falla, conserva el borrador. - Si ya existe un Issue con el mismo componente, pasos de reproducción y resultado real, devuelve la URL del Issue original; no use títulos genéricos para hacerse pasar por duplicado.
- Si el cuerpo cambia después de la confirmación, devuelve
confirmation_mismatch; debe volver a previsualizar. - Si la credencial de confirmación ha expirado o ya se usó, devuelve
confirmation_expired / confirmation_replayed; debe volver a previsualizar. - Si el resultado de la creación no tiene una URL de Issue clara, no reintente automáticamente; puede que ya se haya creado.
- Solo cuando obtenga la URL del GitHub Issue, puede decir "ya se ha reportado".
Manejo de Errores
github_auth_required: Indica que el borrador está completo pero no se envió; está prohibido afirmar que tuvo éxito.github_issue_create_failed: Conserva el borrador y la entrada manual; no reintente en bucle.confirmation_required/confirmation_mismatch: Vuelva a mostrar el contenido público exacto.- No tiene permisos para el repositorio objetivo o no es visible: No cambie a otro repositorio arbitrario; deje que el usuario decida si reportarlo al repositorio público de Skills.