caveman

Présentation de caveman skill

Ce que fait caveman

caveman est un style de réponse ultra-compressé pour assistants IA. Il supprime le remplissage, les formules de politesse, les articles, les précautions faibles et les tournures trop longues, tout en préservant l’exactitude technique, le code, les erreurs citées et les concepts nommés. Cas d’usage idéal : utilisateurs qui veulent des réponses d’ingénierie denses, moins de tokens, une lecture plus rapide, ou un « mode bref » persistant sur toute une conversation.

Le vrai objectif : réduire la taille des réponses de l’assistant sans les rendre floues. Le skill upstream vise environ 75 % de réduction de tokens en modifiant la forme des réponses, pas en supprimant la substance.

Utilisateurs et workflows les mieux adaptés

Utilisez caveman quand vous connaissez déjà le domaine et voulez des réponses directes : notes de code review, options d’implémentation, hypothèses de debug, rappels CLI, synthèses de compromis d’architecture ou points d’avancement compacts. Il est particulièrement utile dans les longues sessions Claude, où le style normal de l’assistant tend à revenir vers une prose polie et trop expliquée.

Ce caveman skill est aussi utile pour la réécriture : collez un texte verbeux et demandez une compression caveman en conservant inchangés les commandes, noms d’API, messages d’erreur et blocs de code.

Ce qui distingue ce caveman skill

Au-delà du SKILL.md principal, ce repo inclut des outils de validation pratiques :

• scripts/caveman_compressor.py applique une compression à base de règles sans appels LLM.
• scripts/caveman_lint.py détecte le remplissage interdit, les précautions faibles, les politesses et les tournures verbeuses.
• scripts/token_savings_estimator.py estime les économies de tokens et de coût.
• references/when_caveman_backfires.md documente les situations où il faut suspendre la compression.

Ce support rend le caveman skill plus installable qu’un simple prompt « sois concis », car il définit la persistance, la gestion des exceptions et des contrôles de sortie mesurables.

Comment utiliser caveman skill

Installation de caveman et fichiers à lire en premier

Installez avec :

npx skills add alirezarezvani/claude-skills --skill caveman

Puis inspectez le dossier du skill :

engineering/caveman/skills/caveman

Lisez dans cet ordre :

1. SKILL.md — phrases d’activation, règle de persistance, style de compression.
2. references/compression_principles.md — ce qu’il faut couper vs ce qui doit rester.
3. references/when_caveman_backfires.md — exceptions liées à la sécurité et à la clarté.
4. references/companion_tooling.md — utilisation des scripts et workflow de validation.
5. scripts/caveman_lint.py — catégories exactes de vocabulaire interdit.

Cet ordre aide à comprendre à la fois le comportement et les limites avant de s’en servir dans des conversations de production.

Comment invoquer caveman en pratique

Déclenchez-le naturellement avec des phrases comme :

• “Use caveman.”
• “Caveman mode.”
• “Be brief, less tokens.”
• “Rewrite this in caveman style.”
• /caveman

Comportement important : une fois déclenché, caveman persiste d’une réponse à l’autre jusqu’à ce que vous disiez “stop caveman” ou “normal mode.” C’est utile pour toute une session de debug, mais risqué si vous oubliez qu’il est actif avant de demander des instructions nuancées.

Exemple de prompt solide :

Use caveman. Review this migration plan. Keep SQL, table names, and rollback commands exact. Compress commentary. If any step is destructive, drop caveman for that warning only.

Pourquoi c’est mieux : le prompt indique au skill ce qu’il doit préserver et tient compte de l’exception automatique de clarté.

Entrées qui améliorent les sorties caveman

Donnez à caveman des règles de préservation claires. Il compresse le langage, pas les exigences. Entrées utiles :

• Format cible : puces, notes de diff, checklist, commit message, résumé d’incident.
• Éléments à préserver : blocs de code, stack traces, noms d’API, texte légal, erreurs citées.
• Public : ingénieur senior, PM, personne d’astreinte, débutant.
• Niveau de risque : résumé sans danger vs action irréversible.

Prompt faible :

Make this shorter.

Meilleur prompt :

Caveman for Rewriting. Compress this support reply to half length. Preserve exact error text, URLs, CLI commands, and refund policy wording. Remove pleasantries and hedging.

Utiliser les scripts compagnons

Les scripts sont en Python stdlib-only et peuvent être exécutés directement depuis le dossier du skill.

Compresser du texte :

python scripts/caveman_compressor.py --file input.txt

Linter une réponse :

python scripts/caveman_lint.py --file response.txt --output json

Estimer les économies :

python scripts/token_savings_estimator.py --file input.txt --price-per-mtok 3.00

Ces outils sont utiles quand vous voulez une compression répétable hors chat, ou quand vous voulez vérifier qu’une réponse IA a réellement suivi les règles caveman au lieu d’être simplement « courte ».

FAQ de caveman skill

caveman est-il seulement un style d’écriture amusant ?

Non. La voix “smart caveman” est un mécanisme de compression : fragments, articles supprimés, synonymes courts, flèches pour la causalité et moins de tokens sociaux. Le skill n’a pas pour but de rendre le contenu technique primitif. Les termes techniques exacts restent.

Quand ne faut-il pas utiliser caveman ?

Évitez caveman, ou mettez-le temporairement en pause, pour les avertissements de sécurité, les confirmations irréversibles, les contenus juridiques ou médicaux à fort enjeu, ou les séquences en plusieurs étapes où des fragments trop brefs pourraient faire mal comprendre l’ordre. La référence du repo sur les cas où caveman se retourne contre l’usage signale explicitement les opérations destructrices et les demandes de clarification comme zones d’exception.

Bon modèle :

Use caveman, except write full warnings for destructive commands.

En quoi caveman est-il meilleur que « sois concis » ?

« Sois concis » est trop vague et se dégrade souvent après quelques tours. Le caveman skill définit une activation persistante, des règles concrètes de suppression, des schémas d’abréviation, la préservation du code et des cas d’exception. Le linter inclus donne aussi un moyen de tester la conformité au lieu de faire confiance à l’auto-évaluation du modèle.

caveman convient-il aux débutants ?

Oui, mais seulement si le débutant demande des exceptions de clarté. Un caveman pur peut retirer les liens explicatifs dont les débutants ont besoin. Pour apprendre, utilisez :

Use caveman for summary bullets, but explain new concepts normally first.

Cela conserve les économies de tokens sans transformer un sujet inconnu en fragments cryptiques.

Comment améliorer caveman skill

Faire préserver à caveman ce qui compte

Les meilleurs résultats viennent quand vous nommez ce qui ne doit pas être compressé. Dites à l’assistant de garder exactement :

• Blocs de code et code inline
• Messages d’erreur
• Avertissements de sécurité
• Procédures ordonnées
• Noms d’API, de package, de classe, de table et de champ
• Formulations juridiques, tarifaires ou de politique

La compression doit retirer le superflu autour de la substance, pas modifier la substance elle-même.

Modes d’échec courants à surveiller

Surveillez quatre problèmes :

1. Surcompression : la réponse devient ambiguë.
2. Sous-compression : l’assistant conserve des politesses et du remplissage.
3. Compression dangereuse : les avertissements ou étapes destructrices deviennent trop laconiques.
4. Dégradation du format : code, commandes ou citations sont altérés.

Utilisez scripts/caveman_lint.py pour la sous-compression. Utilisez une revue humaine pour l’ambiguïté et la sécurité, car un linter ne peut pas toujours savoir quand un contexte manquant change le sens.

Itérer après la première sortie

Après la première sortie caveman, affinez avec des consignes ciblées au lieu de demander une nouvelle tentative générique :

• “More compressed, keep all command flags.”
• “Restore full sentence for warning only.”
• “Use numbered steps; order matters.”
• “Remove hedging unless evidence-backed.”
• “Keep acronyms expanded on first use.”

Cela garde l’usage de caveman sous contrôle : compact quand c’est sûr, explicite quand c’est nécessaire.

Étendre caveman aux standards d’équipe

Si vous utilisez caveman en équipe, ajoutez des règles locales à côté du skill : abréviations approuvées, domaines où caveman est interdit, formats de sortie préférés et exemples de compression acceptable. Exécutez le compresseur et l’estimateur de tokens sur de vrais documents d’équipe avant adoption, afin de savoir si les économies justifient le compromis de lisibilité.