Context compression

Skill dzhokhov/markdown-agent-vault-ru/skills/context-compression

Open-source starter kit for an agent-ready Markdown vault with AGENTS.md, templates, skills, logs, and file-safe AI workflows.

Install

npx -y skills add dzhokhov/markdown-agent-vault-ru --skill context-compression

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Сжатие исторического контекста контуров и проектов: поддержка `meetings/README.md` как краткой памяти по прошлым встречам, решениям, разворотам, открытым вопросам, устаревшим договорённостям и якорным встречам. ОБЯЗАТЕЛЬНО используй этот скилл, когда пользователь просит: «сожми историю», «сделай скользящее окно», «обнови память встреч», «суммаризируй старые встречи», «контекст упирается в лимит», «подготовь контекст перед разбором встречи», «не читай всю историю». Также используй как вспомогательный скилл перед `meeting-processing`, если встреча регулярная, ссылается на прошлые обсуждения или у контура есть больше 3 старых встреч.

SKILL.md

19.5 KB, as published. Nobody here has run it

Context Compression — скилл сжатия исторического контекста

Зачем этот скилл

meeting-processing должен разбирать текущую встречу, а не держать всю историю контура в окне контекста. Этот скилл поддерживает отдельный сжатый слой истории, чтобы агент мог восстановить причинную цепочку без чтения десятков старых встреч.

Главный выход скилла — meetings/README.md в головном проекте контура или в папке встреч проекта. Это не пересказ всех встреч, а навигационная память: что решили, что изменили, что устарело, какие вопросы ещё открыты и какие встречи являются якорными.

meetings/README.md не заменяет текущую картину проекта или продукта. Если нужен ответ «что сейчас главное», он живёт в отдельной текущей картине, объявленной в README.md или context.md, по правилу Память vault.

Принципы

Сжатие отдельно от разбора. Скилл не извлекает задачи из новой встречи и не маршрутизирует их в plan.md / tasks.md. Это делает meeting-processing.
Ограниченное чтение. Запрещено читать все старые встречи целиком. Полностью читаются только ближайшие и явно связанные встречи.
Решения важнее пересказа. В сжатой истории хранятся цепочки решений: «было → изменилось → почему → ссылка».
Устаревшее видно явно. Если старое решение отменено или переопределено, оно остаётся в сжатой истории как superseded, чтобы агент не принял его за актуальное.
Каждый пункт со ссылкой. Любой сжатый факт должен ссылаться на исходную встречу или log.md.
Сжатие тоже ограничено. meetings/README.md не должен становиться новым длинным архивом: если он разрастается, старые цепочки сворачиваются в годовой файл истории.
Публичность проверяется до записи. Сжатый слой часто видят больше людей, чем отдельные заметки. Не концентрируй в нём персональные оценки, конфликты, деньги и чувствительные детали без явного основания.
История не равна текущей картине. После обновления meetings/README.md проверь, не нужно ли отдельно обновить текущую картину проекта или продукта. Не подменяй её сжатой историей встреч.
Сводка не равна истине. Сжатая история хранит ссылку на источник, тип утверждения, основание и статус доверия для важных цепочек решений.
Слабое не повышается молча. Пункты с evidence.strength: low, историческими ссылками без источника или устаревшим last_verified не используются как факты текущей картины.
Конфликт сохраняется. Если старое и новое утверждения противоречат друг другу, создать или обновить конфликт, а не сглаживать формулировку.

Когда запускать

Запускай скилл в трёх режимах:

Режим	Триггер	Результат
Подготовка к встрече	перед `meeting-processing` для регулярной встречи или длинного контура	прочитать готовый `meetings/README.md`, определить окно чтения
Обслуживание истории	пользователь просит сжать / обновить историю	создать или обновить `meetings/README.md`
После встречи	новая встреча меняет решение, фокус, открытый вопрос или добавляет якорную встречу	обновить сжатую историю после записи саммари

Алгоритм

Шаг 0. Определить место сжатой истории

Определи контур или проект по правилам AGENTS.md.
Найди папку встреч:
- для контура: <головной проект>/meetings/ или путь из карты контура;
- для проектной папки: <project>/materials/meetings/ или существующая папка, где уже лежат встречи.
Основной файл сжатия: meetings/README.md.
Если папка встреч содержит меньше 3 встреч, отдельный файл сжатия обычно не нужен. Достаточно ссылок из log.md.
Для новых индексов используй шаблон meetings_readme.md.

Шаг 1. Собрать карту без полного чтения

Сначала собери список встреч по именам файлов, frontmatter, заголовкам и секциям ## Суть / ## Связи. Не читай тела всех встреч.

Минимум для каждой встречи:

дата;
тема;
участники, если есть;
1–2 предложения из ## Суть;
ссылки из ## Связи;
явные маркеры: «реверс», «отменено», «предыдущая встреча», «после паузы», «возвращаемся».

Шаг 2. Выбрать окно полного чтения

Полностью можно читать только:

последние 2–3 релевантные встречи;
до 2 явно связанных старых якорных встреч;
встречу, на которую новая встреча ссылается как на источник отменённого или подтверждённого решения.

Жёсткий предел: если выбранные старые встречи суммарно становятся больше примерно 25–35 тысяч слов, сократи окно и работай через уже сжатые секции.

Если встреча содержит ссылку вида «как обсуждали раньше», но источник не найден:

не читай всю историю;
зафиксируй историческая ссылка без источника;
попроси владельца уточнить или оставь пометку в meetings/README.md.

Шаг 3. Проверить публичность и чувствительность

Перед записью в meetings/README.md классифицируй слой:

Тип контура	Что можно писать в сжатую историю	Что не писать
Командный / публикуемый	решения, статусы, ссылки, открытые вопросы, устаревшие договорённости	персональные оценки, конфликты, чувствительные деньги, доступы, внутренние риски безопасности
Личный / закрытый	решения, личные выводы, чувствительные пометки при необходимости	то, что нельзя хранить в vault вообще
Смешанный	только нейтральный слой; чувствительное — в закрытый контур или личную заметку со ссылкой из `log.md` по необходимости	дублирование чувствительных деталей в общем индексе

Если сомневаешься, в сжатой истории оставь нейтральную формулировку и ссылку на исходную встречу. Деталь остаётся в исходнике, если он уже имеет правильную область видимости.

Шаг 4. Обновить `meetings/README.md`

Рекомендуемая структура:

# Meetings

## Суть
Краткая память по встречам контура: последние встречи, цепочки решений, открытые вопросы и якорные источники.

## Последние встречи
| Дата | Встреча | Главный итог | Ссылка |
|------|---------|--------------|--------|

## Цепочки решений
### <тема>
- YYYY-MM-DD: было принято <решение> → [встреча](./meeting-....md)
  - Trust: `claim_type: decision`; `confidence: high | medium | low`; `last_verified: YYYY-MM-DD`; `write_policy: human_review_required`
  - Evidence: <короткая цитата или точное основание>
- YYYY-MM-DD: решение изменено: <что стало иначе>; причина: <коротко> → [встреча](./meeting-....md)
  - Supersedes: <старое решение>
  - Related conflict: <ссылка, если есть>
- Текущий статус: <актуальная формулировка>

## Устаревшие решения
- <решение> — устарело с YYYY-MM-DD, заменено на <новая формулировка> → [источник](./meeting-....md)

## Открытые вопросы
- <вопрос> — с какой встречи тянется, где искать следующий вход.

## Якорные встречи
- [YYYY-MM-DD — тема](./meeting-....md): почему это якорь.

## Архивные цепочки
- Если активных цепочек стало больше 7 или файл стал слишком длинным, старые цепочки перенести в `history-YYYY.md` и оставить здесь 1 строку-ссылку.

## Исторические ссылки без источника
- <формулировка из встречи> — источник не найден; `evidence.kind: unknown`; `evidence.strength: low`; нужна ручная привязка. Не использовать как основание текущей картины.

Не добавляй длинные пересказы. Один пункт — одна мысль — одна ссылка.

Ограничения размера:

## Последние встречи: максимум 5 строк;
## Цепочки решений: максимум 7 активных цепочек;
## Открытые вопросы: максимум 10 пунктов;
длинные архивные цепочки выносить в meetings/history-YYYY.md только когда это реально нужно, не заранее.

Шаг 5. Использование перед `meeting-processing`

Перед разбором новой встречи верни для meeting-processing компактный пакет:

## Сжатый исторический контекст
- Файл сжатия: <путь>
- Читать полностью: <список 2–3 последних встреч и якорей>
- Не читать полностью: <старые встречи, покрытые сжатием>
- Актуальные цепочки решений: <3–7 пунктов>
- Устаревшие решения, которые нельзя принимать за актуальные: <список>
- Исторические ссылки без источника: <список, если есть>
- Слабые или спорные утверждения: <список>
- Конфликты памяти: <список>

meeting-processing использует этот пакет как часть линзы разбора и не углубляется в старые встречи за пределами окна.

Шаг 6. Обновление после новой встречи

После записи саммари встречи обнови meetings/README.md, если выполнено хотя бы одно условие:

встреча отменила или изменила прежнее решение;
появилась новая стратегическая развилка;
закрыт или открыт долгий вопрос;
после последнего сжатия накопилось 3+ новых встречи;
встреча стала якорной для будущего разбора.

Если новая встреча обычная и ничего не меняет, достаточно добавить её в ## Последние встречи.

Шаг 7. Кросс-контурные встречи

Если встреча затрагивает несколько контуров:

сжатая история живёт в основном контуре встречи;
во втором контуре не дублируй цепочку решений целиком;
во втором контуре допустима короткая ссылка в log.md или одна строка в meetings/README.md: «связано с решением в <основной контур>»;
если решение реально меняет два контура независимо, в каждом контуре фиксируется только его собственная часть решения и ссылка на основное саммари.

Шаг 8. Отчёт о чтении

В конце работы покажи короткий отчёт:

Полностью прочитано:
- <файл встречи>

Использовано через сжатие:
- <meetings/README.md>

Не читалось:
- старые встречи вне окна

Если полностью прочитано больше 5 старых встреч, объясни почему. Без объяснения это считается нарушением принципа ограниченного чтения.

Что скилл НЕ делает

Не маршрутизирует задачи, обещания и блокеры.
Не пишет в context.md эпизодические факты.
Не заменяет log.md: события всё равно фиксируются в log.md, а meetings/README.md хранит историческую навигацию.
Не заменяет текущую картину проекта или продукта.
Не создаёт отдельный файл сжатия на каждую тему, пока meetings/README.md справляется.
Не читает всю папку встреч целиком ради осторожности.
Не дублирует сжатые цепочки в нескольких контурах.
Не делает публичный индекс местом для чувствительных деталей.

Проверка

Перед завершением проверь: