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>
This commit is contained in:
commit
b0bf2397e5
7 changed files with 777 additions and 0 deletions
79
README.md
Normal file
79
README.md
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
# 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
|
||||
/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 :
|
||||
|
||||
```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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue