Codex Academic Notes Engine 🎓

Skill: Codex Academic Notes Engine 🎓

Este skill permite que um Agente de IA processe gravações de aulas acadêmicas (vídeo ou áudio), analise o material visual e fonético e gere anotações universitárias estruturadas de alto desempenho para Obsidian.

---

Quando Usar Este Skill

Use este skill quando:

• O usuário solicitar o processamento de uma gravação de aula (ex: "Pegue a aula de Sistemas Operacionais gravada com OBS e gere as anotações").
• Você quiser sintetizar ou estruturar notas a partir de um arquivo de vídeo ou áudio com slides.
• Você quiser validar e exportar anotações limpas diretamente para o cofre do Obsidian do usuário.

---

Fluxo de Trabalho do Agente (Passo a Passo)

Passo 1: Preparar o Pacote de Sessão com Codex

Execute a CLI do Codex para inspecionar a mídia, extrair a trilha de áudio otimizada (16kHz mono) e detectar mudanças de slide:

codex prepare "<caminho_para_video_ou_audio>" --subject <nome_ou_codigo_da_materia> [--date AAAA-MM-DD]

Resultado gerado pelo Codex: Cria um pacote de trabalho em .codex_bundles/<id_sessao>/ com:

• manifest.json: Metadados técnicos, duração, disciplinas e lista de slides com marcas de tempo.
• agent_context.md: Instruções consolidadas e template da aula.
• audio/lecture.opus: Trilha de áudio otimizada para escuta e transcrição.
• slides/slide_HHMMSS.png: Capturas de tela deduplicadas correspondentes a cada mudança de slide.

Passo 2: Inspecionar o Material

1. Leia manifest.json e agent_context.md na pasta do pacote para conhecer os metadados da matéria e a lista de slides capturados.
2. Revise as imagens em slides/ (analise diagramas, código na tela, fórmulas e títulos de slide).
3. Analise a trilha de áudio ou seu conteúdo fonético para transcrever e sintetizar as explicações do professor.

Passo 3: Sintetizar as Anotações para Obsidian

Redija o conteúdo em Markdown seguindo estritamente estas diretrizes acadêmicas:

1. Frontmatter YAML:

---
materia: "<Nome da Disciplina>"
codigo: "<Código>"
data: YYYY-MM-DD
docente: "<Nome do Professor>"
status: processado
tags: [<tags_da_materia>]
---

2. Título Principal: # <Matéria>: <Tema Central da Sessão>

3. 📌 Compromissos, Tarefas e Avisos Administrativos: Extraia avisos de provas, tarefas, datas de entrega e condições especiais: - [ ] [HH:MM:SS] Descrição da atribuição (Data limite: ...)

4. 🧠 Conceitos Fundamentais e Advertências de Prova: Utilize os callouts nativos do Obsidian:

• > [!tip] Conceito Chave: [Conceito] definição e relevância teórica.
• > [!warning] Dica de Prova: [Ponto enfatizado] quando o professor destacar aspectos críticos ou erros comuns.
• > [!example] Demonstração Prática exemplos, demonstrações ou casos práticos.

5. 📝 Desenvolvimento Cronológico e Conceitual da Aula: Organizado em blocos cronológicos com marca de tempo: ### [HH:MM:SS] [Subtema tratado]

• Vinculação Visual Obrigatória: No minuto exato onde o professor introduz ou explica um slide capturado, insira sua imagem com sintaxe do Obsidian: ![[slide_HHMMSS.png]].
• Descreva os esquemas ou código visíveis no slide em correlação com o discurso oral.
• Escreva as fórmulas matemáticas em LaTeX (KaTeX: $formula$ em linha ou $$formula$$ em bloco).
• Realce fragmentos de código com o bloco correspondente (python, c, sql, etc.).

6. 📜 Transcrição Indexada por Intervalos: Citações textuais ou resumo fiel do que foi expresso a cada 2-3 minutos: > [HH:MM:SS] Texto transcrito ou citação relevante...

Passo 4: Exportar para Obsidian

Salve o rascunho gerado em <bundle_dir>/notes.md e execute:

codex export "<bundle_dir>" "<bundle_dir>/notes.md"

Codex:

1. Validará o documento.
2. Copiará automaticamente todas as imagens de slides para a pasta de anexos do Obsidian (attachments/Codex/).
3. Localizará a anotação na pasta da disciplina dentro do cofre (Aulas/<Matéria>/AAAA-MM-DD - <Tema>.md).
4. Atualizará o status em manifest.json para exportado.

Passo 5: Confirmar ao Usuário

Informe a finalização indicando o caminho da anotação gerada no Obsidian, um breve resumo dos temas tratados e os compromissos detectados.