capsule-compact — скилл для Claude Code: сжатие цепочек капсул
Скилл capsule-compact для Claude Code сжимает длинные цепочки контекстных капсул. Он запускается по запросу на компактирование или когда цепочка разрастается.
MIT ★ 26 обновлён 2026-11-16
npx skills add wrg32786/aigent-os --skill capsule-compact -a claude-codeЧто делает capsule-compact
Скилл запускает python3 daemons/capsule-compact.py <head_capsule_id> из корня хранилища и проходит по цепочке от указанной головной капсулы к родительским. Если капсул пять или больше, три самые старые сводятся в одну. Скрипт переставляет связи между капсулами и помечает сжатые записи полем compacted_into.
Сводка собирается из структурированных полей: цели, незакрытых тем и принятых решений. LLM не вызывается, а исходные капсулы остаются на диске. Скрипт не обрабатывает ветвления и не запускается автоматически при /close: этот шаг лишь сообщает длину цепочки. Порог и число капсул для сводки меняются флагами --threshold N и --summarize-count N. Для запуска нужен python3.
Какие задачи решает
- сжать длинную цепочку контекстных капсул
- объединить старые капсулы в сводку
- перестроить связи после компактирования цепочки
- сохранить исходные капсулы с отметкой о сводке
Примеры запросов агенту
- Сожми цепочку капсул от
head_capsule_id. - Компактируй длинную цепочку капсул.
- Собери сводку из трёх старых капсул при пороге в пять.
Как установить capsule-compact
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill capsule-compact -a claude-code2Вручную: положить файлы
~/.claude/skills/capsule-compact/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/capsule-compact/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill capsule-compact -a codex2Вручную: положить файлы
.agents/skills/capsule-compact/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill capsule-compact -a cursor2Вручную: положить файлы
.cursor/skills/capsule-compact/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/capsule-compact2Вручную: положить файлы
.github/skills/capsule-compact/SKILL.md1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill capsule-compact -a gemini-cli2Командой платформы
gemini skills install https://github.com/wrg32786/aigent-os --path skills/capsule-compactВручную: положить файлы
.devin/skills/capsule-compact/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill capsule-compact -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о capsule-compact
Как установить capsule-compact в Claude Code?
Выполни npx skills add wrg32786/aigent-os --skill capsule-compact -a claude-code. Файл скилла появится по пути ~/.claude/skills/capsule-compact/SKILL.md.
Что делает capsule-compact?
При цепочке от пяти капсул скилл объединяет три самые старые в структурированную сводку и обновляет связи. Исходные записи остаются на диске с отметкой compacted_into.
Что нужно для работы capsule-compact?
Нужен python3. Скрипт запускается из корня хранилища командой python3 daemons/capsule-compact.py <head_capsule_id>.
Исходный текст
SKILL.md · MIT
--- name: capsule-compact agent: none description: "Compact capsule chains by summarizing older capsules. Use when manually compacting capsules or a context chain grows too long." allowed-tools: Bash, Read user-invocable: true triggers: - capsule compact - compact chain - chain compaction - compact capsules - /capsule-compact - chain too long --- # /capsule-compact Run `python3 daemons/capsule-compact.py <head_capsule_id>` from the vault root. The script: 1. Walks `parent_capsule_id` chain backward from the head 2. If chain length >= 5, summarizes the oldest 3 capsules into a single `chain-summary-<head>-<date>.md` capsule 3. Updates pointers: boundary capsule's parent → summary; summary's parent → original chain root's parent 4. Marks each compacted capsule with `compacted_into: <summary_id>` (they stay on disk for archeology) ## When to run - /close Step 0.5 PART E (v0.4.5) reports the capsule chain length when the threshold is hit - Manually before a session-heavy week to keep /open Step 2.5 fast - After narrative-reconstruction archeology when the chain has grown unwieldy ## Defaults - Threshold: 5 capsules - Summarize-count: 3 oldest Override via `--threshold N` and `--summarize-count N` flags. ## What it does NOT do - Does not auto-compact at /close. Hints, you decide. - Does not delete compacted capsules. Each gets `compacted_into:` marker. - Does not LLM-summarize. Concatenates structured fields (objective, open_threads still live, held decisions). - Does not walk forks. parent_capsule_id is strictly linear. ## Cross-links - [[concepts/Somatic v0.4.5 Chain Compaction]] — spec - [[concepts/context-capsule]] — base capsule schema
© wrg32786 · MIT · wrg32786/aigent-os