К основному содержанию
скилл CX Codex

durable-session-state — скилл для Claude Code

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

MIT ★ 539 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ZaxbyHub/opencode-swarm --skill durable-session-state -a claude-code
Открыть на GitHub

Что делает durable-session-state

Для каждой задачи скилл предлагает вести четыре файла: plan.md со scope и критериями успеха, decisions.md с принятыми решениями, evidence.md с командами проверки и их результатами, gates.md с вердиктами ревьюеров. Файлы обновляются на этапах работы, а не только перед завершением.

При возобновлении задачи агент перечитывает эти записи, сверяет актуальный HEAD и diff с последним одобрением и повторяет проверку, если код изменился. Для обычных задач файлы хранятся в .claude/session/tasks/<task-slug>/; артефакты не следует коммитить без просьбы пользователя. Это важно для swarm-задач: одобрение до последнего изменения уже недействительно.

Какие задачи решает

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

Примеры запросов агенту

  • Сохрани план этой задачи и критерии успеха в файлах состояния.
  • Запиши результаты тестов и вердикт ревью для текущего diff.
  • Возобнови задачу: прочитай сохранённые решения и проверь актуальность последнего одобрения.

Как установить durable-session-state

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill durable-session-state -a claude-code

2Вручную: положить файлы

~/.claude/skills/durable-session-state/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/durable-session-state/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о durable-session-state

Как установить durable-session-state в Claude Code?

Выполните npx skills add ZaxbyHub/opencode-swarm --skill durable-session-state -a claude-code. Файл скилла находится по пути ~/.claude/skills/durable-session-state/SKILL.md.

Что делает durable-session-state?

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

Где хранятся файлы состояния задачи?

Для обычных swarm-задач используйте .claude/session/tasks/<task-slug>/. Для работы с issue-tracer применяется .agents/issue-traces/<issue-slug>/ и схема этого скилла.

Исходный текст

SKILL.md · MIT
---
name: durable-session-state
description: >
  Persist plans, scope decisions, evidence, and reviewer/critic verdicts to
  durable files during long or multi-phase tasks so work survives context
  compaction, session resumes, and handoffs. Use for swarm-mode tasks, before
  context grows large, when recording approval gates, and when resuming after
  compaction or a session restart.
metadata:
  audience: swarm-plugin
---

# Durable Session State

Long swarm-mode sessions outlive their context window. Compaction summarizes
history, and summaries lose exactly the things the swarm gates depend on:
which diff a reviewer approved, what evidence was recorded, which decisions
are settled. Without durable artifacts, a resumed session re-litigates settled
decisions or — worse — treats a stale approval as current. Persist state to
files as you go; treat the conversation as cache, not storage.

## Where artifacts live

- Generic swarm tasks: `.claude/session/tasks/<task-slug>/` in the project.
- Issue-tracer work: `.agents/issue-traces/<issue-slug>/` (that skill's own schema
  — `08b-implementation-review.md`, `09-final-critic.md` — wins for its work).
- Never write task artifacts to the repo root, and never under `.swarm/` —
  that directory is the OpenCode plugin's runtime state, not Claude Code's.
- These artifacts are working state, not deliverables: do not commit them
  unless the user asks. Before committing, check `git status` and exclude
  them explicitly.

## What to persist

Keep it to four small files per task; update in place:

1. `plan.md` — task scope, success criteria, files in scope, what must not
   break. Update when scope changes; never fork a second plan file.
2. `decisions.md` — one line per settled decision with a one-line rationale
   ("chose X over Y because Z"). Settled means: do not reopen without new
   evidence or a user request.
3. `evidence.md` — validation commands run and their outcomes (pass/fail plus
   the load-bearing output lines, not full logs).
4. `gates.md` — the approval ledger. One entry per reviewer/critic verdict:

   ```
   ## <gate> — <APPROVE|NEEDS_REVISION|BLOCKED>
   when: <ISO timestamp or turn marker>
   head: <git rev-parse HEAD>
   diff: <git diff --stat summary>
   items: <blocking items, or none>
   ```

## When to write

- At phase boundaries (scope settled, plan built, implementation done, each
  gate verdict received).
- Before ending a turn while background subagents are running.
- Whenever you notice the conversation is long — write ahead of compaction,
  not after it.

## Resume protocol

On resuming (after compaction, a restart, or a handoff), before doing new
work:

1. Re-read the task's artifacts. They are authoritative over your memory of
   the conversation.
2. Do not re-litigate `decisions.md` entries or redo work `evidence.md`
   already proves, absent new evidence or a user request.
3. Check gate staleness: if `git rev-parse HEAD` or the working-tree diff no
   longer matches the latest APPROVE entry in `gates.md`, that approval is
   invalid — re-run the affected reviewer/critic gate on the current diff.
4. If artifacts and the summarized conversation disagree, trust the artifacts
   and say so.

## Relationship to swarm gates

The swarm-mode contract invalidates any approval issued before the latest
edit. The `gates.md` ledger is what makes that rule *checkable* instead of
vibes: record the HEAD and diff summary at approval time, compare on resume
and before final synthesis. If you cannot demonstrate approval-after-last-edit
from the ledger, the gate is not satisfied.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
session-management alinaqi Скилл session-management ведёт файлы состояния, решений и ориентиров в коде, чтобы работа продолжалась с того же места после перерыва или упора в лимит контекста. CX Codex +1 310установок session-wrap ai-native-camp Скилл session-wrap разбирает завершённую работу перед закрытием сессии: что закоммитить, какие знания записать, какие задачи остались. CX Codex +1 1 300установок project-session-manager Yeachan-Heo Скилл project-session-manager автоматизирует создание отдельных git-воркtræев для каждой задачи, PR или фичи, с опциональной оркестровкой tmux-сессий. Позволяет параллельно работать над несколькими ветками без конфликтов. CX Codex +1 937установок session-to-skill entireio Скилл session-to-skill для Claude Code превращает историю сессий Entire в черновик повторяемого рабочего процесса. Он собирает правила, команды и проверки для будущих запусков. CX Codex +1 504установок session-crosslink entireio Скилл session-crosslink для Claude Code и Codex связывает сессию агента с коммитами затронутых репозиториев Entire. Запускается, когда работа идёт вне нужного репозитория. CX Codex +1 389установок session-handoff Rohit Ghumare Скилл session-handoff формирует структурированный отчёт о сессии с текущим состоянием репозитория, решениями и готовой командой для следующего запуска. CX Codex +1 ★ 2 966звёзд репо

Из того же набора121

Весь набор →
gate-attribution Скилл gate-attribution связывает вердикты ревьюеров и тестировщиков с конкретными задачами плана в swarm-пайплайнах. Помогает избежать сбоев при пакетной проверке. CX Codex +1 ★ 539звёзд репо merge-queue-readiness Скилл merge-queue-readiness проверяет результат слияния PR с актуальной main до добавления в GitHub merge queue. Помогает поймать сбои интеграционных тестов, которых не видно при проверке ветки PR отдельно. CX Codex +1 ★ 539звёзд репо issue-tracer Субагент issue-tracer, который доводит GitHub issue от репорта до плана исправления. Собирает доказательства, находит корневую причину и не трогает код, пока вы не подтвердите план. CX Codex +1 ★ 539звёзд репо qa-reviewer Субагент qa-reviewer для строгого ревью пуллреквестов перед слиянием. Проверяет логику, безопасность, обработку ошибок, стиль и покрытие тестами без изменения кода. CX Codex +1 ★ 539звёзд репо swarm-pr-feedback Скилл swarm-pr-feedback для Claude Code собирает известные замечания к PR в реестр, проверяет каждое по коду и только после этого вносит правки. Разбирает замечания ревью, сбои CI и конфликты. CX Codex +1 ★ 539звёзд репо swarm-pr-feedback Скилл swarm-pr-feedback для автоматической обработки замечаний к pull request, падений CI и конфликтов слияния перед публикацией правок. CX Codex +1 ★ 539звёзд репо commit-pr Скилл commit-pr проверяет код перед пушем, создаёт конвенциональные коммиты и оформляет PR-описание. Включается при подготовке изменений к отправке. CX Codex +1 ★ 539звёзд репо test-file-split Скилл test-file-split разбивает разросшийся тест-файл на части по блокам describe(), когда тот подходит к лимиту в 500 строк или уже перевалил его. CX Codex +1 ★ 539звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой