Suporte upstream incluído

Arquivos de suporte são incluídos em caminhos relativos à skill. Veja UPSTREAM-NOTICE.md para suas fontes fixadas, licenças, hashes e alterações de importação.

Documentação Técnica

Quando Usar

• Uma análise finalizada precisa de um relatório estruturado e compartilhável.
• Padronização de relatórios em múltiplos casos.

Documentação de Saída para Tarefas de Segurança/Engenharia Reversa

Quando tarefas de engenharia reversa/pentest/CTF/análise de segurança são concluídas, esta skill é responsável por gerar documentação técnica formal no diretório de projetos do usuário.

Gatilhos

1. Tarefa de engenharia reversa concluída, com conclusões centrais produzidas (recuperação de algoritmo, quebra de assinatura, solução de bypass, etc.)
2. Teste de penetração concluído, com vulnerabilidades descobertas e validadas
3. CTF resolvido, com o flag obtido
4. O usuário solicita explicitamente "escrever um relatório/documento/writeup"

Seleção de Modelo

Estrutura do Relatório do Fornecedor (Issue #65)

Relatórios formais de segurança DEVEM ler references/vendor-report-rules.md (apenas a estrutura, não o texto original do fornecedor). Selecione o sabor do fornecedor apenas quando as evidências da tarefa ou o usuário solicitarem explicitamente; use flavor = null para engenharia reversa comum e outras tarefas.

Princípio: Modelos são sobre qualidade, não quantidade — Apenas 2 sabores de corpo inteiro de fornecedor; vuln é apenas um overlay fino opcional, não crie um terceiro modelo padrão de corpo inteiro. Efetivo simultaneamente com §0 Evidência→Descoberta→Caminho; em caso de conflito, o contrato de Evidência tem prioridade.

Especificações de Saída

• Local de Saída: Diretório do projeto atual do usuário (não o diretório do pacote da skill)
• Formato do Nome do Arquivo: YYYY-MM-DD_[类型]-[目标简称]-report.md
• Se o projeto tiver um diretório docs/: Priorize colocá-lo em docs/
• Codificação: UTF-8
• Idioma: Segue o idioma de diálogo do usuário (relatório em chinês para diálogo em chinês, relatório em inglês para diálogo em inglês)

Requisitos de Qualidade

• Todos os blocos de código devem ser executáveis diretamente ou ter contexto claro
• Não deve haver placeholders/TODOs
• Descobertas chave devem ter evidências de suporte
• Passos de reprodução devem permitir que terceiros reproduzam independentemente
• Informações sensíveis (tokens reais, senhas, URLs internas) devem ser substituídas por placeholders
• DEVE incluir a cadeia Evidência → Descoberta → Caminho (veja ../ops/evidence-finding-path.md e o modelo §0)
• DEVE ler references/vendor-report-rules.md: selecione malware / apt ou flavor = null (tarefas de vulnerabilidade podem ter o thin vuln sobreposto); sem sabor, apenas produza o modelo da tarefa original e os elementos Base aplicáveis, sem forçar IOC/ATT&CK
• DEVE citar o caso scope.md / timeline.md (scripts/case-init.ps1)

case-init.ps1 escreve scope.md, timeline.md, workitems.md e README.md sob work/<CaseName>/. Ele se recusa a executar quando esse diretório de caso já existe; escolha um novo -CaseName para preservar os dados de casos anteriores.

Integração de Gráficos

Ao gerar relatórios, chame a skill diagram-generator para gerar gráficos visuais em locais apropriados:

Os gráficos são incorporados ao markdown do relatório como blocos de código Mermaid, garantindo que possam ser renderizados diretamente no GitHub/GitLab.

Princípios Fundamentais

1. Divulgação Progressiva

Revele informações em camadas:

Avisos, alterações que quebram o código e pré-requisitos vão no TOPO.

2. Escrita Orientada a Tarefas

<!-- Bad: Feature-oriented -->
## AuthService Class
The AuthService class provides authentication methods...

<!-- Good: Task-oriented -->
## Authenticating Users
To authenticate a user, call login() with credentials:

3. Mostre, Não Apenas Diga

Todo conceito precisa de um exemplo concreto.

Padrões de Formatação

• Títulos em minúsculas: "Começando" em vez de "Começando"
• Máximo de 3 níveis de título: Mais profundo significa dividir o documento
• Sempre especifique o idioma em blocos de código
• Caminhos relativos para links internos
• Tabelas para dados estruturados com 3+ atributos

Checklist de Qualidade

• Exemplos de código testados e executáveis
• Nenhum texto placeholder ou TODO
• Corresponde ao comportamento real do código
• Escaneável sem ler tudo
• O leitor sabe o que fazer a seguir

Anti-Padrões

…