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

swarm-resume — скилл для Claude Code: что делает и как установить

Скилл swarm-resume для Claude Code восстанавливает состояние плана роя и очищает зависшие git-ветки, чтобы продолжить выполнение задач по готовому плану.

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

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

Что делает swarm-resume

Скилл содержит протокол режима RESUME для среды opencode-swarm. Архитектор загружает эту инструкцию по требованию, когда нужно продолжить выполнение задач из файла .swarm/plan.md либо переключить проект между локальным и облачным окружением.

Сначала агент сверяет поле Swarm в заголовке плана с текущим идентификатором роя. Если они совпадают, запускается утилита /swarm reset-session, которая вычищает зависшие каталоги .swarm-worktrees/ и ветки swarm-lane/*. Если идентификатор отличается, протокол удаляет чужой блок SME Cache из context.md, сбрасывает память предыдущего агента и прописывает активный рой.

Править .swarm/plan.md вручную нельзя: файл является производной проекцией, поэтому любые обновления заголовка разрешено выполнять только через инструмент save_plan.

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

  • продолжить прерванное выполнение задач по плану .swarm/plan.md
  • очистить зависшие ветки swarm-lane/* и папки .swarm-worktrees/
  • перенести утверждённый план на другой идентификатор роя
  • сбросить устаревший SME Cache в context.md перед стартом

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

  • Продолжи выполнение плана роя с текущей задачи
  • Возобнови сессию роя и очисти старые ветки воркспейса
  • Сверь идентификатор роя в .swarm/plan.md и переключи контекст

Как установить swarm-resume

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill swarm-resume -a claude-code

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

~/.claude/skills/swarm-resume/SKILL.md

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

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

Вопросы о swarm-resume

Как установить swarm-resume в Claude Code?

Выполните команду npx skills add ZaxbyHub/opencode-swarm --skill swarm-resume -a claude-code в терминале проекта.

Что произойдёт, если файл .swarm/plan.md отсутствует?

Агент определит проект как новый и перейдёт в режим MODE: SPECIFY. В этом режиме он запустит утилиту complexity_hotspots за 90 дней и соберёт базовый состав зависимостей через sbom_generate с параметром scope='all'.

Зачем запускается сброс сессии перед возобновлением?

Команда /swarm reset-session удаляет оставшиеся от прошлой сессии каталоги .swarm-worktrees/ и ветки swarm-lane/*, чтобы агент не столкнулся с конфликтами файловой системы.

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

SKILL.md · MIT
---
name: swarm-resume
description: >
  Full execution protocol for MODE: RESUME -- continuing an existing approved plan safely from current state.
metadata:
  audience: swarm-plugin
---

# Resume Protocol

This protocol is loaded on demand by the architect runtime. The architect prompt keeps only activation, action, and hard safety constraints; the full execution details live here.

### MODE: RESUME
If .swarm/plan.md exists:
  1. Read plan.md header for "Swarm:" field
  2. If Swarm field missing or matches the active swarm id:
     - Reconcile stale worktree state before resuming: prune/adopt stale `.swarm-worktrees/` lane directories and `swarm-lane/*` git branches left from the prior session. Drive this via the `/swarm reset-session` recovery command (internal: `cleanupOrphanedBranches`) so the resumed run starts from a clean provisioning state.
     - Resume at current task
  3. If Swarm field differs (e.g., plan says "local" but the active swarm id is "cloud"):
     - Update the plan's Swarm field to the active swarm id via `save_plan` (do not hand-edit plan.md — it is a derived projection).
     - Purge any memory blocks (persona, agent_role, etc.) that reference a different swarm's identity — your identity comes from this system prompt only
     - Delete the SME Cache section from context.md (stale from other swarm's agents)
     - Update context.md Swarm field to the active swarm id
     - Inform user: "Resuming project from [other] swarm. Cleared stale context. Ready to continue."
     - Reconcile stale worktree state before resuming: prune/adopt stale `.swarm-worktrees/` lane directories and `swarm-lane/*` git branches left from the prior session. Drive this via the `/swarm reset-session` recovery command (internal: `cleanupOrphanedBranches`) so the resumed run starts from a clean provisioning state.
     - Resume at current task
If .swarm/plan.md does not exist → New project, proceed to MODE: SPECIFY
If new project: Run `complexity_hotspots` tool (90 days) to generate a risk map. Note modules with recommendation "security_review" or "full_gates" in context.md for stricter QA gates during QA gate selection (stricter gates). Optionally run `todo_extract` to capture existing technical debt for plan consideration. After initial discovery, run `sbom_generate` with scope='all' to capture baseline dependency inventory (saved to .swarm/evidence/sbom/).

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
troupe-mission hitianqi Скилл troupe-mission для Claude Code координирует параллельную работу субагентов в отдельных окнах tmux и ветках git. Сессия пишет план, отдаёт задачи ролям и проверяет код перед слиянием. CX Codex +1 ★ 140звёзд репо fleet SethGammon Скилл fleet для Claude Code разбивает крупные задачи на независимые потоки и выполняет их волнами до трёх агентов в изолированных git worktree. CX Codex +1 ★ 937звёзд репо suede-graph-flo-xr JasonColapietro Скилл suede-graph-flo-xr сравнивает и отсеивает планы реализации до внесения правок в код. Запускает граф рассуждений, выбирает один вариант и тестирует сборку в изолированном дереве Git. CX Codex +1 ★ 121звёзд репо magic-cc-codex-worker Wenqing Yu Плагин magic-cc-codex-worker запускает параллельных агентов Codex из Claude Code и разводит их работу по отдельным git worktree. Он пригодится для независимых задач и дополнительной проверки PR. ★ 3 785звёзд репо arena backnotprop Скилл arena для Claude Code запускает параллельных кандидатов под одну задачу, выбирает базовый вариант и переносит в него удачные части остальных. Защищает от фиксации на ошибочной архитектуре. CX Codex +1 10 800установок Swarm Orchestration ruvnet Скилл Swarm Orchestration для Claude Code управляет роями агентов с параллельным выполнением задач, динамической топологией и балансировкой нагрузки. Координирует специалистов разного профиля. CX Codex +1 2 100установок

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

Весь набор →
commit-pr Скилл commit-pr для Claude Code и Codex требует от агента пройти чек-лист до коммита, пуша и создания PR. CX Codex +1 ★ 539звёзд репо skill-edit-validation Скилл skill-edit-validation проверяет ассерты в тестах после правок файлов навыков и промптов, чтобы уберечь CI от падений из-за устаревших строк. CX Codex +1 ★ 539звёзд репо discover Скилл discover поручает агенту исследовать репозиторий и собрать карту его правил, структуры и зон риска. Пригодится перед сложной задачей, когда важно понять существующий код до изменений. CX Codex +1 ★ 539звёзд репо ci-fix-monitor Скилл ci-fix-monitor для Claude Code отслеживает статусы проверок в pull request и исправляет сбои сборки. Диагностирует падения CI в проектах opencode-swarm до полного прохождения проверок. CX Codex +1 ★ 539звёзд репо ci-failure-batching Скилл ci-failure-batching собирает все упавшие проверки PR, прежде чем планировать исправления. Помогает избежать отдельного цикла диагностики и отправки изменений для каждой ошибки. CX Codex +1 ★ 539звёзд репо mock-to-internals-migration Скилл mock-to-internals-migration для Claude Code помогает переносить моки с Vitest на Bun и проверять переход на seam _internals. Подключается к задачам миграции моков и изменения тестовой структуры. CX Codex +1 ★ 539звёзд репо 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звёзд репо

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

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