المهارات caveman-compress

caveman-compress

مخاطر منخفضة ⚙️ الأوامر الخارجية🔑 متغيرات البيئة

Compresser les fichiers de mémoire pour réduire les coûts en tokens

Les gros fichiers de mémoire comme CLAUDE.md gaspillent des tokens à chaque démarrage de session IA. Cette skill les compresse d'environ 46 pour cent tout en conservant l'intégralité du contenu technique.

يدعم: Claude Codex Code(CC)
🥉 75 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "caveman-compress". Un fichier CLAUDE.md de 706 tokens avec des préférences TypeScript, des directives de test et des conventions de projet écrites en prose complète.

النتيجة المتوقعة:

Une version compressée de 285 tokens préservant toutes les instructions techniques en prose directe de style cavernicole. Les titres, exemples de code et URLs restent inchangés. L'original est sauvegardé sous CLAUDE.original.md.

استخدام "caveman-compress". Un fichier de notes de projet de 1145 tokens avec des descriptions d'architecture, des étapes de déploiement et des conventions d'équipe.

النتيجة المتوقعة:

Un fichier compressé de 535 tokens. Tous les titres de section préservés exactement. Les blocs de code et URLs intacts. Les explications redondantes condensées en faits essentiels. Sauvegarde enregistrée sous project-notes.original.md.

التدقيق الأمني

مخاطر منخفضة
v1 • 4/15/2026

Static analysis flagged 107 potential issues across 10 files with a risk score of 100/100. After semantic evaluation, all flagged patterns are false positives. The external_commands findings (74 locations) are primarily markdown backticks in documentation files misidentified as shell execution. The one real subprocess call in scripts/compress.py uses hardcoded arguments with stdin input and no shell interpolation. Network findings (2 locations) are static URLs in README.md documentation, not runtime requests. Filesystem findings (2 locations) are standard path resolution for a file-processing tool. Environment access findings (9 locations) are legitimate ANTHROPIC_API_KEY and CAVEMAN_MODEL configuration for API usage. The critical heuristic finding about code execution plus network plus credential access is a false positive describing the normal operation of an Anthropic API client. No prompt injection attempts, data exfiltration patterns, or malicious intent detected. The tool has appropriate safeguards including file size limits (500KB), automatic backups, and retry logic with rollback on failure.

10
الملفات التي تم فحصها
964
الأسطر التي تم تحليلها
5
النتائج
1
إجمالي عمليات التدقيق
مشكلات منخفضة المخاطر (3)
Subprocess CLI Call
The tool calls the claude CLI via subprocess.run as a fallback when ANTHROPIC_API_KEY is not set. Arguments are hardcoded and user content is passed via stdin, not shell arguments. This is a standard pattern for Claude CLI integration. The risk is minimal but warrants documentation.
Environment Variable Access for API Key
The tool reads ANTHROPIC_API_KEY from environment variables to authenticate with the Anthropic API. This is standard and expected behavior for API tooling. The key is used only for direct API calls to Anthropic, not transmitted elsewhere.
File Write to User-Specified Path
The tool writes compressed content back to the same file path the user specifies. A backup is created before overwriting. The path is resolved to an absolute path and validated for existence and size (max 500KB). No files outside the user-specified path are modified.

عوامل الخطر

⚙️ الأوامر الخارجية (1)
🔑 متغيرات البيئة (1)
تم تدقيقه بواسطة: claude

درجة الجودة

59
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
84
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

Réduire les coûts récurrents de session

Compressez votre fichier de mémoire de projet CLAUDE.md une fois. Le fichier plus petit se charge à chaque démarrage de session, ce qui permet d'économiser des tokens à chaque utilisation de l'IA.

Optimiser la documentation d'équipe

Compressez les fichiers de préférences partagés, les guides de style et les conventions de projet. Les membres de l'équipe reçoivent les mêmes instructions avec moins de tokens d'entrée par session.

Condenser les notes de projet à long terme

Compressez les listes de tâches accumulées, les notes de réunion et les journaux de décision en faits essentiels. Conservez toutes les informations sans la verbosité superflue.

جرّب هذه الموجهات

Compresser un seul fichier
Compress the file at CLAUDE.md into caveman format.
Compresser plusieurs fichiers de préférences
Compress these memory files: CLAUDE.md, todos.md, and preferences.txt.
Recompresser après modification
I updated CLAUDE.original.md with new coding standards. Compress it again to replace CLAUDE.md.
Compresser avec un modèle personnalisé
Set CAVEMAN_MODEL to claude-haiku and compress CLAUDE.md.

أفضل الممارسات

  • Modifiez le fichier de sauvegarde .original.md, puis recompressez. Cela garde votre source de vérité dans un format lisible par l'humain.
  • Exécutez la compression après des mises à jour majeures des fichiers de mémoire. Les nouvelles modifications ajoutent souvent des explications verbeuses qui se compressent bien.
  • Vérifiez la sortie compressée avant de vous y fier. Les contrôles de validation vérifient le contenu technique mais les changements de style peuvent affecter les nuances.

تجنب

  • Ne compressez pas les fichiers de code, les fichiers de configuration ou tout fichier contenant principalement du code. L'outil les ignorera automatiquement.
  • Ne supprimez pas la sauvegarde .original.md. C'est votre source lisible par l'humain et votre point de récupération.
  • N'exécutez pas la compression de manière répétée sur des fichiers inchangés. Chaque exécution consomme des tokens API. Compressez uniquement après des modifications significatives.

الأسئلة المتكررة

Que se passe-t-il avec mon fichier original ?
Votre fichier original est écrasé par la version compressée. Avant cela, une sauvegarde est enregistrée avec l'extension .original.md. Vous pouvez toujours lire ou modifier la sauvegarde.
Puis-je compresser des fichiers autres que CLAUDE.md ?
Oui. Tout fichier markdown (.md), texte brut (.txt) ou reStructuredText (.rst) fonctionne. Les fichiers sans extension contenant du langage naturel sont également pris en charge. Les fichiers de code et de configuration sont ignorés automatiquement.
La compression perd-elle des informations techniques ?
Non. Les blocs de code, URLs, chemins de fichiers, commandes et termes techniques sont préservés exactement. L'étape de validation vérifie les titres, blocs de code, URLs et la structure après la compression. Si la validation échoue, l'outil réessaie avec des correctifs ciblés.
Que se passe-t-il si la compression échoue ou produit une mauvaise sortie ?
L'outil réessaie jusqu'à 2 fois avec des correctifs ciblés. Si tous les réessais échouent, votre fichier original est restauré et laissé intact. La sauvegarde n'est conservée qu'en cas de compression réussie.
Combien de tokens la compression permet-elle d'économiser ?
En moyenne, environ 46 pour cent des tokens d'entrée sont économisés. Les fichiers individuels varient de 36 à 60 pour cent d'économies selon le degré de verbosité du texte original.
Ai-je besoin d'une clé API Anthropic pour utiliser cette skill ?
Oui, soit ANTHROPIC_API_KEY défini dans votre environnement, soit l'interface CLI claude installée avec l'authentification bureau configurée. La skill utilise whichever est disponible.

تفاصيل المطور

المؤلف

juliusbrussee

الترخيص

MIT

مرجع

main

بنية الملفات