Навыки caveman-compress

caveman-compress

Низкий риск ⚙️ Внешние команды🔑 Переменные окружения

Сжимайте файлы памяти для снижения затрат на токены

Большие файлы п��мяти, такие как CLAUDE.md, впустую тратят токены при каждом запуске AI-сессии. Этот навык сжимает их примерно на 46 процентов, сохраняя всё техническое содержимое нетронутым.

Поддерживает: Claude Codex Code(CC)
🥉 75 Бронза
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «caveman-compress». Файл CLAUDE.md на 706 токенов с предпочтениями TypeScript, руководствами по тестированию и соглашениями проекта, написанными в полной прозе.

Ожидаемый результат:

Сжатая версия на 285 токенов, сохраняющая вс�� технические инструкции в прямой прозе в стиле пещерного человека. Заголовки, примеры кода и URL-адреса остаются неизменными. Оригинал сохранён как CLAUDE.original.md.

Использование «caveman-compress». Файл заметок проекта на 1145 токенов с описаниями архитектуры, шагами развёртывания и командными соглашениями.

Ожидаемый результат:

Сжатый файл на 535 токенов. Все заголовки разделов сохранены точно. Блоки кода и URL-адреса нетрону��ы. Избыточные объяснения уплотнены до основных фактов. Резервная копия сохранена как 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
Соответствие спецификации

Что вы можете построить

Снизьте повторяющиеся затраты на сессии

Сожмите файл памяти проекта CLAUDE.md один раз. Меньший файл загружается при каждом запуске сессии, экономя токены каждый раз, когда вы работаете с AI.

Оптимизируйте документацию команды

Сжимайте общие файлы предпочтений, руководства по стилю и соглашения проекта. Участники команды получают те же инструкции с меньшим количеством входных токенов за сессию.

Уплотняйте долгосрочные заметки проекта

Сжимайте накопленные списки задач, протоколы встреч и журналы решений в основные факты. Сохраняйте всю информацию без многословных излишеств.

Попробуйте эти промпты

Сожмите один файл
Сожмите файл CLAUDE.md в формат пещерного человека.
Сожмите несколько файлов предпочтений
Сожмите эти файлы памяти: CLAUDE.md, todos.md и preferences.txt.
Пересожмите после редактирования
Я обновил CLAUDE.original.md с новыми ста��дартами кодирования. Сожмите его снова, чтобы заменить CLAUDE.md.
Сожмите с кастомной моделью
Установите CAVEMAN_MODEL в claude-haiku и сожмите CLAUDE.md.

Лучшие практики

  • Редактируйте резервный файл .original.md, затем пересжимайте. Это сохраняет ваш источник истины в читаемом формате.
  • Запускайте сжатие после крупных обновлений файлов памяти. Свежие правки часто добавляют многословные объяснения, которые хорошо сжимаются.
  • Проверяйте сжатый вывод перед использованием. Проверка контролирует техническое содержимое, но изменения стиля могут повлиять на нюансы.

Избегать

  • Не сжимайте файлы кода, файлы конфигурации или любые файлы с преимущественным содержанием кода. Инструмент автоматически пропустит их.
  • Не удаляйте резервную копию .original.md. Это ваш читаемый источник и точка восстановления.
  • Не запускайте сжатие повторно на неизменённых файлах. Каждый запуск потребляет токены API. Сжимайте только после содержательных правок.

Часто задаваемые вопросы

Что происходит с моим исходным файлом?
Ваш исходный файл перезаписывается сжатой версией. Перед этим создаётся резервная копия с расширением .original.md. Вы всегда можете прочитать или от��едактировать резервную копию.
Могу ли я сжимать файлы, отличные от CLAUDE.md?
Да. Любой файл markdown (.md), обычный текст (.txt) или reStructuredText (.rst) подойдёт. Файлы без расширения, содержащие естественный язык, также поддерживаются. Файлы кода и конфигурации пропускаются автоматически.
Потеряет ли сжатие какую-либо техническую информацию?
Нет. Блоки кода, URL-адреса, пути к файлам, команды и технические термины сохраняются точно. Этап проверки проверяет заголовки, блоки кода, URL-адреса и структуру после сжатия. Если проверка не удаётся, инструмент повторяет с целевыми исправлениями.
Что если сжатие не удаётся или производит плохой вывод?
Инструмент повторяет до 2 раз с целевыми исправлениями. Если все повторные попытки не удались, ваш исходный файл восстанавливается и остаётся нетронутым. Резервная копия сохраняется только при успешном сжатии.
Сколько токенов экономит сжатие?
В среднем сохраняется около 46 процентов входных токенов. Отдельные файлы варьируются от 36 до 60 процентов экономии в зависимости от того, насколько многословен исходный текст.
Нужен ли мне ключ API Anthropic для использования этого навыка?
Да, либо ANTHROPIC_API_KEY, установленная в вашей среде, либо claude CLI, установленный с настроенной десктопной аутентификацией. На��ык использует любой доступный вариант.

Сведения для разработчиков

Автор

juliusbrussee

Лицензия

MIT

Ссылка

main

Структура файлов