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 Problema | target | Repositório GitHub |
|---|---|---|
| Runtime, Studio, UI, CLI, API, Timeline, Renderização | product | Agentchengfeng/chengfeng-videocut |
| Habilidade, Marketplace, Instalação, MCP App, Fluxo de Trabalho | skills | Agentchengfeng/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,
projectIdreal, 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ótulobug; 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.