Communitygithub.com

Relatar Bug de Vídeo

Organiza, anonimiza e reporta bugs do GitHub para o chengfeng-videocut. Use quando o usuário disser para reportar um bug, fornecer feedback sobre problemas de edição de vídeo, enviar uma Issue do GitHub, informar o desenvolvedor sobre um problema ou solicitar a continuação do envio de um rascunho de bug já visualizado. Não use para sugestões de funcionalidades, depuração comum, envio de código ou relatórios automáticos sem confirmação do usuário.

O que é Relatar Bug de Vídeo?

Esta habilidade é um pipeline estruturado para reportar bugs do produto chengfeng-videocut no GitHub, garantindo que apenas informações verificadas e anonimizadas sejam enviadas. Ela orienta o agente a primeiro confirmar se o problema é um bug replicável (em oposição a um pedido de funcionalidade ou dúvida), coletando apenas os fatos mínimos necessários, sem executar o runtime ou modificar o projeto. O repositório de destino é determinado com base no componente afetado (product ou skills), e um rascunho é gerado em formato JSON, passando por um script de anonimização que remove chaves de API, dados de usuário e informações sensíveis. O rascunho é exibido ao usuário para confirmação explícita antes de ser submetido, e o script de submissão verifica autenticação, tags e duplicatas. Ela é compatível com Cursor e Claude Code (via SKILL.md). A habilidade opera em um fluxo determinístico: diagnóstico mínimo, anonimização, preview, confirmação do usuário e submissão controlada, com tratamento de erros para falhas de autenticação ou inconsistências de confirmação.

Funciona com✓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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Relatar Bug

Esta é a entrada de suporte para chengfeng-videocut, não é um terceiro fluxo de edição. Por padrão, gera apenas rascunhos de Issue públicos; a escrita externa deve passar por anonimização e confirmação do usuário.

Descrição do Problema
   |
   v
Diagnóstico mínimo somente leitura -> Anonimização -> Exibir repositório / título / corpo
                                  |
                            Confirmação explícita do usuário
                                  |
                                  v
                     Autenticação + Verificação de rótulo + Dedup
                                  |
                                  v
                          Criar Issue no GitHub

1. Confirme que é um Bug Reproduzível

Primeiro, distinga:

  • Bug: Comportamento real diverge do contrato, interface, capacidade de versão ou resultado determinístico existente.
  • Sugestão de funcionalidade: O produto nunca prometeu essa capacidade; não disfarce como Bug.
  • Dúvida de uso: Primeiro responda ou diagnostique, não reporte automaticamente.

Colete apenas os fatos mínimos necessários para reprodução. Não instale Runtime, inicie o Studio, modifique o projeto, recorte novamente ou faça upload de mídia para "complementar evidências". Quando o Runtime existir, execute node scripts/ensure-runtime.cjs --json a partir da raiz do diretório de plugins para uma sondagem somente leitura, mantendo apenas state/kind/version/healthy/error.code; não anexe a saída completa do doctor. kind=desktop-managed indica apenas que a fonte de instalação é o aplicativo desktop, não autoriza esta Habilidade a iniciar o aplicativo, serviço ou reinstalar. Se não existir, escreva "não detectado".

2. Selecione o Repositório Fixo

O diretório raiz do workspace não é necessariamente um repositório Git; é proibido adivinhar o remote a partir do diretório atual:

Componente do ProblematargetRepositório GitHub
Runtime, Studio, UI, CLI, API, Timeline, RenderizaçãoproductAgentchengfeng/chengfeng-videocut
Habilidade, Marketplace, Instalação, MCP App, Fluxo de TrabalhoskillsAgentchengfeng/chengfeng-videocut-skills

Para problemas entre componentes, reporte primeiro ao repositório que quebrou o contrato mais cedo e mencione o outro componente no corpo; se não for possível determinar, pergunte ao usuário primeiro.

3. Gere Entrada Estruturada

Com umask 077, escreva o candidato em JSON no diretório temporário da tarefa atual, não em arquivos de especificação do produto; remova o JSON e o Markdown temporários após a conclusão:

{
  "schemaVersion": 1,
  "target": "product",
  "component": "Studio",
  "title": "Runtime 0.1.1 não consegue abrir a visualização de edição de vídeo HyperFrames",
  "summary": "Descrição resumida do impacto",
  "steps": ["Primeiro passo", "Segundo passo"],
  "expected": "Comportamento esperado",
  "actual": "Comportamento real",
  "environment": {
    "Runtime": "0.1.1",
    "OS": "macOS"
  },
  "evidence": ["Apenas diagnóstico mínimo e público"],
  "acceptance": ["Condições de correção verificáveis"]
}

É proibido incluir:

  • API Key, Token, Cookie, .env;
  • Vídeo, áudio, capturas de tela, logs completos ou transcrições;
  • Nome do cliente, nome original do vídeo, projectId real, caminhos absolutos do usuário;
  • Conteúdo de repositório privado sem permissão do usuário.

4. Gere e Exiba o Rascunho Anonimizado Primeiro

Localize o script a partir do SKILL.md atual:

Primeiro, siga o passo "Verificação de Prontidão" do Verificar atualizações para localizar a raiz do plugin (do caminho do arquivo fonte desta Habilidade, suba dois níveis; não execute codex plugin list ou pesquise outro cache; todos os <raiz-plugin> abaixo referem-se a esse caminho literal). Esta Habilidade usa apenas para localizar o script, não instala Runtime ou inicia serviços:

node "<raiz-plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" draft --input "<arquivo JSON do relato>" --output "<arquivo de saída do rascunho>" --json

target deve ser explicitamente product ou skills; valores ausentes ou com erro de digitação devem parar, não é permitido reportar silenciosamente para outro repositório. O script limpará chaves comuns, nomes de usuário locais, nomes de volume, segmentos de caminho e parâmetros de consulta localhost; a anonimização automática não consegue identificar nomes de clientes arbitrários, portanto, ainda deve ser revisada manualmente. Exiba ao usuário:

repo
label=bug
title
Corpo completo anonimizado

Ao mesmo tempo, salve o confirmationReceipt retornado e exiba ao usuário o confirmationToken e o tempo de expiração. Pare se o usuário não confirmar explicitamente este conteúdo público; apenas detectar um erro não equivale a consentimento para reportar. O token está vinculado apenas ao conteúdo do rascunho e não prova por si só o consentimento do usuário; o Agente ainda deve aguardar uma resposta explícita. A confirmação é válida apenas para o envio imediatamente seguinte na tarefa atual, expira em 30 minutos e não pode ser usada entre tarefas ou reutilizada.

5. Submeta Após Confirmação

Submeta apenas o rascunho que foi exibido e cujo conteúdo não mudou:

node "<raiz-plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<arquivo JSON do relato>" --target "<repositório alvo>" --confirmed --confirm-token "<token de confirmação>" --receipt "<arquivo de recibo de confirmação>" --json

Regras fixas:

  • Antes de submeter, o script verifica gh auth status, Issues do repositório alvo e o rótulo bug; em caso de falha, mantém o rascunho.
  • Se uma impressão digital para o mesmo componente, passos de reprodução e comportamento real já existir, retorna a URL da Issue original, sem usar um título genérico para fingir duplicação.
  • Se o corpo mudar após a confirmação, retorna confirmation_mismatch, e uma nova pré-visualização é necessária.
  • Se a credencial de confirmação expirou ou já foi usada, retorna confirmation_expired/confirmation_replayed, e uma nova pré-visualização é necessária.
  • Se o resultado da criação não tiver uma URL de Issue explícita, não tente novamente automaticamente; ela pode já ter sido criada.
  • Só é possível dizer "já reportei" se a URL da Issue do GitHub for obtida.

Tratamento de Falhas

  • github_auth_required: Indica que o rascunho foi concluído, mas não submetido; é proibido afirmar sucesso.
  • github_issue_create_failed: Mantém o rascunho e a entrada manual, não tente novamente em loop.
  • confirmation_required/confirmation_mismatch: Reexibe o conteúdo público preciso.
  • Repositório alvo sem permissão ou invisível: Não reporte para um repositório arbitrário; deixe o usuário decidir se reporta para o repositório 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) 架构、工程自修复、智能配音字幕及录屏变焦。

Habilidades Relacionadas