Cours Vibe coding avec Claude Code · Module 15: Claude Code avancé
Ton propre équipage : subagents, skills et plugins
Dans cette leçon9
Avant chaque commit dans Treasure Map, tu demandes à Claude la même chose : examine les routes d'API sous l'angle de la sécurité. Une fois tu écris "jette un œil à la session", une autre fois "est-ce que quelqu'un peut enregistrer un pin sur le tableau d'un autre", et une troisième fois tu oublies de parler de la validation. À chaque fois la revue est un peu différente, et à chaque fois quelque chose d'autre passe à travers. Une procédure que tu répètes de mémoire avec d'autres mots, c'est une procédure que tu n'as pas.
Ce que tu sais déjà
Dans la leçon 9_5, tu as commandé un subagent video-reviewer avec tools: Read, Grep, Glob et model: sonnet, et dans la leçon 5_4 tu as envoyé en reconnaissance l'agent Explore intégré. Les skills, tu les connais depuis la leçon 6_1, et dans la leçon 10_5 le skill /deploy avec disable-model-invocation: true t'a laissé la décision du déploiement. De la leçon 5_10, tu sais qu'un subagent coûte des tokens et ne pense pas plus finement : il travaille simplement dans un contexte à part. Maintenant, tu assembles ces pièces en une seule procédure pour l'équipage : un relecteur, un skill qui l'appelle, et un plugin pour emporter les deux dans d'autres projets.
Demande pour Claude Code
Tu commandes le relecteur et le skill d'un seul ordre, car le skill doit appeler ce relecteur par son nom :
Crée le subagent de projet .claude/agents/security-reviewer.md, qui ne fait que lire
(Read, Grep, Glob) et vérifie les routes de app/api : la session, le propriétaire des données,
le schéma Zod et le texte des erreurs. Dans description, écris quand l'utiliser. Ensuite crée le skill
.claude/skills/avant-commit/SKILL.md : les tests, le lint et ce subagent sur les fichiers
de la zone de préparation, et à la fin un tableau avec le verdict. Seul moi lance ce skill.
Ne modifie pas le code de l'application.La demande ne dit pas seulement ce que le relecteur doit faire, mais aussi ce qui lui est interdit. La dernière phrase protège contre le "tant que j'y étais, j'ai corrigé".
Ce que Claude a écrit : le relecteur
Ouvre .claude/agents/security-reviewer.md dans Cursor. En haut se trouve le frontmatter, c'est-à-dire les réglages de l'agent :
---
name: security-reviewer
description: Relecteur de sécurité des routes d'API de Treasure Map. À utiliser avant chaque commit qui modifie des fichiers de app/api ou lib/session.ts. Il reçoit la liste des fichiers et ne fait que lire le code.
tools: Read, Grep, Glob
model: sonnet
---description dit à Claude quand déléguer, donc des dossiers précis marchent mieux que "relit le code". tools est la liste des outils autorisés. Si tu omets le champ, l'agent reçoit tous les outils de la conversation, et disallowedTools: Write, Edit lui laisse Bash et les outils MCP, donc pour un relecteur tu choisis une liste courte. model: sonnet prend le modèle moins cher pour la routine. Sans ce champ, le subagent travaille sur le modèle de la conversation, et la documentation ajoute que Claude peut indiquer un autre modèle à l'appel. Sous le frontmatter se trouve le texte qui devient le prompt système de l'agent :
Tu es un relecteur de sécurité. Tu reçois la liste des fichiers modifiés.
Pour chaque route de app/api, vérifie :
1. si la route qui modifie des données appelle getCurrentUserId() et renvoie 401 sans session ;
2. si elle vérifie le propriétaire du tableau ou du pin et renvoie 403 pour les données d'un autre ;
3. si les données d'entrée passent par un schéma Zod ;
4. si la réponse d'erreur ne révèle pas de détails de la base.
Ne corrige rien. Réponds par une liste : fichier:ligne | problème | proposition.
Si tu ne trouves rien, écris : Rien à signaler.Le subagent ne voit pas ta conversation : il reçoit ce prompt et la tâche donnée par Claude. Les quatre questions sont le cœur de l'affaire, car la revue vérifie à chaque fois la même chose, quelle que soit la façon dont tu formules la demande aujourd'hui. Le format de réponse, tu le connais depuis la leçon 14_1, et chaque ligne, tu la compares au diff.
Ce que Claude a écrit : le skill /avant-commit
Voici maintenant .claude/skills/avant-commit/SKILL.md. L'en-tête du skill a quatre champs :
---
name: avant-commit
description: Rapport avant commit : tests, lint et revue de sécurité des changements de la zone de préparation.
disable-model-invocation: true
allowed-tools: Bash(npm run test *) Bash(npm run lint)
---disable-model-invocation: true, tu le connais avec /deploy : seul toi lances le skill, et sa description n'occupe pas de place dans le contexte. allowed-tools approuve ces deux commandes sans question, mais seulement pendant le tour où le skill agit, et ne retire rien. La documentation ajoute un avertissement : Claude Code applique le allowed-tools d'un skill du dépôt même dans une exécution -p dans un dossier que tu n'as pas approuvé. Un skill dans le dépôt de quelqu'un d'autre, tu le lis donc comme un script. Sous l'en-tête viennent les étapes :
## Fichiers de la zone de préparation
!`git diff --cached --name-only`
## Étapes
1. Lance `npm run test -- --run` et note le résultat.
2. Lance `npm run lint` et note le résultat.
3. Donne au subagent security-reviewer la liste des fichiers de la zone de préparation.
4. Ne corrige rien. À la fin, affiche un tableau : tests, lint, revue, et dessous un verdict "prêt pour le commit" ou "à corriger" avec la liste des raisons.La ligne avec le point d'exclamation est une injection : Claude Code exécute la commande avant que Claude lise le skill, et colle son résultat à la place de la ligne. Ce n'est pas un ornement. Un relecteur avec Read, Grep, Glob ne lancera pas git diff lui-même, donc la liste des fichiers doit lui arriver dans la tâche. Les étapes ne s'arrêtent pas à la première erreur, car avant un commit tu veux le tableau complet.
L'essai : /avant-commit
Dans la session, tu tapes /avant-commit. Nous avons fait passer la même chose par claude -p "/avant-commit", avec lib/pinInput.ts de la leçon 14_1 dans la zone de préparation. Extrait du résultat :
| Tests | 3 échouent sur 64 |
| Lint | 2 erreurs |
| Revue de sécurité | 1 haute, 1 moyenne, 3 remarques basses |
Haute, ligne 9 : z.union([startsWith("/pins/"), z.url()]) laisse passer n'importe quelle URL
Verdict : à corrigerDans le JSON de l'exécution, le champ subagent_stats montrait un subagent lancé, de type security-reviewer. Le relecteur a trouvé la même faille que la revue rapide par pipe de la leçon 14_1, mais maintenant chaque membre de l'équipage la trouvera avec la même commande.
La revue du capitaine
- Les outils du relecteur. Le frontmatter ne contient que
Read, Grep, Glob. Une erreur typique de l'agent : il ajouteEditetWrite"au cas où, pour que le relecteur puisse corriger tout de suite". Alors le relecteur modifie en cachette du code dont tu n'as pas lu le diff, et la revue cesse d'être indépendante. Tu le reconnais à la lignetools, ou à son absence. - Une description avec une condition.
descriptiondit quand utiliser l'agent. Sans cela, Claude ne le sortira pas de lui-même, et tu devras l'appeler par son nom. - Qui lance le skill.
disable-model-invocation: truedoit être là, car le rapport se termine par une décision de commit. - La vérification. Tape
@et choisis le relecteur dans les suggestions, et/skillsmontrera le skill dans la liste. Un dossier.claude/agents/créé en cours de session demande de relancer la session, et un nouveau.claude/skills/la commande/reload-skills, comme dans la leçon 6_1.
Les plugins : l'équipage dans un seul coffre
Les fichiers de .claude/agents/ et de .claude/skills/ voyagent avec le dépôt Treasure Map. Et si tu veux le même relecteur dans le clone de Spotify ? Un plugin est un dossier avec des skills, des agents, des hooks et des serveurs MCP, que Claude Code installe et charge comme un tout. Les plugins des autres, tu les parcours avec la commande /plugin : l'onglet Discover montre les plugins de tes marketplaces, c'est-à-dire des catalogues de plugins. Le marketplace officiel d'Anthropic, claude-plugins-official, Claude Code l'ajoute tout seul à la première session dans le terminal. L'installation commence par un aperçu :
/plugin install commit-commands@claude-plugins-officialDans une session, cette commande n'installe encore rien : elle ouvre le détail avec la liste de ce que le plugin va ajouter, et demande la portée. La portée du projet enregistre le plugin dans .claude/settings.json, mais chaque membre de l'équipage l'installe quand même chez lui. Un plugin agit avec tes permissions, donc tu le lis comme n'importe quel code d'un autre.
Ton propre équipage, tu l'emballes de la même façon. La documentation décrit comment déplacer un dossier .claude/ prêt dans un plugin de cette disposition :
treasure-crew/
├── .claude-plugin/plugin.json # nom et description du plugin
├── agents/security-reviewer.md
└── skills/avant-commit/SKILL.mdclaude plugin validate ./treasure-crew vérifie le manifeste et les frontmatters, et claude --plugin-dir ./treasure-crew charge le plugin pour une session. Le skill reçoit alors un préfixe : /treasure-crew:avant-commit. Deux différences méritent d'être connues. Le subagent d'un plugin ignore les champs hooks, mcpServers et permissionMode, et chaque plugin activé apporte à chaque tour les descriptions de ses skills et de ses agents, même quand tu ne t'en sers pas. Je te recommande une règle simple : un projet, c'est .claude/ dans le dépôt ; plusieurs projets, c'est un plugin.
MCP pour l'équipage
Les serveurs MCP pour tout l'équipage, tu les connais déjà : dans la leçon 11_4, --scope project a enregistré Sentry dans .mcp.json, et dans la leçon 13_7 tu as ajouté Supabase en lecture seule et une règle ask sur mcp__supabase__*. Ajoutes-y une chose : dans .mcp.json, tu peux écrire ${API_KEY} à la place d'un jeton, et Claude Code substituera la variable d'environnement de l'ordinateur de chaque marin, donc le secret n'entre pas dans le dépôt. Le conseil de la leçon 11_4 vaut toujours : quand un système a un CLI, par exemple gh pour GitHub, commence par lui, et garde MCP pour les systèmes sans CLI.
Étape suivante
Ajoute à la procédure la vérification des types :
Ajoute au skill /avant-commit une étape npx tsc --noEmit avant le lint
et ajoute Bash(npx tsc --noEmit) à allowed-tools. Ne modifie pas le relecteur.Relance /avant-commit et demande un commit, par exemple "Relecteur de sécurité et skill avant-commit". Dans l'éditeur à côté, tu colleras le frontmatter d'un subagent ou d'un skill et tu verras ce que Claude Code ne chargera pas, quels outils recevra le relecteur et qui peut lancer le skill.
N'oublie pas : tu recrutes l'équipage une seule fois, et la procédure travaille à chaque traversée.
Code de cette leçon : App.tsx
// Contrôle du frontmatter : ce que Claude Code fera d’un fichier de subagent ou de skill
import { useState } from 'react';
export type Kind = 'agent' | 'skill';
export type Level = 'ok' | 'warn' | 'error';
export interface Finding {
level: Level;
text: string;
}
export interface Parsed {
hasFrontmatter: boolean;
fields: Record<string, string>;
body: string;
}
const BT = String.fromCharCode(96);
export function parseFrontmatter(src: string): Parsed {
const lines = src.split('\n');
if (lines[0] !== '---') return { hasFrontmatter: false, fields: {}, body: src };
const end = lines.findIndex((l, i) => i > 0 && l.trim() === '---');
if (end === -1) return { hasFrontmatter: false, fields: {}, body: src };
const fields: Record<string, string> = {};
for (const line of lines.slice(1, end)) {
const m = /^([A-Za-z_-]+):\s*(.*)$/.exec(line);
if (m) fields[m[1]] = m[2].trim();
}
return { hasFrontmatter: true, fields, body: lines.slice(end + 1).join('\n') };
}
export function toolList(value: string | undefined): string[] {
if (!value) return [];
return value.split(/[,\s]+/).filter(Boolean);
}
const AGENT_FIELDS = ['name', 'description', 'tools', 'disallowedTools', 'model', 'permissionMode', 'maxTurns', 'skills', 'mcpServers', 'hooks', 'memory', 'background', 'effort', 'isolation', 'color'];
const MODELS = ['sonnet', 'opus', 'haiku', 'fable', 'inherit'];
const WRITERS = ['Edit', 'Write', 'Bash', 'NotebookEdit'];
export function checkAgent(p: Parsed): Finding[] {
const f = p.fields;
const out: Finding[] = [];
if (!p.hasFrontmatter || !f.name) {
return [{ level: 'error', text: 'Sans name (ou sans --- à la première ligne), Claude Code prend le fichier pour de la documentation et l’ignore.' }];
}
if (f.name.includes(':')) out.push({ level: 'error', text: 'name ne peut pas contenir de deux-points : ils sont réservés aux plugins.' });
if (!f.description) {
out.push({ level: 'error', text: 'Il y a un name mais pas de description : Claude Code ignore le fichier et note la raison dans le journal --debug.' });
} else if (!/utilis|use /i.test(f.description)) {
out.push({ level: 'warn', text: 'description ne dit pas quand utiliser l’agent. Claude délègue d’après cette description.' });
} else {
out.push({ level: 'ok', text: 'description dit quand déléguer.' });
}
const tools = toolList(f.tools);
if (!f.tools && f.disallowedTools) {
out.push({ level: 'warn', text: 'disallowedTools sans tools : l’agent hérite des autres outils, y compris Bash et MCP.' });
} else if (!f.tools) {
out.push({ level: 'warn', text: 'Pas de tools : l’agent reçoit tous les outils de la conversation, y compris Edit, Write et Bash.' });
} else {
const writers = tools.filter((t) => WRITERS.includes(t));
out.push(
writers.length
? { level: 'warn', text: 'Un relecteur avec ' + writers.join(', ') + ' peut modifier le code ou lancer des commandes. Pour une revue, Read, Grep, Glob suffisent.' }
: { level: 'ok', text: 'Il ne fait que lire (' + tools.join(', ') + '). La liste des fichiers doit lui arriver dans la tâche, car il ne lancera pas git diff.' },
);
}
if (f.model) {
const known = MODELS.includes(f.model) || f.model.startsWith('claude-');
out.push(known ? { level: 'ok', text: 'model: ' + f.model + '.' } : { level: 'warn', text: 'Modèle inconnu "' + f.model + '".' });
}
for (const key of Object.keys(f)) {
if (!AGENT_FIELDS.includes(key)) {
out.push({ level: 'warn', text: 'Le champ ' + key + ' n’existe pas dans un agent ; Claude Code l’ignore sans erreur (les champs d’agent s’écrivent en camelCase).' });
}
}
return out;
}
const SKILL_FIELDS = ['name', 'description', 'when_to_use', 'argument-hint', 'arguments', 'disable-model-invocation', 'user-invocable', 'allowed-tools', 'disallowed-tools', 'model', 'effort', 'context', 'agent', 'background', 'hooks', 'paths', 'shell'];
export function checkSkill(p: Parsed): Finding[] {
const f = p.fields;
const out: Finding[] = [];
if (!p.hasFrontmatter) {
return [{ level: 'warn', text: 'Sans --- à la première ligne, tout le fichier est du contenu et le skill n’a aucun champ.' }];
}
out.push(
f.description
? { level: 'ok', text: 'description est présente ; c’est elle qui dit à Claude à quoi sert le skill.' }
: { level: 'warn', text: 'Pas de description : Claude prendra la première ligne du contenu.' },
);
const sideEffects = /commit|deploy|déploi|push|npm run/i.test(p.body);
if (f['disable-model-invocation'] === 'true') {
out.push({ level: 'ok', text: 'Seul toi lances le skill ; sa description n’occupe pas de place dans le contexte.' });
} else if (sideEffects) {
out.push({ level: 'warn', text: 'Les étapes ont des effets de bord, et Claude peut lancer le skill tout seul. Ajoute disable-model-invocation: true.' });
}
if (f['allowed-tools']) {
out.push({ level: 'ok', text: 'allowed-tools approuve ' + f['allowed-tools'] + ' seulement pendant le tour du skill et ne retire rien. Dans le dépôt d’un autre, lis cette ligne avec attention.' });
}
const injected = p.body.split('\n').filter((l) => l.startsWith('!' + BT));
for (const line of injected) {
out.push({ level: 'ok', text: 'Injection : ' + line.slice(2, -1) + ' s’exécutera avant que Claude lise le skill, et son résultat remplacera la ligne.' });
}
for (const key of Object.keys(f)) {
if (!SKILL_FIELDS.includes(key)) {
out.push({ level: 'warn', text: 'Le champ ' + key + ' n’existe pas dans un skill ; Claude Code l’ignore sans erreur (les champs de skill s’écrivent avec des tirets).' });
}
}
return out;
}
export const SAMPLES: Record<string, { kind: Kind; text: string }> = {
'Relecteur en lecture seule': {
kind: 'agent',
text: [
'---',
'name: security-reviewer',
'description: Relecteur de sécurité des routes d’API. À utiliser avant chaque commit qui modifie app/api.',
'tools: Read, Grep, Glob',
'model: sonnet',
'---',
'Vérifie la session, le propriétaire des données et le schéma Zod. Ne corrige rien.',
].join('\n'),
},
'Relecteur au cas où': {
kind: 'agent',
text: [
'---',
'name: security-reviewer',
'description: Relit le code.',
'tools: Read, Grep, Glob, Edit, Write',
'disallowed-tools: Bash',
'---',
'Vérifie les routes et corrige tout de suite ce que tu trouves.',
].join('\n'),
},
'Skill avant-commit': {
kind: 'skill',
text: [
'---',
'name: avant-commit',
'description: Rapport avant commit : tests, lint et revue de sécurité.',
'disable-model-invocation: true',
'allowed-tools: Bash(npm run test *) Bash(npm run lint)',
'---',
'## Fichiers de la zone de préparation',
'!' + BT + 'git diff --cached --name-only' + BT,
'1. Lance npm run test -- --run.',
'2. Donne la liste des fichiers au subagent security-reviewer.',
].join('\n'),
},
'Skill sans verrou': {
kind: 'skill',
text: [
'---',
'name: avant-commit',
'disableModelInvocation: true',
'---',
'Lance les tests et fais un commit s’ils passent.',
].join('\n'),
},
};
const LEVEL_CLASS: Record<Level, string> = {
ok: 'text-emerald-400',
warn: 'text-amber-400',
error: 'text-rose-400',
};
export default function App() {
const names = Object.keys(SAMPLES);
const [kind, setKind] = useState<Kind>(SAMPLES[names[0]].kind);
const [text, setText] = useState(SAMPLES[names[0]].text);
const parsed = parseFrontmatter(text);
const findings = kind === 'agent' ? checkAgent(parsed) : checkSkill(parsed);
return (
<div className="min-h-screen space-y-4 bg-slate-950 p-4 text-slate-100">
<h1 className="text-xl font-bold">Contrôle de l’équipage : subagent et skill</h1>
<div className="flex flex-wrap gap-2">
{names.map((n) => (
<button
key={n}
type="button"
className="rounded bg-slate-700 px-3 py-1 text-sm"
onClick={() => {
setKind(SAMPLES[n].kind);
setText(SAMPLES[n].text);
}}
>
{n}
</button>
))}
</div>
<label className="block text-sm">
Type de fichier{' '}
<select className="rounded bg-slate-800 p-1" value={kind} onChange={(e) => setKind(e.target.value as Kind)}>
<option value="agent">.claude/agents/*.md</option>
<option value="skill">.claude/skills/*/SKILL.md</option>
</select>
</label>
<textarea
className="h-56 w-full rounded bg-slate-900 p-2 font-mono text-xs"
value={text}
onChange={(e) => setText(e.target.value)}
/>
<ul className="space-y-1 text-sm">
{findings.map((f, i) => (
<li key={i} className="rounded border border-slate-800 p-2">
<strong className={LEVEL_CLASS[f.level]}>{f.level}</strong> {f.text}
</li>
))}
</ul>
</div>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Le subagent security-reviewer ne doit que relire les routes d'API. Que mets-tu dans son frontmatter ?
2. Où enregistrer le subagent security-reviewer pour que chacun qui clone Treasure Map l'ait ?
Voici 2 des 4 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Tri horizontal
Compose la commande qui vérifie le manifeste et les frontmatters de ton plugin treasure-crew avant de le donner à l'équipage :