asguth/grifo

Compétence Grifo

Génère un support d'étude de niveau universitaire sur n'importe quel sujet, à partir d'un thème ou d'un fichier fourni par l'utilisateur : feuilles A4 en deux colonnes, hiérarchie éditoriale sobre, diagrammes, tableaux, illustrations et questions inédites. Le tout passe par trois relecteurs (contenu, pédagogie, design) avant livraison.

Les chemins ci-dessous sont relatifs au dossier de ce fichier SKILL.md.

Chemin	Qu'est-ce que c'est	Quand le lire
references/comandos.md	Syntaxe, drapeaux et spécification de chaque commande	Toujours : seulement la section "Syntaxe" et celle de la commande
references/design.md	Palette, styles de couleurs, hiérarchie, quel composant utiliser, icônes	Avant le HTML
references/ilustracoes.md	Figure didactique : banque ouverte, générateur, licence et crédit	Quand le sujet a une structure physique
references/idiomas.md	Support dans une autre langue : étiquettes, polices, examens d'autres pays	Si la langue n'est pas pt-BR
references/componentes.md	HTML de chaque composant	Avant le HTML
references/fidelidade.md	Polices, citation et références avec lien	Avant de rechercher
references/bancas.md	Style des jurys de concours	Uniquement s'il y a un jury
agentes/*.md	Prompts des 3 relecteurs	Étape 6
assets/templates/*.html	Squelette de chaque commande	Début de l'étape 4
assets/lucide/nomes.txt	2 052 icônes Lucide (nom: tags)	Utilisez grep, ne lisez jamais entièrement
scripts/figura.py	Banque organisée par domaine, cherche/télécharge une figure avec licence ouverte (Commons), génère une molécule (RDKit) et un graphique (matplotlib)	Étape 4, s'il y a une figure
assets/acervo.json	61 figures vérifiées dans 10 domaines (lu par figura.py acervo)	Ne lisez pas entièrement : utilisez le script
scripts/verificar.py, montar.py, renderizar.py	Lint → HTML autonome → PDF/PNG + relecture de mise en page	Étape 5

Commandes

/<commande> <sujet ou fichier> [--format f] [--style s] [--niveau n] [--jury j] [--feuilles N]
          [--support fichier] [--langue xx]

/resume, /schema, /loi-seche, /comparer, /pieges, /questions, /flashcards, /mnemotechnique, /programme, /planning, /revision, /polycopie, /valider, /grifo (aide). /cmd, cmd: et langage naturel → même flux. Drapeau inconnu → avertir et continuer avec le par défaut. Commande inexistante → afficher l'aide de /grifo. Détails dans references/comandos.md.

Flux (suivez dans l'ordre)

1. Comprendre la demande — et poser des questions quand il manque des informations

Si la demande ne contient pas de sujet/fichier ou de format, demandez une fois, en un seul message (sur Claude Code, avec l'outil de question si disponible), en proposant les options :

1. Sujet ou fichier : "Sur quel sujet — ou quel fichier (PDF, diapositives, notes) — voulez-vous le support ?"
2. Format :
   • Explication complète — résumé didactique (2–4 feuilles par défaut, sans limite) + questions + corrigé (/resume);
   • Juste le schéma — schéma visuel, 1 feuille par défaut (/schema);
   • Révision rapide — veille d'examen, 1 feuille par défaut (/revision);
   • Entraînement — questions + corrigé commenté (/questions) ou flashcards;
   • Tout compris — couverture, sommaire, résumé, schéma, flashcards, questions et corrigé (/polycopie).
3. Style visuel (chaque personne apprend différemment) :
   • Sobre — bleu marine et gris, couleur uniquement là où elle a du sens (par défaut);
   • Coloré — chaque sujet avec une couleur différente, bandes pleines;
   • Pastel — couleurs par sujet en tons doux, fonds clairs;
   • N&B — tons de gris, pour imprimer en noir et blanc.
4. Niveau (uniquement si impossible à déduire) : lycée, université (par défaut), concours (demandez le jury), certification.

Le format n'est considéré comme défini que s'il provient d'une commande avec barre oblique (/schema, /revision…), de --format, ou de mots explicites de l'utilisateur ("juste le schéma", "révision rapide", "avec des questions"). En langage naturel, "fais un polycopié/résumé/support de X" ne définit pas le format : demandez. Quand vous devez demander, demandez aussi le style, dans le même message. Une fois le sujet et le format définis, ne demandez plus rien : style non précisé = celui déjà utilisé par l'utilisateur pour cette conversation, sinon sobre (et citez --style coloré|pastel|nb sur une ligne lors de la livraison). Les demandes comme "plus coloré", "moins de couleur", "pour imprimer en N&B" changent le style.

Langue : rédigez le support et répondez dans la langue de l'utilisateur (ou --langue). En dehors du pt-BR, lisez references/idiomas.md avant le HTML. Liberté de création : choisissez les composants, l'ordre et l'emphase en fonction de ce qui enseigne le mieux.

2. Rassembler le contenu (fidélité avant l'esthétique)

Lisez references/fidelidade.md. Support utilisateur > source officielle/primaire > littérature de référence. Chaque nombre, date, formule, article ou définition technique est vérifié ; sans source accessible → <span class="verificar">. Conservez les sources avec URL pour les références.

3. Plan pédagogique (niveau université)

Pour chaque sous-thème : définition précise → mécanisme/pourquoi → exemple → erreur courante. Choisissez le composant en fonction de la forme du contenu (references/design.md §3) et illustrez tout ce qui a une structure. Texte courant uniquement pour un concept, court et mis en évidence.

4. Écrire le HTML source à partir du template

Copiez assets/templates/<commande>.html vers <slug>-source.html et remplacez tous les [[MARQUEUR]].

• <html lang="…" data-theme="sobre|colore|pastel|pb"> selon la langue et le style (design.md §1.1). Couleur fixe par sujet : class="couleur-1" … couleur-6 dans le bloc/colonne.
• Uniquement les classes du système de design (references/componentes.md) ; style="" seulement pour un ajustement ponctuel.
• Pas de limite de feuilles : la taille de la commande est une valeur par défaut, pas un maximum. Le contenu qui ne tient pas va sur une nouvelle .feuille ; ne coupez jamais le contenu pour le faire tenir, sauf --feuilles N de l'utilisateur.
• Questions toujours sur une seule colonne, sur une feuille dédiée. Corrigé commenté et références sur une feuille séparée, après les questions (pas de spoiler sur la même feuille).
• Références avec lien : <a href="URL officielle">titre</a>.
• Icônes : Lucide (<svg class="ico"><use href="#l-NOM"/></svg>, trouvez le nom avec grep -i terme assets/lucide/noms.txt), uniquement quand elles apportent du sens au bloc.
• Sujet avec structure physique (anatomie, physiologie, cellule, plante, molécule, circuit, montage de laboratoire, carte) : la figure est le centre de la feuille et provient d'une banque ouverte (scripts/figura.py acervo, puis chercher/telecharger) ou d'un générateur à partir de données (figura.py molecule, figura.py graphique). Ne dessinez jamais une structure académique de mémoire : l'IA se trompe en anatomie sans s'en rendre compte. Crédit obligatoire. Méthode dans references/ilustracoes.md.

5. Vérifier, assembler et rendre

python3 <skill>/scripts/verifier.py <slug>-source.html
python3 <skill>/scripts/assembler.py <slug>-source.html <slug>.html     # [--polices-embarquees]
python3 <skill>/scripts/rendre.py <slug>.html <sortie> --json     # [--nb]

Corrigez toute ERREUR du lint et tout avertissement de mise en page (débordement, fuite, colonnes déséquilibrées, police < 8 pt) avant de continuer. Sans Python/navigateur : livrez le HTML (Ctrl+P → A4, sans marges, graphiques de fond).

6. Validation (3 relecteurs qui n'ont pas rédigé le support)

Avec sous-agents : exécutez les trois en parallèle, chacun avec son agents/*.md + chemins du HTML et des PNG + sources utilisées. Sans sous-agents : trois passages en séquence, en relisant depuis zéro. Corrigez les BLOCANTS et les IMPORTANTS, réassemblez et rendez (max. 2 tours).

7. Livrer

HTML + PDF. En 2–4 lignes : ce qui a été généré, style utilisé, [VERIFIER] restants, sources principales et crédits des figures. Terminez par une ligne d'avertissement : support généré avec IA pour aide à l'étude ; ne remplace pas les livres, les cours ni les sources officielles ; vérifiez.

Règles non négociables

1. Fidélité > esthétique. Rien de mémoire sans vérification ; doute = [VERIFIER].
2. Droits d'auteur. Ne pas copier le texte, les schémas ou les questions de tiers. Image de tiers uniquement sous licence ouverte (CC0, domaine public, CC BY, CC BY-SA) et crédit. Les actes officiels peuvent être cités textuellement (Loi 9.610/98, art. 8, IV).
3. Pas de portraits de personnes réelles (citez le nom de l'auteur dans le texte).
4. Lisible en N&B. La couleur n'est jamais le seul porteur de sens : icône + étiquette. Dans une figure, la légende indique ce que chaque couleur signifie.
5. Densité de polycopié. Phrases directes, sans "dans ce résumé nous verrons" ; bloc > 6 lignes sans mise en évidence = réécrire.
6. Avertissement IA sur chaque feuille. Le pied de page imprime déjà "généré avec IA : vérifiez dans les sources" (via CSS, traduit par lang) ; ne le supprimez pas. Le support aide l'étude et ne remplace pas le livre, le cours, l'atlas, la loi officielle ni l'orientation professionnelle.