Codex Academic Notes Engine 🎓

Skill : Codex Academic Notes Engine 🎓

Ce skill permet à un agent IA de traiter des enregistrements de cours académiques (vidéo ou audio), d'analyser le matériel visuel et phonétique, et de générer des notes universitaires structurées et performantes pour Obsidian.

---

Quand utiliser ce skill

Utilise ce skill lorsque :

• L'utilisateur te demande de traiter un enregistrement de cours (ex. "Prends le cours de Systèmes d'exploitation enregistré avec OBS et génère les notes").
• Tu souhaites synthétiser ou structurer des notes à partir d'un fichier vidéo ou audio contenant des diapositives.
• Tu souhaites valider et exporter des notes propres directement dans la bibliothèque Obsidian de l'utilisateur.

---

Flux de travail de l'agent (pas à pas)

Étape 1 : Préparer le bundle de session avec Codex

Exécute la CLI de Codex pour inspecter le média, extraire la piste audio optimisée (16 kHz mono) et détecter les changements de diapositive :

codex prepare "<chemin_vers_video_ou_audio>" --subject <nom_ou_code_matiere> [--date AAAA-MM-JJ]

Résultat généré par Codex : Crée un paquet de travail dans .codex_bundles/<id_session>/ avec :

• manifest.json : Métadonnées techniques, durée, matières et liste des diapositives avec horodatages.
• agent_context.md : Instructions consolidées et modèle de cours.
• audio/lecture.opus : Piste audio optimisée pour l'écoute et la transcription.
• slides/slide_HHMMSS.png : Captures d'écran dédupliquées correspondant à chaque changement de diapositive.

Étape 2 : Inspecter le matériel

1. Lis manifest.json et agent_context.md dans le dossier du bundle pour connaître les métadonnées de la matière et la liste des diapositives capturées.
2. Examine les images dans slides/ (analyse des diagrammes, code à l'écran, formules et titres de diapositive).
3. Analyse la piste audio ou son contenu phonétique pour transcrire et synthétiser les explications de l'enseignant.

Étape 3 : Synthétiser les notes pour Obsidian

Rédige le contenu en Markdown en respectant strictement ces consignes académiques :

1. Frontmatter YAML :

---
materia: "<Nom de la matière>"
code: "<Code>"
date: AAAA-MM-JJ
enseignant: "<Nom de l'enseignant>"
etat: traité
tags: [<tags_de_la_matière>]
---

2. Titre principal : # <Matière> : <Sujet central de la séance>

3. 📌 Engagements, tâches et avis administratifs : Extrais les annonces de partiels, devoirs, dates limites et conditions particulières : - [ ] [HH:MM:SS] Description de l'affectation (Date limite : ...)

4. 🧠 Concepts fondamentaux et avertissements pour l'examen : Utilise les callouts natifs d'Obsidian :

• > [!tip] Concept clé : [Concept] définition et pertinence théorique.
• > [!warning] Piste d'examen : [Point souligné] lorsque l'enseignant signale des aspects critiques ou des erreurs courantes.
• > [!example] Démonstration pratique exemples, démonstrations ou cas pratiques.

5. 📝 Développement chronologique et conceptuel du cours : Organisé en blocs chronologiques avec horodatage : ### [HH:MM:SS] [Sous-thème traité]

• Liaison visuelle obligatoire : À la minute exacte où le professeur introduit ou explique une diapositive capturée, insère son image avec la syntaxe Obsidian : ![[slide_HHMMSS.png]].
• Décris les schémas ou le code visible sur la diapositive en corrélation avec le discours oral.
• Écris les formules mathématiques en LaTeX (KaTeX : $formule$ en ligne ou $$formule$$ en bloc).
• Surligne les extraits de code avec le bloc correspondant (python, c, sql, etc.).

6. 📜 Transcription indexée par intervalles : Citations textuelles ou résumé fidèle de ce qui a été exprimé toutes les 2 à 3 minutes : > [HH:MM:SS] Texte transcrit ou citation pertinente...

Étape 4 : Exporter vers Obsidian

Enregistre le brouillon généré dans <bundle_dir>/notes.md et exécute :

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

Codex :

1. Validera le document.
2. Copiera automatiquement toutes les images de diapositives dans le dossier des pièces jointes d'Obsidian (attachments/Codex/).
3. Placera la note dans le dossier de la matière dans la bibliothèque (Cours/<Matière>/AAAA-MM-JJ - <Sujet>.md).
4. Mettra à jour l'état dans manifest.json en exported.

Étape 5 : Confirmer à l'utilisateur

Informe l'utilisateur de la fin du processus en indiquant le chemin de la note générée dans Obsidian, un bref résumé des sujets abordés et des engagements détectés.