aitormf/agent-skills

Divise un plan technique approuvé en petites tâches, ordonnées par dépendances, avec les fichiers impactés, une vérification par tâche et des groupes parallèles. À utiliser lorsqu'un plan existe et que l'on demande de le décomposer en tâches ou de le préparer pour l'implémentation.

Qu'est-ce que agent-skills ?

Cette compétence transforme un plan technique approuvé en une liste de tâches exécutables pour l'agent d'implémentation. Elle est utile pour structurer le travail, en s'assurant que chaque tâche est petite, révisable et vérifiable, avec un ordre défini par les dépendances. Elle prend en charge les projets en anglais et en espagnol (en vérifiant les sections `Commands` ou `Comandos` de `AGENTS.md`). Le processus inclut une vérification préalable (le plan doit être approuvé), la création d'un fichier `tasks.md` basé sur un modèle, et la gestion des groupes parallèles. La compétence garantit que chaque critère d'acceptation et test négatif est couvert, et impose une phase de clôture avec des tests et une commande de vérification au vert.

Compatible avec~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/aitormf/agent-skills/tree/HEAD/skills/plan-to-tasks

Documentation

Du plan aux tâches

Transformez un plan en une liste de tâches exécutables que l'agent implement peut suivre et cocher.

Chaque élément de travail se trouve dans docs/specs/<AAAAMMJJ>-<type>-<nom>/.
tasks.md n'a pas de statut : sa progression est indiquée par les cases à cocher [x].

Avant de commencer

Identifiez l'élément de travail et lisez plan.md et spec.md.
Porte : si le plan n'a pas status: approved, arrêtez-vous et demandez :

Le plan est <status>». Dois-je continuer quand même, le réviser d'abord avec review-spec`, ou allez-vous l'approuver maintenant ?

Continuez uniquement avec une réponse explicite. Pour une petite modification sans plan, la porte s'applique à la spécification.
Lisez la commande de vérification dans la section Commands de AGENTS.md (Comandos dans les projets en espagnol). S'il n'y en a pas, demandez quelle elle est ou laissez la tâche de clôture avec un avertissement.

Comment diviser

Petites tâches : chacune est un changement révisable qui laisse le projet vert.
Ordonnées par dépendances. Marquez avec [P] celles qui peuvent être effectuées en parallèle avec la précédente.
Chaque tâche liste les fichiers qu'elle touche, si connus, et comment elle est vérifiée : quel test, ou quelle commande.
Si le projet fonctionne avec le TDD (CONTRIBUTING.md ou AGENTS.md le diront), le test vient avant le code ou dans la même tâche, jamais à la fin.
Chaque critère d'acceptation de la spécification et chaque test négatif de sécurité doit être couvert par au moins une tâche. Si ce n'est pas le cas, dites-le.
La phase de Clôture est obligatoire : critères d'acceptation avec tests et commande de vérification au vert.
N'ajoutez pas de travail qui n'est pas dans le plan. Si quelque chose manque dans le plan, soulevez-le comme une question.

Résultat

Rédigez tasks.md à partir de assets/tasks-template.md.
Montrez le brouillon avec :
- les tâches ;
- les groupes parallèles ;
- les points de vérification ;
- toutes les questions restantes.
Ne l'écrivez qu'une fois que la personne approuve.
Prochaine étape suggérée : l'implémenter avec l'agent implement.