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

worktree-retry-cleanup — скилл Claude Code для чистки worktree

Скилл worktree-retry-cleanup для Claude Code проверяет владельца и убирает worktree и ветку параллельного кодера перед повторным запуском задачи.

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

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

Что делает worktree-retry-cleanup

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

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

Ручная уборка начинается с проверки владельца. В .swarm/session/state.json смотрим, не ссылается ли delegationChains другой сессии на <session>/<task>; если ссылается, протокол велит остановиться. Удаляется только .swarm-worktrees/<session>/<task>, родительская папка сессии остаётся. Дальше git worktree prune, а ветку swarm/lane/<session>/<task> снимают через git branch -d после проверки, что она не занята другим worktree и коммиты не нужны. Принудительное удаление — только с явного согласия человека.

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

  • убрать протухший worktree перед повторным запуском задачи
  • не снести лейн, который держит другая активная сессия
  • отличить грязный лейн от того, что можно удалять
  • снять ветку swarm/lane/<session>/<task> без потери коммитов
  • убедиться, что ветка лейна исчезла перед повтором

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

  • Перезапусти задачу auth-fix, но сначала прогони протокол очистки worktree для её лейна
  • Проверь .swarm/session/state.json: не владеет ли <session>/<task> другая активная сессия
  • Убери .swarm-worktrees/<session>/<task>, сделай git worktree prune и проверь, что ветка лейна удалена

Как установить worktree-retry-cleanup

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a claude-code

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

~/.claude/skills/worktree-retry-cleanup/SKILL.md

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

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

Вопросы о worktree-retry-cleanup

Как установить worktree-retry-cleanup в Claude Code?

Выполни npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a claude-code. Файл скилла окажется по пути ~/.claude/skills/worktree-retry-cleanup/SKILL.md.

Что делает worktree-retry-cleanup?

Задаёт порядок действий перед повторной отправкой задачи, у которой уже есть лейн: сначала штатная очистка при диспатче, потом проверка владельца и точечное удаление worktree с веткой.

Что будет, если лейном владеет другая сессия?

Удаление запрещено. Такой лейн, как и грязный или занятый другим worktree, показывают пользователю, а не трогают.

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

SKILL.md · MIT
---
name: worktree-retry-cleanup
description: Protocol for cleaning parallel-coder worktree lanes before retry. Triggered before re-dispatching any task that already has a lane (completed, denied, cancelled, or failed).
metadata:
  audience: swarm-plugin
---

# Worktree Retry Cleanup

## Trigger
Before re-dispatching a coder for a task that already has a lane (any prior dispatch status).

## Protocol
1. **Prefer built-in provisioning cleanup.** Re-dispatch normally through the standard coder/worktree path. Provisioning pre-cleans stale same-lane worktrees/branches when ownership is safe and the existing lane is clean.
2. **If provisioning blocks:** Treat the error as signal. Dirty lanes, lanes active in another worktree, and lanes owned by another active session must be surfaced to the user instead of deleted.
3. **If manual cleanup is explicitly required:** Do the ownership check FIRST. Confirm the lane is not owned by another ACTIVE session: read `.swarm/session/state.json` and verify no other session's `delegationChains` reference `<session>/<task>`. If another active session owns it, STOP.
4. **Remove only the specific lane.** Target `.swarm-worktrees/<session>/<task>`, never the session parent. Prefer `git worktree remove .swarm-worktrees/<session>/<task>` and then `git worktree prune`.
5. **Delete only confirmed stale branches.** `git branch -d swarm/lane/<session>/<task>` is allowed after confirming the branch is not checked out and contains no needed commits. Use force deletion only with explicit human approval.
6. **Verify:** `git branch --list "swarm/lane/<session>/<task>"` returns empty before retrying.

## Root cause
Stale same-lane worktrees and branches used to require manual cleanup before retry. Provisioning now handles the safe clean/stale cases automatically and fails closed for dirty, active, or cross-session-owned lanes.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
git-branch-cleanup gotalab Скилл git-branch-cleanup для Claude Code. Разбирает локальные ветки по статусу слияния и удалённому трекингу, удаляет лишние после подтверждения. Приводит порядок в git branch. CX Codex +1 ★ 423звёзд репо worktree-cleanup davila7 Команда worktree-cleanup для Claude Code находит слитые worktree и связанные ветки, показывает их состояние и удаляет выбранные для уборки после завершённых задач. CX Codex +1 89установок ce-worktree EveryInc Скилл ce-worktree для создания изолированных git worktrees в Claude Code и других платформах кодинга. CX Codex +1 3 200установок git-worktree-isolation sentimony Скилл git-worktree-isolation оценивает риски правок и подбирает безопасное рабочее пространство перед началом задач. Помогает избежать затирания чужого кода при параллельной работе агентов. CX Codex +1 2 300установок worktree-isolation sentimony Скилл worktree-isolation для Claude Code выбирает безопасное место: текущую папку, изолированное окружение или Git worktree. Запускается перед планом, рискованными правками и параллельной работой агентов. CX Codex +1 465установок git-merge-expert-worktree ulpi-io Скилл git-merge-expert-worktree для Claude Code и ещё пяти агентных сред: выполняет слияния и решение конфликтов в отдельном git worktree. CX Codex +1 159установок

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

Весь набор →
writing-tests Скилл writing-tests задаёт правила для написания и изменения тестов в репозитории opencode-swarm. Помогает учитывать изоляцию моков, временные каталоги и проверку регрессионных тестов. CX Codex +1 ★ 539звёзд репо run-affected-test-file-in-isolation-and-in-co-run-with-its-test- Скилл run-affected-test-file-in-isolation-and-in-co-run-with-its-test- для Claude Code заставляет агента после правки моков запускать тесты отдельно и вместе с соседними файлами, чтобы проверить оба режима. CX Codex +1 ★ 539звёзд репо update-or-delete-tests-that-assert-intentionally-removed-behavio Скилл update-or-delete-tests-that-assert-intentionally-removed-behavio для Claude Code обновляет или удаляет тесты на намеренно убранное поведение. Подключается к задачам, где меняют или удаляют код. CX Codex +1 ★ 539звёзд репо use-internals-di-seam-pattern-for-test-injectable-functions Скилл use-internals-di-seam-pattern-for-test-injectable-functions для Claude Code задаёт DI-seam через _internals и проверяет изоляцию моков Bun при совместном запуске тестов. CX Codex +1 ★ 539звёзд репо swarm Включает режим swarm-разработки с параллельным поиском, строгим планом и обязательным двойным ревью кода перед сдачей задачи. CX Codex +1 ★ 539звёзд репо research-first Скилл research-first проверяет актуальную документацию и обсуждения до разбора кода, если проблема связана с внешней библиотекой, платформой или инструментом. Для локальных вопросов он ищет ответы в репозитории. CX Codex +1 ★ 539звёзд репо swarm-pr-subscribe Скилл swarm-pr-subscribe отслеживает события в открытых пулл-реквестах, сортирует входящие замечания CI и ревьюеров и правит простые ошибки до мёрджа. CX Codex +1 ★ 539звёзд репо swarm-ci-monitor Скилл swarm-ci-monitor следит за CI проверенного PR, разбирает сбои и помогает исправлять их до зелёных проверок. После повторной проверки он может выполнить слияние. CX Codex +1 ★ 539звёзд репо

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

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