# worktree-retry-cleanup

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

- скилл · `type=skill` · Claude Code, Codex, OpenCode, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 539 у репозитория
- Автор: ZaxbyHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.opencode/skills/worktree-retry-cleanup/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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 и коммиты не нужны. Принудительное удаление — только с явного согласия человека.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
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/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/worktree-retry-cleanup/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/worktree-retry-cleanup/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ZaxbyHub/opencode-swarm .opencode/skills/worktree-retry-cleanup
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/worktree-retry-cleanup/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .opencode/skills/worktree-retry-cleanup
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/worktree-retry-cleanup/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.opencode/skills/worktree-retry-cleanup/SKILL.md

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

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

## Похожие
- [git-branch-cleanup](https://affpapa.org/nevibecode/skills/git-branch-cleanup.md) — скилл · ★ 423 у репозитория
- [worktree-cleanup](https://affpapa.org/nevibecode/commands/worktree-cleanup.md) — команда · 89 установок
- [ce-worktree](https://affpapa.org/nevibecode/skills/ce-worktree.md) — скилл · 3200 установок
- [git-worktree-isolation](https://affpapa.org/nevibecode/skills/git-worktree-isolation.md) — скилл · 2300 установок
- [worktree-isolation](https://affpapa.org/nevibecode/skills/worktree-isolation.md) — скилл · 465 установок
- [git-merge-expert-worktree](https://affpapa.org/nevibecode/skills/git-merge-expert-worktree.md) — скилл · 159 установок

Из того же набора: [zaxbyhub/opencode-swarm](https://affpapa.org/nevibecode/by/zaxbyhub/opencode-swarm.md) — 121 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
