Files

T

k.denisov 14779f4520 Сообщение о восстановленных скилах видно в ленте

Веб-интерфейс и TUI показывают у synthetic-сообщения только description, поэтому
вместо «skill-compact-resurrect» там теперь сам текст. В README — где сообщение
видно в веб-интерфейсе: в Timeline detail = Compact (по умолчанию) оно свёрнуто в
группу вызовов тулов, в Everything — отдельной строкой.

2026-10-29 21:53:51 -07:00

5.3 KiB

Raw Blame History

skill-compact-resurrect

Плагин для OpenCode 2. Когда сессия переживает compaction, скилы, загруженные до неё, пропадают из контекста: сводка их не содержит, а модель об этом не знает и продолжает работать без инструкций скила. Плагин возвращает эти скилы в системный промпт сразу после compaction.

Как работает

Скил попадает в сессию двумя путями: модель вызывает тул skill ({ id }) и получает текст скила результатом тула, или пользователь вызывает скил сам — тогда в истории появляется сообщение типа skill. Compaction заменяет всё это сводкой.

Плагин висит на хуке context, который срабатывает перед каждым запросом к модели:

Читает текущий контекст сессии (session.context) и запоминает имена всех загруженных скилов. Список хранится в ctx.storage, поэтому переживает перезапуск OpenCode. Повторный вызов скила переносит его в конец списка, как самый свежий.
Если в контексте есть завершённая compaction, добавляет в системный промпт этого запроса тексты скилов, загруженных до неё и не загруженных заново после.

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

Системный промпт в интерфейсе не виден, поэтому один раз на каждую compaction плагин:

пишет в чат короткое служебное сообщение — «♻ После compaction восстановлены скилы: …». Ход модели оно не запускает (resume: false);
добавляет строку в $XDG_DATA_HOME/opencode/log/skill-compact-resurrect.log.

Где видно сообщение в веб-интерфейсе

Служебные сообщения веб-интерфейс показывает одной строкой, и где именно — зависит от настройки Settings → Preferences → Timeline → Timeline detail:

Compact (по умолчанию) — служебные сообщения сгруппированы и свёрнуты. Сообщение плагина приходит между шагами модели, поэтому оказывается внутри ближайшей группы вызовов («Used 1 Shell» и т. п.) и видно, только если её раскрыть;
Everything (ползунок до упора вправо) — служебные сообщения идут отдельной строкой, сообщение видно сразу.

Отдельно от группировки — только compaction и смена модели или каталога; плагин на это повлиять не может.

Установка

Положить ссылку на файл в plugins/ конфига OpenCode — он подхватывает такие файлы сам:

ln -sfn "$PWD/skill-compact-resurrect.v2.ts" "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/plugins/"

В "plugin" в opencode.jsonc его не добавлять: имя там считается npm-пакетом. Изменения в файле применяются после перезапуска OpenCode.

Опции

Задаются в opencode.jsonc: "plugins": { "package": "<путь>", "options": { … } }.

Опция	По умолчанию	Что
`maxRestoredSkills`	все	сколько последних скилов возвращать
`notify`	`true`	писать ли сообщение в чат

Проверка

После compaction в сессии, где загружались скилы, в чате должно появиться сообщение «♻ После compaction восстановлены скилы: …», а в журнале — строка вида:

2026-10-29T12:00:00.000Z ses_… after msg_…: restored [bmad-build, bmad-spec]

Нет ни того, ни другого — проверить, что ссылка на плагин лежит в plugins/ нужного конфига (того, что OpenCode получает в XDG_CONFIG_HOME).

Требуется OpenCode 2 (API плагинов v2: ctx.session.hook, ctx.session.context, ctx.session.synthetic, ctx.skill, ctx.storage). Проверено на 2.1.3.

5.3 KiB Raw Blame History Unescape Escape