Reportar un Bug
Esta es la entrada de soporte para chengfeng-videocut, no un flujo de edición secundario. Por defecto, solo se genera un borrador de Issue público; la escritura externa debe pasar por la desensibilización 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 Issue en GitHub
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 disfrace como Bug.
- Duda de uso: Primero responda o diagnostique, no lo reporte automáticamente.
Recolecte solo los hechos mínimos necesarios para la reproducción. No se permite instalar Runtime, iniciar Studio, modificar proyectos, volver a editar videos ni subir medios para "recolectar pruebas". Si el Runtime existe, puede ejecutar node scripts/ensure-runtime.cjs --json desde el directorio raíz de plugins para una detección de solo lectura, conservando solo state / kind / version / healthy / error.code; no incluya la salida completa del doctor. kind=desktop-managed solo indica que la instalación provino de la aplicación de escritorio, no autoriza a esta Skill a iniciar la aplicación, servicios o reinstalación. 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 remoto desde el directorio actual:
| Componente del problema | target | Repositorio de GitHub |
|---|---|---|
| Runtime, Studio, UI, CLI, API, Timeline, Render | product | Agentchengfeng/chengfeng-videocut |
| Skill, Marketplace, Orquestación de instalación, App MCP, Guía de flujo de trabajo | skills | Agentchengfeng/chengfeng-videocut-skills |
Para problemas que abarcan componentes, priorice el repositorio del componente que primero violó el contrato y mencione el otro componente en el cuerpo; si no puede determinar, pregunte primero al usuario.
3. Generar Entrada Estructurada
Escriba el candidato en un directorio temporal de la tarea actual con umask 077, como JSON, sin sobrescribir archivos de especificaciones del producto; elimine el JSON temporal y Markdown al finalizar:
{
"schemaVersion": 1,
"target": "product",
"component": "Studio",
"title": "Runtime 0.1.1 no puede abrir la vista de HyperFrames de nivel superior",
"summary": "Resumen de una línea sobre el impacto",
"steps": ["Primer paso", "Segundo paso"],
"expected": "Comportamiento esperado",
"actual": "Comportamiento real",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["Solo diagnóstico mínimo y público"],
"acceptance": ["Condiciones de reparación verificables"]
}
Prohibido incluir:
- API Key, Token, Cookie,
.env; - Videos, audios, capturas de pantalla, registros completos o transcripciones;
- Nombres de clientes, nombres de videos originales,
projectIdreales, rutas absolutas del usuario; - Contenido de repositorios privados sin permiso del usuario.
4. Generar y Mostrar Borrador Desensibilizado Primero
Localice el script desde este SKILL.md:
Primero, según Verificación de Actualizaciones paso "Verificación de Preparación", localice la raíz del plugin
(desde la ruta real del archivo fuente de esta Skill, suba dos niveles; no ejecute codex plugin list ni busque en otra
cache; todo <raíz-del-plugin> a continuación se sustituye por esa ruta literal). Esta Skill solo usa eso 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-del-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 puede cambiar silenciosamente a otro repositorio. El script limpiará claves comunes, nombres de usuario locales, nombres de volúmenes, fragmentos de rutas y parámetros de consulta localhost; la desensibilización automática no puede reconocer cualquier nombre de cliente, por lo que aún debe revisarse manualmente. Muestre al usuario:
repo
label=bug
title
Cuerpo completo desensibilizado
Al mismo tiempo, guarde confirmationReceipt devuelto y muestre al usuario confirmationToken y tiempo de expiración. Deténgase si el usuario no confirma explícitamente este contenido público; simplemente detectar un error no equivale a consentimiento para reportar. El token solo está vinculado al contenido del borrador y no prueba por sí solo 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 de la tarea actual, expira en 30 minutos, y no puede reutilizarse entre tareas.
5. Enviar Después de Confirmar
Solo envíe el borrador que se acaba de mostrar y cuyo contenido no haya cambiado:
node "<raíz-del-plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<archivo-JSON-del-informe>" --target "<repositorio-destino>" --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 destino y la etiquetabug; si falla, conserva el borrador. - Si ya existe una huella digital con el mismo componente, pasos de reproducción y comportamiento real, devuelve la URL del Issue original, sin fingir una repetición con un título genérico.
- Si el cuerpo cambia después de la confirmación, devuelve
confirmation_mismatch, debe volver a previsualizar. - Si las credenciales de confirmación expiran o se reutilizan, 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 se obtenga la URL del Issue de GitHub, se puede decir "ya se ha reportado".
Manejo de Fallos
github_auth_required: Indique que el borrador está completo pero no se ha enviado; prohibido afirmar éxito.github_issue_create_failed: Conserve el borrador y la entrada manual, no reintente en bucle.confirmation_required/confirmation_mismatch: Vuelva a mostrar el contenido público exacto.- Sin permisos o visibilidad en el repositorio destino: no cambie a otro repositorio arbitrariamente; deje que el usuario decida si cambiar al repositorio público de Skills.