- Shell 100%
Plugin Claude Code regroupant : - le skill `math-exercises` (génération et correction de séries d'exercices progressifs, suivi de progression et des notions à revoir) ; - la commande `/exos`, qui force Opus via son frontmatter `model:` ; - un hook `UserPromptSubmit` qui vérifie automatiquement les affirmations mathématiques tapées dans un message (chaînes d'égalités et de congruences, divisibilité, primalité, pgcd/ppcm/φ) et rend un verdict ligne par ligne. Le dépôt sert à la fois de plugin et de marketplace à entrée unique, pour pouvoir être installé directement depuis son URL. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .claude-plugin | ||
| commands | ||
| hooks | ||
| skills/math-exercises | ||
| README.md | ||
claude-math
Plugin Claude Code pour un cours de mathématiques pour la cryptographie : génération d'exercices calibrés, correction, suivi de progression, et vérification automatique des calculs tapés dans les messages.
| 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
Prérequis : Nix. Le hook de vérification lance Python + sympy via
nix-shell -p python3 python3Packages.sympy. Sans Nix sur la machine, le skill et la commande fonctionnent normalement mais le hook échoue silencieusement — aucun calcul n'est vérifié (il ne bloque jamais l'envoi d'un message). Voir Se passer de Nix pour l'adapter.
/plugin marketplace add <url-de-ce-dépôt>
/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.
Se passer de Nix
Remplacer dans hooks/verify-calculations.sh la ligne :
nix-shell -p python3 python3Packages.sympy --run python3 << 'PYTHON_EOF' 2>/dev/null
par un interpréteur disposant de sympy, par exemple :
python3 << 'PYTHON_EOF' 2>/dev/null
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.