Reportar Bug
Esta é a entrada de suporte para chengfeng-videocut, não é um terceiro fluxo de edição. Por padrão, apenas gera rascunhos de Issues públicos; a escrita externa deve passar por visualização anonimizada e confirmação do usuário.
Descrição do Problema
|
v
Diagnóstico mínimo somente leitura -> Anonimização -> Exibe repositório / título / corpo
|
Confirmação explícita do usuário
|
v
Autenticação + Verificação de rótulos + Verificação de duplicidade
|
v
Cria Issue no GitHub
1. Confirme que é um Bug Reproduzível
Primeiro, diferencie:
- Bug: O comportamento real desvia de um contrato, interface, capacidade de versão ou resultado determinístico existente.
- Sugestão de funcionalidade: O produto nunca prometeu essa capacidade; não disfarçar como Bug.
- Dúvida de uso: Primeiro responda ou diagnostique, não reporte automaticamente.
Colete apenas os fatos mínimos necessários para a reprodução. Não instale Runtime, inicie Studio, modifique o projeto, reedite vídeos ou faça upload de mídia para "complementar evidências". Se o Runtime existir, pode executar node scripts/ensure-runtime.cjs --json a partir do diretório raiz do plugin para uma sondagem somente leitura, mantendo apenas state / kind / version / healthy / error.code; não anexar a saída completa do doctor. kind=desktop-managed indica apenas que a origem da instalação é o aplicativo desktop, não autorizando esta Skill a iniciar o App, serviço ou reinstalação. 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 Problema | target | Repositório GitHub |
|---|---|---|
| Runtime, Studio, UI, CLI, API, Timeline, Renderização | product | Agentchengfeng/chengfeng-videocut |
| Skill, Marketplace, Orquestração de Instalação, MCP App, Instruções de Workflow | skills | Agentchengfeng/chengfeng-videocut-skills |
Problemas entre componentes devem ser reportados prioritariamente no repositório que primeiro violou o contrato, explicando o outro componente no corpo; se não for possível determinar, pergunte ao usuário primeiro.
3. Gere a 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; após a submissão, remova o JSON temporário e o Markdown:
{
"schemaVersion": 1,
"target": "product",
"component": "Studio",
"title": "Runtime 0.1.1 não consegue abrir a visualização de edição de HyperFrames",
"summary": "Resumo do impacto em uma frase",
"steps": ["Primeiro passo", "Segundo passo"],
"expected": "Comportamento esperado",
"actual": "Comportamento real",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["Apenas diagnósticos mínimos e públicos"],
"acceptance": ["Condições de correção verificáveis"]
}
Não incluir:
- API Key, Token, Cookie,
.env; - Vídeos, áudios, capturas de tela, logs completos ou transcrições;
- Nome do cliente, nome do vídeo original,
projectIdreal, caminhos absolutos do usuário; - Conteúdo de repositórios privados sem permissão do usuário.
4. Gere e Exiba o Rascunho Anonimizado
Localize o script a partir do SKILL.md atual:
Primeiro, conforme a Verificação de Atualização "Verificação de Prontidão" passo 1, localize a raiz do plugin
(a partir do caminho real do arquivo fonte desta Skill, suba dois níveis; não execute codex plugin list ou pesquise em outro
cache; <raiz do plugin> abaixo refere-se a esse caminho literal). Esta Skill usa apenas isso para localizar o script,
não instala Runtime nem inicia serviços:
node "<raiz do plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" draft --input "<arquivo JSON do relatório>" --output "<arquivo de saída do rascunho>" --json
O target deve ser explicitamente product ou skills. Faltando ou escrito incorretamente, deve parar, não podendo silenciosamente reportar para outro repositório. O script limpará chaves comuns, nomes de usuário locais, nomes de volume, fragmentos de caminho e parâmetros de consulta localhost; a anonimização automática não pode identificar qualquer nome de cliente, portanto, ainda é necessária uma leitura manual completa. 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 o relatório. 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 a submissão imediatamente seguinte na tarefa atual, expira em 30 minutos e não pode ser reutilizada entre tarefas ou repetidamente.
5. Submeta Após Confirmação
Submeta apenas o rascunho que acabou de ser exibido, com conteúdo inalterado:
node "<raiz do plugin>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<arquivo JSON do relatório>" --target "<repositório alvo>" --confirmed --confirm-token "<token de confirmação>" --receipt "<arquivo de comprovante de confirmação>" --json
Regras Fixas:
- Antes da submissão, o script verifica
gh auth status, as Issues do repositório alvo e o rótulobug; se falhar, mantém o rascunho. - Se a impressão digital do mesmo componente, passos de reprodução e resultado real já existir, retorna a URL da Issue original, sem usar um título genérico para fingir duplicidade.
- Se o conteúdo do corpo mudar após a confirmação, retorna
confirmation_mismatch, devendo ser pré-visualizado novamente. - Se a credencial de confirmação expirar ou já tiver sido usada, retorna
confirmation_expired / confirmation_replayed, devendo ser pré-visualizado novamente. - Se o resultado da criação não tiver uma URL de Issue explícita, não repetir automaticamente; ela pode já ter sido criada.
- Só pode dizer "já foi reportado" quando tiver a URL da Issue no GitHub.
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 repete em loop.confirmation_required/confirmation_mismatch: Reexibe o conteúdo público exato.- Sem permissão ou visibilidade no repositório alvo: Não reportar para qualquer repositório; deixe o usuário decidir se reporta para o repositório público de Skills.