FlorianBruniaux/claude-code-ultimate-guide

Ajoute de la prose descriptive aux sections nues des livres blancs (FR + EN) à l’aide de 9 agents parallèles.

Qu'est-ce que claude-code-ultimate-guide ?

Cette compétence automatise l’enrichissement des livres blancs techniques (whitepapers) en détectant et en complétant les sections « nues » – c’est-à-dire les titres immédiatement suivis d’un tableau, d’un bloc de code ou d’une liste, sans paragraphe d’introduction. Elle est conçue pour l’écosystème Codex (v3.27.6) et exploite jusqu’à 9 agents parallèles afin de traiter simultanément les paires FR/EN des documents allant de 00 à 08. Chaque agent reçoit un prompt strict qui lui interdit d’inventer des métriques, d’ajouter des callouts ou de terminer un paragraphe par « : » avant une liste (bug Typst). L’utilisateur peut cibler un ou plusieurs whitepapers spécifiques, ou lancer le traitement complet. Le résultat est une prose naturelle de 2 à 4 phrases par section manquante, basée sur le contexte du guide de référence et du fichier `reference.yaml`. Une vérification post‑traitement contrôle le delta de lignes, les versions, et relance la compilation Quarto.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.agents/skills/source-command-audit-prose

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

source-command-audit-prose

Utilisez cette compétence lorsque l'utilisateur demande d'exécuter la commande source migrée audit-prose.

Modèle de commande

Audit Prose — Enrichissement des Sections Nues

Ajoute de la prose descriptive (2-4 phrases) devant chaque section « nue » des livres blancs. Une section « nue » = en-tête suivi directement d'un tableau, d'un bloc de code ou d'une liste sans paragraphe d'introduction.

Utilisation

/audit-prose        # Tous les WPs (00-08), FR + EN
/audit-prose 07     # WP07 seulement (FR + EN)
/audit-prose 03 07  # WP03 et WP07 seulement

Définition « Section nue »

Section (## ou ###) suivie DIRECTEMENT par :

  • Un tableau Markdown (|)
  • Un bloc de code (```)
  • Une liste à puces (-) ou numérotée

Sans paragraphe d'introduction (minimum 2 phrases).

Règles strictes (non négociables)

  1. NE JAMAIS terminer un paragraphe par : avant une liste à puces → bogue Typst qui fusionne les puces en ligne
  2. NE PAS inventer de chiffres, de métriques ou de citations
  3. NE PAS ajouter de callouts (:::), de Mermaid ou de scénarios persona
  4. NE PAS dépasser +15 % de lignes par fichier
  5. Versions maintenues à 3.27.6
  6. Prose EN = anglais naturel, pas de traduction mot à mot du FR
  7. Chaque ajout = minimum 2 phrases, maximum 4 phrases

Exemple de transformation

AVANT :
### Codes de sortie
| Code | Signification |
|------|---------------|
| 0    | Autorisé      |

APRÈS :
### Codes de sortie
Les hooks communiquent avec Codex via des codes de sortie standardisés.
C'est le mécanisme qui permet de bloquer ou d'autoriser une action en temps réel,
sans intervention humaine.

| Code | Signification |
|------|---------------|
| 0    | Autorisé      |

Flux de travail : 9 agents parallèles

Sources de contexte

  • machine-readable/reference.yaml : mapping sujets → lignes du guide principal
  • guide/ultimate-guide.md : guide de référence (aux lignes indiquées dans reference.yaml)
  • Connaissance de Codex (v3.27.6, MCP, hooks, agent teams, etc.)

Mapping des WPs

#FREN~Sections nues
00whitepapers/fr/00-introduction-serie.qmdwhitepapers/en/00-series-introduction.qmd~10
01whitepapers/fr/01-prompts-efficaces.qmdwhitepapers/en/01-effective-prompts.qmd~14
02whitepapers/fr/02-personnalisation.qmdwhitepapers/en/02-customization.qmd~18
03whitepapers/fr/03-securite.qmdwhitepapers/en/03-security.qmd~20
04whitepapers/fr/04-architecture.qmdwhitepapers/en/04-architecture.qmd~14
05whitepapers/fr/05-equipe.qmdwhitepapers/en/05-team.qmd~20
06whitepapers/fr/06-privacy.qmdwhitepapers/en/06-privacy.qmd~12
07whitepapers/fr/07-guide-reference.qmdwhitepapers/en/07-reference-guide.qmd~36
08whitepapers/fr/08-agent-teams.qmdwhitepapers/en/08-agent-teams.qmd~16

Exécution

Si l'argument est un numéro de WP spécifique : lancer 1 agent pour cette paire FR/EN uniquement.

Si aucun argument (ou « all ») : créer une équipe audit-prose-{date} et lancer 9 agents en parallèle.

Pour chaque WP ciblé, lancer un agent avec ce prompt :

Tu es un éditeur technique senior. Ta mission : ajouter de la PROSE DESCRIPTIVE
aux sections « nues » du livre blanc [XX - Titre].

## Définition « section nue »
Section (## ou ###) suivie DIRECTEMENT par un tableau, un bloc de code ou une
liste à puces, SANS paragraphe d'introduction (2+ phrases).

## Ce que tu fais
Pour CHAQUE section nue identifiée :
1. Ajouter 2-4 phrases AVANT le contenu structuré
2. Chaque phrase apporte une INFO NOUVELLE : le pourquoi, le quand utiliser,
   les implications, le choix de conception ou le contexte pratique
3. PAS de reformulation de ce qui suit — COMPLÈTE avec du contexte manquant

## Sources de contexte
- `machine-readable/reference.yaml` : mapping complet sujets → guide principal
- Ta connaissance de Codex (v3.27.6, MCP, hooks, agent teams, etc.)

## Règles strictes
- NE PAS inventer de chiffres, de métriques ou de citations
- NE PAS ajouter de callouts (:::), de Mermaid ou de scénarios persona
- NE JAMAIS terminer un paragraphe par « : » avant une liste à puces (bogue Typst)
- NE PAS dépasser +15 % de lignes
- Garder les versions à 3.27.6
- Prose EN = anglais naturel, pas de traduction mot à mot
- Chaque ajout = minimum 2 phrases, maximum 4 phrases

## Processus
1. LIRE reference.yaml (sections pertinentes au WP)
2. LIRE le WP FR complet
3. IDENTIFIER toutes les sections nues
4. ÉDITER le fichier FR (outil Edit, section par section)
5. LIRE le WP EN complet
6. ÉDITER le fichier EN
7. VÉRIFIER : aucun paragraphe ne se termine par « : » avant une liste
8. Rapporter : sections traitées, delta de lignes FR/EN

Attente et rapport

Attendre les retours de tous les agents. Pour chaque WP terminé, afficher :

WP[XX] ✅ — [N] sections, +[X]% FR/EN

Arrêt

Quand tous les agents ont terminé, envoyer une demande d'arrêt à chacun, puis TeamDelete.

Vérification post-enrichissement

# 1. Delta de lignes (max +15 %)
for f in whitepapers/fr/*.qmd; do
  echo "$(wc -l < "$f") $(basename $f)"
done

# 2. Vérifier le bogue Typst : paragraphe se terminant par « : » suivi d'une liste
grep -n ':$' whitepapers/fr/*.qmd whitepapers/en/*.qmd | head -20

# 3. Versions intactes
grep "^version:" whitepapers/fr/*.qmd whitepapers/en/*.qmd

# 4. Reconstruire les PDF
for f in whitepapers/fr/*.qmd whitepapers/en/*.qmd; do
  quarto render "$f"
done

Budget de lignes par WP

WPBudget max FRBudget max EN
00+54 lignes+54 lignes
01+142 lignes+142 lignes
02+189 lignes+189 lignes
03+145 lignes+145 lignes
04+120 lignes+120 lignes
05+143 lignes+143 lignes
06+79 lignes+79 lignes
07+281 lignes+281 lignes
08+241 lignes+241 lignes

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Skills associés