# compaction

Субагент compaction для Claude Code сокращает историю диалога, чтобы она укладывалась в контекст модели. Работает с историей, которую агент хранит в памяти.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 521 у репозитория
- Автор: eavanvalkenburg
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/concepts/agents/conversations/compaction.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/compaction

## Что делает

Субагент описывает стратегии сокращения истории: старые сообщения можно удалять, сворачивать или обобщать, сохраняя важный контекст. Это помогает избежать превышения окна контекста и уменьшить объём токенов, передаваемых модели.

Compaction применим к агентам, которые сами хранят историю сообщений в памяти и отправляют её целиком при каждом вызове. Для агентов с контекстом, которым управляет сервис, настройка стратегии ничего не меняет. Это ключевое ограничение: сначала проверьте, кто хранит историю в вашем сценарии.

В материалах описаны варианты для C#, Python и Go. Для C# фреймворк помечен как экспериментальный, а для Python тоже указано экспериментальное состояние; в Go стратегия подключается как `agent.ContextProvider`.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/compaction.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/compaction.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/compaction.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/concepts/agents/conversations/compaction.md

## Когда брать
- сократить историю диалога перед вызовом модели
- не допустить превышения окна контекста
- уменьшить число токенов в полной истории
- сохранить связанные вызовы инструментов вместе

## Примеры запросов агенту
- Проверь, как применить compaction к истории диалога, которую агент хранит в памяти.
- Объясни, когда стратегия compaction сработает при превышении лимита токенов.
- Покажи, почему compaction не изменит контекст агента, которым управляет сервис.

## Похожие
- [session-compaction-and-restore](https://affpapa.org/nevibecode/skills/session-compaction-and-restore.md) — скилл · ★ 8928 у репозитория
- [caliber-jev-compaction](https://affpapa.org/nevibecode/plugins/caliber-jev-compaction.md) — плагин · ★ 1319 у репозитория
- [claude-compaction-restore](https://affpapa.org/nevibecode/skills/claude-compaction-restore.md) — скилл · ★ 8928 у репозитория
- [strategic-compact](https://affpapa.org/nevibecode/skills/strategic-compact.md) — скилл · 6900 установок
- [compact-guard](https://affpapa.org/nevibecode/commands/compact-guard.md) — команда · ★ 2966 у репозитория
- [rekall](https://affpapa.org/nevibecode/plugins/rekall.md) — плагин · ★ 1596 у репозитория

Из того же набора: [managedcode/dotnet-skills](https://affpapa.org/nevibecode/by/managedcode/dotnet-skills.md) — 38 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
