worktree-retry-cleanup — скилл Claude Code для чистки worktree
Скилл worktree-retry-cleanup для Claude Code проверяет владельца и убирает worktree и ветку параллельного кодера перед повторным запуском задачи.
MIT ★ 539 обновлён 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/worktree-retry-cleanup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/worktree-retry-cleanup/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a codex2Вручную: положить файлы
.agents/skills/worktree-retry-cleanup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a cursor2Вручную: положить файлы
.cursor/skills/worktree-retry-cleanup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .opencode/skills/worktree-retry-cleanup2Вручную: положить файлы
.github/skills/worktree-retry-cleanup/SKILL.md1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a gemini-cli2Командой платформы
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .opencode/skills/worktree-retry-cleanupВручную: положить файлы
.devin/skills/worktree-retry-cleanup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill worktree-retry-cleanup -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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