chore(claude): versionner les skills partagés dans le repo
All checks were successful
Deploy / deploy (push) Successful in 2m47s
All checks were successful
Deploy / deploy (push) Successful in 2m47s
Ajoute les exceptions .gitignore pour tracker .claude/skills/ tout en continuant d'ignorer settings.local.json et projects/ (fichiers perso). Inclut les skills task-workflow et ui-style.
This commit is contained in:
parent
02ad36fb34
commit
78897eda4a
142
.claude/skills/task-workflow/SKILL.md
Normal file
142
.claude/skills/task-workflow/SKILL.md
Normal file
@@ -0,0 +1,142 @@
|
||||
---
|
||||
name: task-workflow
|
||||
description: Workflow complet pour traiter une tâche du TASK.md — branche git, développement, tests, commit conventionnel, push, puis archivage dans DONE.md. Utiliser quand l'utilisateur veut implémenter une tâche listée dans TASK.md.
|
||||
allowed-tools: Read, Bash, Edit, Write, Glob, Grep
|
||||
---
|
||||
|
||||
# Workflow de traitement d'une tâche (TASK.md → DONE.md)
|
||||
|
||||
Quand l'utilisateur demande de traiter une tâche du `TASK.md`, suivre **dans l'ordre** les étapes ci-dessous.
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Étape 0 — Repartir d'une branche saine depuis `origin/main`
|
||||
|
||||
**IMPORTANT : toujours commencer par cette étape, sans exception.**
|
||||
|
||||
```bash
|
||||
git fetch origin
|
||||
git checkout main
|
||||
git pull origin main
|
||||
```
|
||||
|
||||
Ensuite seulement créer la branche de travail (voir étape 2).
|
||||
|
||||
> Règle : ne jamais partir d'une branche de feature existante. Toujours tirer depuis `main` à jour.
|
||||
|
||||
---
|
||||
|
||||
## Étape 1 — Lire et choisir la tâche
|
||||
|
||||
1. Lire `TASK.md` pour identifier la tâche à traiter (si non précisée, demander laquelle).
|
||||
2. Extraire : le titre, les fichiers impactés, et la liste des sous-tâches.
|
||||
|
||||
---
|
||||
|
||||
## Étape 2 — Créer une branche git
|
||||
|
||||
Nommer la branche d'après le type et le titre de la tâche :
|
||||
|
||||
```
|
||||
<type>/<slug-de-la-tache>
|
||||
```
|
||||
|
||||
Exemples de types : `feat`, `fix`, `style`, `refactor`, `test`, `chore`
|
||||
|
||||
```bash
|
||||
git checkout -b style/simplifier-table-homepage
|
||||
```
|
||||
|
||||
Règle : **ne jamais committer directement sur `main`**.
|
||||
|
||||
---
|
||||
|
||||
## Étape 3 — Implémenter la tâche
|
||||
|
||||
- Lire tous les fichiers mentionnés dans la tâche avant de les modifier.
|
||||
- Cocher mentalement chaque sous-tâche `[ ]` au fur et à mesure.
|
||||
- Respecter les skills existants selon les fichiers touchés :
|
||||
- Composant Vue → skill `vue-frontend`
|
||||
- Domaine PHP → skills `ddd-core`, `hexagonal-arch`, `cqrs`, `api-platform`
|
||||
- Tests → skill `testing-strategy`
|
||||
|
||||
---
|
||||
|
||||
## Étape 4 — Vérifier que tous les tests passent
|
||||
|
||||
```bash
|
||||
make test
|
||||
```
|
||||
|
||||
- Si des tests échouent, **corriger avant de continuer**.
|
||||
- Ne pas passer à l'étape suivante tant que la suite n'est pas verte.
|
||||
- Pour un test spécifique : `make test f="NomDeLaClasse"`
|
||||
|
||||
---
|
||||
|
||||
## Étape 5 — Commit conventionnel
|
||||
|
||||
Format Conventional Commits :
|
||||
|
||||
```
|
||||
<type>(<scope>): <description courte en français>
|
||||
|
||||
[corps optionnel : explication du pourquoi]
|
||||
```
|
||||
|
||||
**Types autorisés :** `feat`, `fix`, `style`, `refactor`, `test`, `chore`, `docs`
|
||||
|
||||
**Scope :** nom du domaine ou du composant impacté (ex: `manga-table`, `sidebar`, `homepage`)
|
||||
|
||||
Exemples :
|
||||
```
|
||||
style(manga-table): simplifier le wrapper card + hover vert sur le titre
|
||||
fix(sidebar): séparer toggle et navigation sur MenuGroup
|
||||
```
|
||||
|
||||
```bash
|
||||
git add <fichiers modifiés>
|
||||
git commit -m "style(manga-table): simplifier le wrapper card + hover vert sur le titre"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Étape 6 — Push de la branche
|
||||
|
||||
**Demander confirmation à l'utilisateur avant de pusher.**
|
||||
|
||||
```bash
|
||||
git push -u origin <nom-de-la-branche>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Étape 7 — Archiver la tâche dans DONE.md
|
||||
|
||||
1. Retirer le bloc de la tâche de `TASK.md` (section complète, du titre `##` jusqu'au `---` suivant).
|
||||
2. Ajouter la tâche dans `DONE.md` (créer le fichier s'il n'existe pas) avec la date et le sha du commit :
|
||||
|
||||
Format dans `DONE.md` :
|
||||
```markdown
|
||||
## [TYPE] Titre de la tâche — YYYY-MM-DD
|
||||
|
||||
> Branche : `<nom-de-la-branche>` | Commit : `<sha court>`
|
||||
|
||||
- [x] Sous-tâche 1
|
||||
- [x] Sous-tâche 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Résumé du flux
|
||||
|
||||
```
|
||||
fetch + checkout main + pull (branche saine)
|
||||
→ branche git depuis main
|
||||
→ TASK.md (choisir la tâche)
|
||||
→ implémentation
|
||||
→ make test (vert obligatoire)
|
||||
→ conventional commit
|
||||
→ push (après confirmation)
|
||||
→ DONE.md
|
||||
```
|
||||
Reference in New Issue
Block a user