المهارات caveman-compress

caveman-compress

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

Speicherdateien komprimieren, um Token-Kosten zu reduzieren

Große Speicherdateien wie CLAUDE.md verschwenden bei jedem Start einer KI-Sitzung Tokens. Diese Fähigkeit komprimiert sie um etwa 46 Prozent, während der gesamte technische Inhalt erhalten bleibt.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "caveman-compress". Eine CLAUDE.md-Datei mit 706 Tokens mit TypeScript-Einstellungen, Testrichtlinien und Projektkonventionen in voller Prosa.

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

Eine komprimierte Version mit 285 Tokens, die alle technischen Anweisungen in direkter Caveman-Prosa beibehält. Überschriften, Codebeispiele und URLs bleiben unverändert. Original als CLAUDE.original.md gespeichert.

استخدام "caveman-compress". Eine Projektnotizendatei mit 1145 Tokens mit Architekturbeschreibungen, Bereitstellungsschritten und Teamkonventionen.

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

Eine komprimierte Datei mit 535 Tokens. Alle Abschnittsüberschriften exakt beibehalten. Codeblöcke und URLs intakt. Redundante Erklärungen auf wesentliche Fakten verdichtet. Backup als project-notes.original.md gespeichert.

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

مخاطر منخفضة
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
الامتثال للمواصفات

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

Wiederkehrende Sitzungskosten reduzieren

Komprimieren Sie Ihre CLAUDE.md-Projektspeicherdatei einmal. Die kleinere Datei wird bei jedem Sitzungsstart geladen und spart jedes Mal Tokens, wenn Sie mit KI arbeiten.

Team-Dokumentation optimieren

Komprimieren Sie gemeinsam genutzte Präferenzdateien, Style Guides und Projektkonventionen. Teammitglieder erhalten dieselben Anweisungen mit weniger Input-Tokens pro Sitzung.

Langzeit-Projektnotizen verdichten

Komprimieren Sie angesammelte Todo-Listen, Meeting-Notizen und Entscheidungsprotokolle auf das Wesentliche. Behalten Sie alle Informationen ohne den ausführlichen Overhead.

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

Einzelne Datei komprimieren
Compress the file at CLAUDE.md into caveman format.
Mehrere Präferenzdateien komprimieren
Compress these memory files: CLAUDE.md, todos.md, and preferences.txt.
Nach Bearbeitung erneut komprimieren
I updated CLAUDE.original.md with new coding standards. Compress it again to replace CLAUDE.md.
Mit benutzerdefiniertem Modell komprimieren
Set CAVEMAN_MODEL to claude-haiku and compress CLAUDE.md.

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

  • Bearbeiten Sie die .original.md-Backup-Datei und komprimieren Sie anschließend neu. So bleibt Ihre vertrauenswürdige Quelle im menschenlesbaren Format.
  • Führen Sie die Komprimierung nach größeren Aktualisierungen der Speicherdateien durch. Frische Bearbeitungen fügen oft ausführliche Erklärungen hinzu, die sich gut komprimieren lassen.
  • Überprüfen Sie die komprimierte Ausgabe, bevor Sie sich darauf verlassen. Die Validierung prüft technische Inhalte, aber Stiländerungen können Nuancen beeinflussen.

تجنب

  • Komprimieren Sie keine Codedateien, Konfigurationsdateien oder Dateien mit hauptsächlich Code-Inhalten. Das Tool überspringt diese automatisch.
  • Löschen Sie nicht das .original.md-Backup. Es ist Ihre menschenlesbare Quelle und Ihr Wiederherstellungspunkt.
  • Führen Sie die Komprimierung nicht wiederholt auf unveränderten Dateien aus. Jeder Durchlauf verbraucht API-Tokens. Komprimieren Sie nur nach bedeutenden Bearbeitungen.

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

Was passiert mit meiner Originaldatei?
Ihre Originaldatei wird mit der komprimierten Version überschrieben. Zuvor wird ein Backup mit der Erweiterung .original.md gespeichert. Sie können das Backup jederzeit lesen oder bearbeiten.
Kann ich auch andere Dateien als CLAUDE.md komprimieren?
Ja. Jede Markdown-Datei (.md), Textdatei (.txt) oder reStructuredText-Datei (.rst) funktioniert. Erweiterungslose Dateien, die natürliche Sprache enthalten, werden ebenfalls unterstützt. Code- und Konfigurationsdateien werden automatisch übersprungen.
Verliert die Komprimierung technische Informationen?
Nein. Codeblöcke, URLs, Dateipfade, Befehle und technische Begriffe werden exakt beibehalten. Der Validierungsschritt prüft Überschriften, Codeblöcke, URLs und Struktur nach der Komprimierung. Wenn die Validierung fehlschlägt, wiederholt das Tool den Vorgang mit gezielten Korrekturen.
Was passiert, wenn die Komprimierung fehlschlägt oder eine schlechte Ausgabe erzeugt?
Das Tool wiederholt den Vorgang bis zu 2 Mal mit gezielten Korrekturen. Wenn alle Wiederholungen fehlschlagen, wird Ihre Originaldatei wiederhergestellt und bleibt unberührt. Das Backup wird nur bei erfolgreicher Komprimierung beibehalten.
Wie viele Tokens spart die Komprimierung ein?
Im Durchschnitt werden etwa 46 Prozent der Input-Tokens eingespart. Einzelne Dateien reichen von 36 bis 60 Prozent Einsparung, je nachdem, wie ausführlich der Originaltext ist.
Benötige ich einen Anthropic API-Schlüssel, um diese Fähigkeit zu nutzen?
Ja, entweder ANTHROPIC_API_KEY in Ihrer Umgebung gesetzt oder die claude CLI installiert mit konfigurierter Desktop-Authentifizierung. Die Fähigkeit verwendet je nach Verfügbarkeit eine der beiden Optionen.

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

المؤلف

juliusbrussee

الترخيص

MIT

مرجع

main

بنية الملفات