# using-git-worktrees

Скилл using-git-worktrees для Claude Code создаёт отдельный Git worktree для задачи. Запускается перед работой над функцией или выполнением плана, когда текущую рабочую копию нужно оставить нетронутой.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 103 установки · ★ 18 у репозитория
- Автор: osmontero
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/osmontero/opencode-skills/tree/HEAD/skills/using-git-worktrees/SKILL.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/osmontero-using-git-worktrees

## Что делает

Скилл создаёт изолированную рабочую копию репозитория и переносит в неё сессию. В OpenCode v2 он использует встроенные инструменты worktree; в Claude Code, Codex и обычном терминале предусмотрен запасной вариант с `git worktree add`.

Новая рабочая копия начинается с detached HEAD, поэтому внутри неё нужно создать ветку командой `git checkout -b`. Скилл проверяет базовые тесты и сообщает об ошибках, если они есть. Зависимости в worktree не общие с основной копией: настройка проекта запускается заново по найденным файлам, например через `npm install` или `pip install -r requirements.txt`.

Если worktree размещается внутри репозитория, его каталог должен попасть в `.gitignore` до создания. В OpenCode сессия переключается через `session_move`, а не обычный `cd`; созданный вручную worktree OpenCode не учитывает в своих инструментах управления.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add osmontero/opencode-skills --skill using-git-worktrees -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/using-git-worktrees/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/using-git-worktrees/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add osmontero/opencode-skills --skill using-git-worktrees -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add osmontero/opencode-skills --skill using-git-worktrees -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install osmontero/opencode-skills skills/using-git-worktrees
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add osmontero/opencode-skills --skill using-git-worktrees -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/osmontero/opencode-skills --path skills/using-git-worktrees
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add osmontero/opencode-skills --skill using-git-worktrees -a opencode
```

### Claude.ai

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

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

## Когда брать
- создать отдельную рабочую копию для новой функции
- начать реализацию плана без переключения основной ветки
- создать ветку внутри изолированного worktree
- проверить тесты на чистой копии проекта

## Примеры запросов агенту
- Подготовь отдельный worktree для функции авторизации и переключи туда сессию.
- Создай изолированную рабочую копию для выполнения плана миграции.
- Подними worktree для исправления тайм-аута входа и проверь базовые тесты.

## Похожие
- [git-worktrees](https://affpapa.org/nevibecode/skills/jamesrochabrun-git-worktrees.md) — скилл · 135 установок
- [parallel-worktrees](https://affpapa.org/nevibecode/skills/parallel-worktrees.md) — скилл · ★ 2966 у репозитория
- [create-worktrees](https://affpapa.org/nevibecode/commands/create-worktrees.md) — команда · 351 установка
- [git-workflow-and-versioning](https://affpapa.org/nevibecode/skills/git-workflow-and-versioning.md) — скилл · 75700 установок
- [git-worktree-isolation](https://affpapa.org/nevibecode/skills/git-worktree-isolation.md) — скилл · 2300 установок
- [git-merge-expert-worktree](https://affpapa.org/nevibecode/skills/git-merge-expert-worktree.md) — скилл · 159 установок

## Другие версии с тем же именем
- [using-git-worktrees · obra](https://affpapa.org/nevibecode/skills/using-git-worktrees.md) — 217153 установки
- [using-git-worktrees · julianobarbosa](https://affpapa.org/nevibecode/skills/julianobarbosa-using-git-worktrees.md) — 106 установок
- [using-git-worktrees · ganyuanran](https://affpapa.org/nevibecode/skills/ganyuanran-using-git-worktrees.md) — ★ 1450 у репозитория

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

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

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