2026-11-07 18:51:40 +01:00
# 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
```bash
2026-11-07 18:52:32 +01:00
/plugin marketplace add ssh://forgejo@zospace .freeboxos.fr/zo/claude-math
2026-11-07 18:51:40 +01:00
/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 :
```bash
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.