Communitygithub.com

上报 Bug(chengfeng-videocut)

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

¿Qué es 上报 Bug(chengfeng-videocut)?

Esta habilidad está diseñada para que un agente de IA (como Claude Code, Codex o Cursor) pueda recopilar, desensibilizar y enviar reportes de bugs del proyecto `chengfeng-videocut` a GitHub como Issues públicos. Proporciona un flujo estructurado que incluye la confirmación de que se trata de un bug reproducible, la selección del repositorio correcto (`Agentchengfeng/chengfeng-videocut` para el producto o `Agentchengfeng/chengfeng-videocut-skills` para skills/instalación), la generación de un borrador JSON estandarizado con metadatos mínimos (pasos, entorno, evidencia), la desensibilización automática de datos sensibles (API keys, paths de usuario, contenido de medios), y la creación del Issue en GitHub solo después de que el usuario confirme explícitamente el contenido del borrador. La habilidad se apoya en scripts locales (`report-bug.cjs`) que realizan la desensibilización y en la CLI de GitHub (`gh`) para la autenticación y creación de Issues. Es útil para desarrolladores que mantienen o contribuyen a `chengfeng-videocut`, ya que automatiza el proceso de reporte de bugs de manera segura y consistente, evitando la fuga de información sensible y asegurando que solo se envíen reportes verificados por el usuario.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-report-bug

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 problematargetRepositorio de GitHub
Runtime, Studio, UI, CLI, API, Timeline, RenderproductAgentchengfeng/chengfeng-videocut
Skill, Marketplace, Orquestación de instalación, App MCP, Guía de flujo de trabajoskillsAgentchengfeng/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, projectId reales, 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 etiqueta bug; 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.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

Skills relacionados