Skill Writing Plans
Transformez une conception approuvée en tâches vérifiables, avec interfaces et contrôles.
Communauté · Jesse Vincent / Prime Radiant| Auteur | Jesse Vincent / Prime Radiant |
|---|---|
| Licence | MIT |
| Source | obra/superpowers · SKILL.md sur GitHub |
| Site du projet | primeradiant.com/superpowers |
| Fonctionne dans | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lu à la source le |
writing-plans transforme une spécification approuvée en plan pour un ingénieur sans contexte préalable : chemins exacts, interfaces, contraintes et commandes de vérification.
Le plan est un document de transmission, pas une réalisation achevée. Les tâches regroupent des changements cohérents avec entrées et sorties explicites.
Extrait du SKILL.md du skill : writing-plans
Ce qu’il fait
- Lisez la spécification approuvée et examinez le code concerné.
- Définissez contraintes globales, interfaces et tâches révisables.
- Relisez le plan et convenez du mode d’exécution.
Ce que vous obtenez
- Plan dans docs/superpowers/plans/YYYY-MM-DD-<feature>.md, avec étapes et vérifications.
Quand l’utiliser
- Transmettre un changement à plusieurs étapes à un ingénieur absent de cette conversation.
Quand ne pas l’utiliser
- Exigences encore ouvertes : commencez par brainstorming.
Ce qu’il faut
- Spécification approuvée, agent avec fichiers et accès au projet.
- Exécution, tests et commits exigent outils et autorisations du projet.
Fichiers du skill
| Fichier ou dossier | À quoi il sert |
|---|---|
SKILL.md | Structure du plan, granularité et transmission. |
Licence trouvée dans le dépôt le 2026-11-19 : MIT.
Exemples de prompts
Tapez l’un de ces prompts après l’installation ; nommer le skill garantit qu’il sera utilisé.
- Transformez cette conception approuvée en plan avec interfaces et commandes de vérification.
- Vérifiez que les tâches sont cohérentes plutôt qu’une par fichier.
- Planifiez cette migration pour un nouvel ingénieur avec contraintes globales.
Comment installer writing-plans
Installation et autorisations
Le plugin complet conserve les liens vers brainstorming et l’exécution. Le dossier de planification contient seulement SKILL.md.
La source inclut tests préalables et commits. Adaptez-les aux règles du dépôt ; écrire le plan n’exécute pas ces étapes.
Un skill est un dossier contenant un fichier SKILL.md. Vous l’installez une fois ; l’agent lit sa courte description au début de chaque session et ne charge les instructions complètes que si une demande correspond. Choisissez l’environnement que vous utilisez :
Claude Code : depuis la marketplace de plugins
- Lancez Claude Code dans un terminal avec
claude. - Ce plugin se trouve dans la marketplace officielle d’Anthropic, que Claude Code ajoute pour vous au premier lancement.
- Installez le plugin. Claude Code affiche d’abord ses détails : vérifiez ce qu’il va ajouter (skills, hooks, serveurs MCP), puis choisissez s’il est pour vous, pour toutes les personnes de ce dépôt, ou pour vous seul dans ce dépôt.
/plugin install superpowers@claude-plugins-official - Tapez / et cherchez
/superpowers:writing-plans, ou demandez simplement la tâche.
Depuis votre shell plutôt que dans une session :
claude plugin install superpowers@claude-plugins-officialClaude Code : copier le dossier dans votre dossier de skills
Placez le dossier du skill dans ~/.claude/skills/ pour l’utiliser dans tous les projets de cet ordinateur, ou dans .claude/skills/ à l’intérieur d’un dépôt pour le partager avec toutes les personnes qui y travaillent (committez-le).
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p ~/.claude/skills
cp -R superpowers/skills/writing-plans ~/.claude/skills/Claude Code détecte pendant la session les skills nouveaux ou modifiés dans ces dossiers. Si le dossier de skills n’existait pas au démarrage de la session, lancez /reload-skills une fois. Tapez ensuite /writing-plans ou décrivez simplement la tâche.
Sous Windows, lancez les commandes dans Git Bash ou WSL, ou copiez le dossier au même endroit avec l’Explorateur de fichiers.
Codex, Gemini CLI, Cursor et GitHub Copilot
Ces agents lisent les mêmes dossiers SKILL.md. Le seul dossier que les quatre acceptent dans un projet est .agents/skills/ ; cette commande y copie donc le skill :
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p .agents/skills
cp -R superpowers/skills/writing-plans .agents/skills/| Agent | Dossier du projet | Votre dossier utilisateur | Remarques |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Tapez $ ou lancez /skills pour choisir un skill ; Codex en choisit aussi un quand votre tâche correspond. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Ou installez-le depuis Git avec gemini skills install <git URL> --path <folder> --consent. Le 18 juin 2026, Google a remplacé Gemini CLI par Antigravity CLI pour les utilisateurs de l’offre gratuite et de Google One ; Antigravity utilise .agents/skills/ dans un projet et ~/.gemini/config/skills/ pour vous. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Tapez / dans le chat Agent pour choisir un skill. Cursor lit aussi les dossiers .claude/skills/ de Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Fonctionne dans Copilot CLI, l’agent cloud et le mode agent de VS Code, Visual Studio et JetBrains (la prise en charge dans l’IDE dépend de la version). Ou lancez gh skill install OWNER/REPOSITORY SKILL (préversion publique, GitHub CLI 2.90.0 ou ultérieure). |
Sources de ces étapes
Vérifiées dans la documentation de chaque éditeur le 2026-11-14 :
Un plan qui survit aux changements de contexte
Les contraintes globales traversent les tâches. Les interfaces précisent entrées et sorties et limitent les hypothèses cachées lors de la transmission.
Relisez avant d’exécuter. Même détaillée, une commande reste une proposition tant que son résultat n’est pas vérifié.
Questions sur writing-plans
Exécute-t-il le plan ?
Non. Il l’écrit, le révise puis transmet au mode d’exécution convenu.
Quel contexte inclure dans une tâche ?
Chemins exacts, interfaces, contraintes, étapes et commandes concrètes de vérification.
Un fichier correspond-il à une tâche ?
Non. Une tâche doit être un changement cohérent et révisable ; les fichiers ne suffisent pas.
Faut-il un service payant ?
Aucun service supplémentaire n’est spécifié, mais l’agent ou l’API peut être facturé.
Plus de skills IA
Skills similaires
Skill Brainstorming
Communauté · Jesse Vincent / Prime RadiantTransformez une idée initiale en conception approuvée avant de coder.Skill Subagent-Driven Development
Communauté · Jesse Vincent / Prime RadiantExécutez un plan approuvé avec nouveaux réalisateurs, revues ciblées et journal des tâches.planning-with-files skill
Communauté · OthmanAdiConservez plans et progrès dans des fichiers avec hooks selon l’hôte.Skill To-Spec
Communauté · Matt PocockConsignez les décisions approuvées en spécification puis publiez-la dans le suivi configuré.Skill To-Tickets
Communauté · Matt PocockDécoupez une spécification en tranches verticales démontrables avec blocages explicites.n8n auto-hébergé skill
Communauté · Romuald CzłonkowskiDéployez et maintenez n8n avec Docker, HTTPS Caddy, services privés et sauvegardes vérifiées.