Bhargav8120/PDF-para-NotasDeEstudo-Claude-Skill

PDF-para-NotasDeEstudo

Transforme um PDF fornecido em notas de estudo precisas, detalhadas e legíveis. Produza tanto Markdown quanto um PDF polido, a menos que o usuário solicite o contrário. Adicione diagramas automaticamente quando eles melhorarem materialmente a compreensão. Não adicione seções de preparação para exames, questionários ou bancos de perguntas, a menos que explicitamente solicitado.

Princípios fundamentais

1. Fidelidade à fonte: Trate o PDF fornecido como a fonte primária. Não invente fatos, equações, exemplos, citações, referências de página ou conteúdo ausente.
2. Cobertura: Preserve os conceitos importantes, definições, suposições, etapas, equações, exemplos, ressalvas e relacionamentos do documento. Não apenas resuma cada página.
3. Clareza: Explique conceitos em linguagem simples e, em seguida, forneça o texto técnico preciso. Defina termos desconhecidos antes de usá-los.
4. Rastreabilidade: Anexe referências de página a afirmações e seções importantes sempre que o PDF fornecer numeração de página confiável. Distinga os números de página impressos dos índices de página do visualizador de PDF quando eles diferirem.
5. Raciocínio visual: Crie automaticamente um diagrama quando um processo, arquitetura, transição de estado, hierarquia, fluxo de dados, linha do tempo ou relacionamento for mais fácil de entender visualmente. Evite diagramas decorativos.
6. Sem preparação para exames: Não gere perguntas de exame, perguntas prováveis, previsões de notas ou seções de conteúdo intensivo para exames. Um resumo conciso do capítulo é aceitável.
7. Sem falsa certeza: Se uma página for ilegível, uma figura for ambígua ou a extração parecer incompleta, sinalize isso explicitamente.

Fluxo de trabalho

1. Inspecione a fonte

• Identifique título, autor/organização (se disponível), assunto, tipo de documento, estrutura de capítulos/seções e total de páginas.
• Determine se o PDF é baseado em texto, digitalizado ou misto.
• Inspecione tabelas, figuras, legendas, equações, notas de rodapé e apêndices quando relevante.
• Se o PDF for longo, processe-o em seções lógicas e mantenha uma lista de verificação de cobertura. Não omita silenciosamente as seções posteriores.
• Para documentos digitalizados, use OCR se disponível. Verifique a saída do OCR em relação às imagens das páginas para equações, símbolos, subscritos, sobrescritos e tabelas.

2. Construa um esboço do documento

Crie uma hierarquia que reflita a fonte:

• Documento / capítulo
• Seções principais
• Subseções
• Conceitos e detalhes de suporte

Mantenha a terminologia e a ordem da fonte, a menos que a reorganização claramente melhore o aprendizado. Se reorganizar, preserve as referências de seção/página da fonte.

3. Escreva notas detalhadas

Para cada conceito significativo, use as partes relevantes deste padrão (não force cabeçalhos vazios):

• Conceito / definição
• Intuição: O que significa e por que existe.
• Como funciona: Etapas ordenadas ou mecanismos.
• Detalhes técnicos: Suposições, restrições, notação, casos limite.
• Exemplo: Use um exemplo da fonte quando disponível. Se você criar um exemplo ilustrativo simples, rotule-o como uma ilustração adicionada.
• Referência a figura/tabela: Explique a figura ou tabela original em palavras e cite sua página.
• Confusão comum: Esclareça distinções apenas quando apoiado pela fonte ou por definições padrão e não controversas.

Preserve detalhes técnicos importantes. Para algoritmos, inclua entradas, saídas, etapas, invariantes (se fornecidos ou diretamente deriváveis) e complexidade apenas quando declarado ou seguramente derivável. Nunca invente alegações de complexidade.

4. Equações e material numérico

• Reproduza equações com precisão em LaTeX.
• Explique cada símbolo, suas unidades (se fornecidas), suposições e para que a equação é usada.
• Preserve as derivações passo a passo quando presentes.
• Para exemplos resolvidos, mostre os valores fornecidos, a fórmula, a substituição, as etapas intermediárias e o resultado.
• Verifique a aritmética de forma independente. Se a fonte parecer conter um erro, relate a declaração da fonte e explique o possível problema, em vez de corrigi-lo silenciosamente.
• Não aplaine a notação matemática significativa em texto simples ambíguo.

5. Seleção automática de diagramas

Escolha diagramas com base no conteúdo. Use Mermaid para diagramas que podem ser representados claramente como texto; use SVG/PNG gerado por Python ou Matplotlib para gráficos e visuais personalizados quando as ferramentas estiverem disponíveis.

Mapeamento recomendado:

• Processo / algoritmo / fluxo de trabalho → fluxograma
• Arquitetura de sistema / componentes → diagrama de blocos ou componentes
• Troca de mensagens / protocolo → diagrama de sequência
• Estados / ciclo de vida → diagrama de estados
• Classificação / taxonomia → árvore ou hierarquia
• Comparação → tabela, não um diagrama desnecessário
• Tendência numérica / dados medidos → gráfico com eixos e unidades rotulados
• Relação espacial → esquema semelhante a um mapa apenas se os dados da fonte suportarem

Regras para diagramas:

• Todo diagrama deve ter um título e ser explicado no texto ao redor.
• Use as entidades e relacionamentos reais da fonte. Não adicione componentes ou setas causais não suportados pelo PDF.
• Rotule relacionamentos inferidos como interpretações.
• Mantenha os diagramas legíveis; divida diagramas confusos em menores.
• Se um diagrama não puder ser gerado de forma confiável, forneça o código-fonte Mermaid ou um esquema textual claro, em vez de fingir que uma imagem existe.
• Não redesenhe uma figura protegida por direitos autorais como um substituto quase idêntico. Crie um esquema explicativo original com base nos conceitos subjacentes e cite a página da fonte.

6. Explique figuras e tabelas originais

Para cada figura/tabela original importante:

• Declare seu propósito.
• Explique eixos, símbolos, legenda, linhas, colunas e relacionamentos principais.
• Descreva a conclusão sem exagerar o que a figura prova.
• Inclua o número da página da fonte.
• Se a extração de imagem não estiver disponível, diga isso e peça uma fonte mais clara, em vez de adivinhar.

7. Garantia de qualidade

Antes de finalizar, verifique:

• Cada seção importante da fonte está representada.
• Definições, equações, figuras, exemplos e ressalvas importantes não estão faltando.
• Termos técnicos e notação são consistentes.
• As referências de página são plausíveis e não inventadas.
• Os diagramas concordam com o texto.
• Nenhum fato não suportado ou conteúdo de preparação para exames foi adicionado.
• O Markdown é renderizado de forma limpa e a exportação para PDF é legível.

Formato de saída

Crie dois entregáveis:

A. study_notes.md

Use esta estrutura:

# [Título do documento] — Notas de Estudo Detalhadas

> **Fonte:** [nome do arquivo/título]
> **Cobertura:** [páginas ou seções cobertas]
> **Nota:** Estas notas explicam a fonte; material incerto ou ilegível é sinalizado.

## Sumário
[esboço com links]

## 1. [Seção principal]
### 1.1 [Subseção]
[Explicação detalhada]

**Ideia-chave:** ...

**Equação:** ...

**Diagrama:** ...
[Bloco Mermaid ou imagem gerada incorporada]

**Fonte:** PDF p. X

## ...
## Recapitulação do capítulo
[Síntese concisa das ideias principais, sem perguntas de exame]
## Cobertura e limitações
[Páginas/seções processadas, áreas ilegíveis, ressalvas de extração]

Adapte a estrutura ao documento. Não inclua cabeçalhos vazios. Para documentos com vários capítulos, organize por capítulo.

B. study_notes.pdf

• Renderize o Markdown em um PDF limpo e profissional.
• Inclua uma página de título, sumário se prático, hierarquia de cabeçalhos clara, números de página, fontes legíveis e diagramas dimensionados adequadamente.
• Evite cortes, texto minúsculo, equações quebradas e diagramas divididos de forma estranha entre páginas.
• Se a renderização direta de PDF não estiver disponível, forneça o Markdown e um arquivo HTML claramente rotulado ou instruções para conversão. Nunca afirme que um PDF foi gerado se não foi.

Comportamento de interação

• Se um PDF for anexado, comece a processá-lo sem pedir ao usuário para reafirmar a solicitação.
• Se vários PDFs forem anexados, faça uma pergunta concisa apenas se não estiver claro se deve combiná-los ou produzir notas separadas.
• Se o documento for extremamente longo, processe-o em lotes e declare claramente o que foi e o que não foi coberto.
• Se o usuário especificar um público-alvo ou nível, adapte a profundidade da explicação preservando a precisão técnica.
• Se o usuário solicitar uma versão mais curta posteriormente, derive-a das notas concluídas, em vez de resumir novamente cegamente da memória.

Scripts de suporte

Os scripts em scripts/ são utilitários locais opcionais. Use-os quando o ambiente de execução suportar Python e os pacotes necessários. Eles não substituem a leitura cuidadosa do PDF ou a inspeção visual de páginas digitalizadas.