Pericia Template

Skill: Criador de Páginas de Perícia

Esta skill automatiza a criação de páginas de perícia de cartas Pokémon TCG graduadas, usando o template padronizado do projeto.

Quando Usar

• Quando o usuário pedir para criar uma nova perícia
• Quando quiser adicionar uma nova carta ao portfólio
• Quando precisar documentar uma carta graduada
• Quando mencionar "nova perícia", "criar laudo", "adicionar carta"

Processo de Criação

1. Coleta de Informações

Faça perguntas ao usuário usando o AskUserQuestion tool para coletar:

Informações Básicas:

• Nome da carta
• Número da carta
• Coleção/Set
• Ano de lançamento
• Raridade (use a padronização abaixo)
• Tipo do Pokémon
• Idioma
• Fabricante
• Ilustrador/Artista
• URLs das fotos (frente e verso)

Padronização de Raridades: Use sempre o formato misto português/inglês com abreviações padronizadas:

• SAR: "Ilustração Especial Rara (SAR)"
• AR: "Ilustração Rara (AR)"
• HR: "Hyper Rare (HR)"
• SR: "Shiny Rare (SR)"
• UR: "Ultra Rare (UR)"

Informações de Graduação:

• Graduadora (Manafix ou GBA)
• Certificado
• Nota final
• Descrição da nota (Mint, Heavy Played, etc)
• Data da certificação/avaliação ou programa
• Notas por componente:
  • Centering
  • Corners
  • Edges
  • Surface
• Ranking/População (mesma nota, nota maior, total)

Informações Adicionais:

• Links de referência (MyP, TCGPlayer, Liga Pokémon, Price Charting, etc)
• Campos opcionais (Edição, Versão, Lançamento, Registro AAA)

2. Decisões de Estrutura

Use AskUserQuestion para perguntar:

Estrutura de Links:

• Opção A: Links dentro da seção de graduação (padrão Mew e Armarouge)
• Opção B: Seção separada "Links de Referência" (padrão Pikachu)

Campos Adicionais:

• Incluir campo "Edição"? (Mew)
• Incluir campo "Versão"? (Mew)
• Incluir campo "Lançamento"? (Armarouge)
• Incluir campo "Registro AAA"? (GBA)

Observações:

• Incluir nota sobre alteração de dados ao longo do tempo? (Mew e Armarouge)

Footer:

• Formato: "Laudo gerado em: [DATA]" ou "Laudo gerado para: [CERTIFICADO]"

3. Conteúdo Dinâmico

Solicite ao usuário:

Observações Técnicas Detalhadas: Para cada componente (Centering, Corners, Edges, Surface):

• Descrição detalhada da condição
• Ícone apropriado (✓ positivo, ⚠ neutro, ! atenção)
• Cor do texto (success, secondary, warning)

Observação de Autenticidade:

• Descrição da verificação de autenticidade

Histórico de Proveniência:

• Número de itens na timeline
• Para cada item:
  • Data/período
  • Título do evento
  • Descrição completa
  • Se deve iniciar expandido (collapse show)

Informações sobre Artista/Ilustrador:

• Breve descrição
• Lista de características/trabalhos

Notas sobre Graduadora:

• Informações relevantes sobre a graduadora

4. Geração do Arquivo

1. Leia o template: template_pericia.html
2. Substitua todas as variáveis {{VARIAVEL}} pelos valores coletados
3. Ajuste seções opcionais conforme as escolhas do usuário
4. Gere o conteúdo dinâmico (observações, histórico, informações de artista)
5. Salve em pages/[nome-arquivo].html

5. Cores de Badge Automáticas

Por Nota:

• 10 ou 9.5+: bg-success (verde)
• 9 - 9.25: bg-success (verde)
• 8 - 8.5: bg-warning text-dark (amarelo)
• 6 - 7.5: bg-secondary (cinza)
• 3 - 5.5: bg-secondary (cinza)

Barra de Progresso:

• Nota 9-10: bg-success
• Nota 8-8.9: bg-warning
• Nota <8: bg-secondary

Porcentagem da Barra:

• Calcular: nota × 10 (ex: nota 9 = 90%)

6. Validação Final

Antes de salvar, verifique:

• ✅ Todas as variáveis {{...}} foram substituídas
• ✅ URLs das fotos estão corretas
• ✅ Links externos estão completos
• ✅ Accordion do histórico tem IDs únicos (collapse1, collapse2, etc)
• ✅ Primeiro item do histórico tem collapse show se apropriado
• ✅ Cores dos badges correspondem às notas
• ✅ Raridade usa o formato padronizado (SAR, AR, HR, SR, UR)
• ✅ Nome do arquivo usa formato kebab-case (ex: pikachu-gold.html)

Referências

Para detalhes completos sobre variáveis e estrutura, consulte reference.md.

Exemplo de Fluxo

Usuário: "Criar perícia para o Charizard ex"

Assistente:
1. Fazer perguntas para coletar informações básicas
2. Perguntar sobre preferências de estrutura
3. Solicitar observações técnicas e histórico
4. Gerar HTML com base no template
5. Salvar em pages/charizard-ex.html
6. Informar ao usuário que a página foi criada

Notas Importantes

• Consistência: Mantenha o padrão das páginas existentes
• Formato de Data: Sempre DD/MM/YYYY
• Nome de Arquivo: Use kebab-case e seja descritivo
• Graduadoras: Respeite as diferenças entre Manafix, GBA, CAPY, CGC, ACE, BGS e PSA
• Bootstrap 5.3.0: Use as classes corretas do Bootstrap
• Accordion IDs: Devem ser únicos dentro da página
• Raridades: SEMPRE use o formato padronizado misto (português + abreviação inglesa)