claude-math/README.md
boyreau b0bf2397e5 Export du skill et du hook de maths en plugin claude-math
Regroupe dans un plugin Claude Code autonome ce qui vivait dans le `.claude/`
du dossier de cours :

- skill `math-exercises` (génération + correction de séries d'exercices),
- commande `/exos` (force Opus),
- hook `UserPromptSubmit` de vérification des calculs.

Le dépôt sert à la fois de plugin et de marketplace à entrée unique, pour
pouvoir être installé directement depuis son URL.

Les références internes du skill aux chemins `.claude/…` ont été réécrites
vers les chemins du plugin, et la convention de portée du modulus a été
alignée sur le comportement du hook : un `mod N` écrit sur n'importe quel
maillon d'une chaîne porte sur tous les maillons.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-11-07 18:51:40 +01:00

3.4 KiB
Raw Blame History

claude-math

Plugin Claude Code pour le cours Mathématiques pour la cryptographie (M1 Cybersécurité, A. Roux-Langlois).

Il regroupe ce qui était jusque-là dans le .claude/ du dossier de cours :

Composant Chemin Rôle
Skill skills/math-exercises/SKILL.md Génère des séries de 4 exercices progressifs sur le prochain sujet non maîtrisé, corrige les réponses, et tient à jour PROGRESS.md / REVISIONS.md.
Commande commands/exos.md /exos — lance le skill en forçant Opus via son frontmatter model:.
Hook hooks/verify-calculations.sh UserPromptSubmit : vérifie automatiquement toute affirmation mathématique tapée dans un message et renvoie un verdict ✅/❌ ligne par ligne.

Installation

/plugin marketplace add ssh://forgejo@zospace.freeboxos.fr/forgejo/zo/claude-math
/plugin install claude-math@claude-math

Le dépôt est à la fois le plugin (.claude-plugin/plugin.json) et une marketplace à entrée unique (.claude-plugin/marketplace.json), donc les deux commandes suffisent.

Ce que le skill attend du projet où il tourne

Le plugin ne transporte pas les données du cours. Dans le dossier de travail, il s'attend à trouver :

  • CLAUDE.md — le plan du cours (TD1/TD2/TD3 et leurs sous-sections) ; c'est la source de la liste des sujets ;
  • NOTATIONS_REFERENCE.md — les notations telles qu'elles apparaissent en cours ;
  • PROGRESS.md — suivi par sujet (créé par le skill s'il manque) ;
  • REVISIONS.md — notions non réussies du premier coup, pour re-test espacé (créé par le skill s'il manque) ;
  • les PDF des TD et de leurs corrections, pour calibrer notation et difficulté.

Le hook de vérification

À chaque message, le hook extrait les énoncés vérifiables et les contrôle :

  • chaînes d'égalités et de congruences — 8^6 mod 15 = 64*8^4 = … = 4 ;
  • divisibilité — 7 | 28 ;
  • primalité — 13 est premier ;
  • pgcd / ppcm / φ(n) ;
  • équations à une inconnue — 2x + 3 = 7.

Règle de portée du modulus : un mod N écrit sur n'importe quel maillon d'une chaîne porte sur tous les maillons. C'est la convention du cours : le modulus est énoncé une fois et reste implicite ensuite. Si deux moduli différents apparaissent dans la même chaîne, le hook se tait plutôt que d'accuser à tort.

Notations acceptées : exposants Unicode (4²²), ≡, (mod 15), φ, ×, ·, pgcd/ppcm, et le LaTeX courant ($…$, \equiv, \pmod{15}, 8^{6}). Les maths noyées dans de la prose française sont extraites et vérifiées ligne par ligne.

Dépendance

Le script lance Python avec sympy via nix-shell -p python3 python3Packages.sympy — il suppose donc NixOS (ou Nix installé). Sur une machine sans Nix, remplacer cette ligne de hooks/verify-calculations.sh par un python3 disposant de sympy. Sans dépendance disponible, le hook échoue silencieusement et ne bloque jamais l'envoi d'un message.

Développement

Le hook est un script bash qui encapsule un programme Python en heredoc. Pour le tester sans passer par Claude Code, lui envoyer sur stdin le JSON de l'évènement :

printf '{"prompt": "8^6 mod 15 = 64 * 8^4 = 4"}' | bash hooks/verify-calculations.sh

Il répond sur stdout un JSON {"systemMessage": …} contenant les verdicts, et les écrit en direct sur /dev/tty quand un terminal est disponible.