Bhargav8120/PDF-a-ApuntesDeEstudio-Claude-Skill

PDF-a-ApuntesDeEstudio

Convierte un PDF proporcionado en apuntes de estudio precisos, detallados y legibles. Produce tanto Markdown como un PDF pulido, a menos que el usuario solicite lo contrario. Añade diagramas automáticamente cuando mejoren materialmente la comprensión. No agregues secciones de preparación de exámenes, cuestionarios o bancos de preguntas a menos que se solicite explícitamente.

Principios fundamentales

1. Fidelidad a la fuente: Trata el PDF proporcionado como la fuente principal. No inventes hechos, ecuaciones, ejemplos, citas, referencias a páginas o contenido faltante.
2. Cobertura: Conserva los conceptos importantes, definiciones, suposiciones, pasos, ecuaciones, ejemplos, advertencias y relaciones del documento. No te limites a resumir cada página.
3. Claridad: Explica los conceptos en lenguaje sencillo y luego proporciona la redacción técnica precisa. Define los términos desconocidos antes de usarlos.
4. Trazabilidad: Adjunta referencias a páginas para afirmaciones y secciones importantes siempre que el PDF proporcione una numeración de páginas fiable. Distingue los números de página impresos de los índices del visor de PDF cuando difieran.
5. Razonamiento visual: Crea automáticamente un diagrama cuando un proceso, arquitectura, transición de estados, jerarquía, flujo de datos, línea de tiempo o relación sea más fácil de entender visualmente. Evita diagramas decorativos.
6. Sin preparación de exámenes: No generes preguntas de examen, preguntas probables, predicciones de puntuación o secciones de "cram" para exámenes. Es aceptable un resumen conciso del capítulo.
7. Sin falsa certeza: Si una página es ilegible, una figura es ambigua o la extracción parece incompleta, márcalo explícitamente.

Flujo de trabajo

1. Inspeccionar la fuente

• Identifica título, autor/organización (si está disponible), tema, tipo de documento, estructura de capítulos/secciones y páginas totales.
• Determina si el PDF está basado en texto, escaneado o es mixto.
• Inspecciona tablas, figuras, leyendas, ecuaciones, notas al pie y apéndices cuando sea relevante.
• Si el PDF es largo, procésalo en secciones lógicas y mantén una lista de verificación de cobertura. No omitas secciones posteriores en silencio.
• Para documentos escaneados, usa OCR si está disponible. Verifica la salida de OCR con las imágenes de las páginas para ecuaciones, símbolos, subíndices, superíndices y tablas.

2. Construir un esquema del documento

Crea una jerarquía que refleje la fuente:

• Documento / capítulo
• Secciones principales
• Subsecciones
• Conceptos y detalles de apoyo

Mantén la terminología y el orden de la fuente a menos que reorganizar mejore claramente el aprendizaje. Si reorganizas, conserva las referencias a secciones/páginas de la fuente.

3. Redactar notas detalladas

Para cada concepto significativo, usa las partes relevantes de este patrón (no fuerces encabezados vacíos):

• Concepto / definición
• Intuición: Qué significa y por qué existe.
• Cómo funciona: Pasos ordenados o mecanismos.
• Detalles técnicos: Suposiciones, restricciones, notación, casos límite.
• Ejemplo: Usa un ejemplo de la fuente cuando esté disponible. Si creas un ejemplo ilustrativo simple, etiquétalo como ilustración añadida.
• Referencia a figura/tabla: Explica la figura o tabla original con palabras y cita su página.
• Confusión común: Aclara distinciones solo cuando estén respaldadas por la fuente o por definiciones estándar y no controvertidas.

Conserva los detalles técnicos importantes. Para algoritmos, incluye entradas, salidas, pasos, invariantes (si se proporcionan o son directamente derivables) y complejidad solo cuando esté indicada o sea derivable de forma segura. Nunca inventes afirmaciones de complejidad.

4. Ecuaciones y material numérico

• Reproduce las ecuaciones con precisión en LaTeX.
• Explica cada símbolo, sus unidades (si se proporcionan), suposiciones y para qué se usa la ecuación.
• Conserva las derivaciones paso a paso cuando estén presentes.
• Para ejemplos resueltos, muestra los valores dados, la fórmula, la sustitución, los pasos intermedios y el resultado.
• Verifica la aritmética de forma independiente. Si la fuente parece contener un error, informa la declaración de la fuente y explica el problema sospechado en lugar de corregirlo en silencio.
• No aplastes la notación matemática significativa en texto plano ambiguo.

5. Selección automática de diagramas

Elige diagramas según el contenido. Usa Mermaid para diagramas que se puedan representar claramente como texto; usa SVG/PNG generados con Python o Matplotlib para gráficos y visualizaciones personalizadas cuando las herramientas estén disponibles.

Mapeo recomendado:

• Proceso / algoritmo / flujo de trabajo → diagrama de flujo
• Arquitectura del sistema / componentes → diagrama de bloques o componentes
• Intercambio de mensajes / protocolo → diagrama de secuencia
• Estados / ciclo de vida → diagrama de estados
• Clasificación / taxonomía → árbol o jerarquía
• Comparación → tabla, no un diagrama innecesario
• Tendencia numérica / datos medidos → gráfico con ejes etiquetados y unidades
• Relación espacial → esquema tipo mapa solo si los datos de la fuente lo respaldan

Reglas de diagramas:

• Cada diagrama debe tener un título y explicarse en el texto circundante.
• Usa las entidades y relaciones reales de la fuente. No agregues componentes o flechas causales no respaldadas por el PDF.
• Etiqueta las relaciones inferidas como interpretaciones.
• Mantén los diagramas legibles; divide los diagramas abarrotados en otros más pequeños.
• Si no se puede generar un diagrama de forma fiable, proporciona el código fuente de Mermaid o un esquema textual claro en lugar de pretender que existe una imagen.
• No redibujes una figura con derechos de autor como un sustituto casi idéntico. Crea un esquema explicativo original basado en los conceptos subyacentes y cita la página de la fuente.

6. Explicar figuras y tablas originales

Para cada figura/tabla original importante:

• Indica su propósito.
• Explica ejes, símbolos, leyenda, filas, columnas y relaciones clave.
• Describe la conclusión sin exagerar lo que demuestra la figura.
• Incluye el número de página de la fuente.
• Si la extracción de imágenes no está disponible, dilo y solicita una fuente más clara en lugar de adivinar.

7. Aseguramiento de la calidad

Antes de finalizar, verifica:

• Cada sección principal de la fuente está representada.
• No faltan definiciones, ecuaciones, figuras, ejemplos y advertencias importantes.
• Los términos técnicos y la notación son consistentes.
• Las referencias a páginas son plausibles y no inventadas.
• Los diagramas concuerdan con el texto.
• No se ha añadido contenido no respaldado ni material de preparación de exámenes.
• El Markdown se renderiza limpiamente y la exportación a PDF es legible.

Formato de salida

Crea dos entregables:

A. study_notes.md

Usa esta estructura:

# [Título del documento] — Apuntes de estudio detallados

> **Fuente:** [nombre del archivo/título]
> **Cobertura:** [páginas o secciones cubiertas]
> **Nota:** Estos apuntes explican la fuente; el material incierto o ilegible está marcado.

## Contenidos
[esquema enlazado]

## 1. [Sección principal]
### 1.1 [Subsección]
[Explicación detallada]

**Idea clave:** ...

**Ecuación:** ...

**Diagrama:** ...
[Bloque de Mermaid o imagen generada incrustada]

**Fuente:** PDF pág. X

## ...
## Resumen del capítulo
[Síntesis concisa de las ideas principales, sin preguntas de examen]
## Cobertura y limitaciones
[Páginas/secciones procesadas, áreas ilegibles, advertencias de extracción]

Adapta la estructura al documento. No incluyas encabezados vacíos. Para documentos con varios capítulos, organiza por capítulo.

B. study_notes.pdf

• Renderiza el Markdown en un PDF limpio y profesional.
• Incluye una portada, tabla de contenidos si es práctico, jerarquía de encabezados clara, números de página, fuentes legibles y diagramas con el tamaño adecuado.
• Evita recortes, texto pequeño, ecuaciones rotas y diagramas divididos incómodamente entre páginas.
• Si la renderización directa a PDF no está disponible, proporciona el Markdown y un archivo HTML claramente etiquetado o instrucciones para la conversión. Nunca afirmes que se generó un PDF si no fue así.

Comportamiento de interacción

• Si se adjunta un PDF, comienza a procesarlo sin pedir al usuario que repita la solicitud.
• Si se adjuntan varios PDF, haz una sola pregunta concisa solo si no está claro si combinarlos o producir notas separadas.
• Si el documento es extremadamente largo, procésalo en lotes e indica claramente qué se ha cubierto y qué no.
• Si el usuario especifica una audiencia o nivel objetivo, adapta la profundidad de la explicación manteniendo la precisión técnica.
• Si el usuario solicita una versión más corta más tarde, derívala de las notas completas en lugar de resumir ciegamente desde la memoria.

Scripts de apoyo

Los scripts en scripts/ son utilidades locales opcionales. Úsalos cuando el entorno de ejecución admita Python y los paquetes requeridos. No reemplazan la lectura cuidadosa del PDF ni la inspección visual de las páginas escaneadas.