# code-assist

Скилл ведёт агента по циклу Explore, Plan, Code, Commit: сначала разведка и план, потом тесты, потом код. Пригодится, когда задачу надо провести через TDD, а не писать сразу.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 3186
- Автор: mikeyobrien
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/mikeyobrien/ralph-orchestrator/tree/HEAD/.claude/skills/code-assist/SKILL.md
- Обновлён: 2026-10-15
- HTML: https://affpapa.org/nevibecode/skills/code-assist

## Что делает

Скилл задаёт агенту порядок работы над задачей: разобраться в требованиях, изучить существующие паттерны в репозитории, спланировать тесты, написать их, убедиться, что они падают, и только потом делать реализацию. Дальше идёт рефакторинг с проверкой, что тесты и сборка проходят. Всё это описано как жёсткие шаги с ограничениями, а не как совет.

Работает в двух режимах. `interactive` останавливается на ключевых точках и спрашивает подтверждение, `auto` идёт сам и записывает решения в `progress.md`. Планы и контекст складываются в `{documentation_dir}` (по умолчанию `.sop/planning`), код и тесты — в `repo_root`, и смешивать их нельзя. Если в корне репозитория лежит `CODEASSIST.md`, скилл прочитает его и будет следовать его ограничениям.

Перед запуском стоит проверить, что в проекте есть тестовый фреймворк: скилл требует следовать конвенциям тестирования, которые уже приняты в кодовой базе, и прогонять тесты после каждого шага. На пустом репозитории без тестов эта часть встанет.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill code-assist -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill code-assist -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill code-assist -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mikeyobrien/ralph-orchestrator code-assist
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill code-assist -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/mikeyobrien/ralph-orchestrator --path .claude/skills/code-assist
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add mikeyobrien/ralph-orchestrator --skill code-assist -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/mikeyobrien/ralph-orchestrator/tree/HEAD/.claude/skills/code-assist/SKILL.md

## Когда брать
- разложить задачу на требования и критерии приёмки
- найти в репозитории похожие реализации и их интерфейсы
- спланировать тест-сценарии до написания кода
- провести реализацию по циклу RED → GREEN → REFACTOR
- привести новый код к конвенциям соседних модулей

## Примеры запросов агенту
- Прогони code-assist для задачи: добавить экспорт отчёта в CSV, режим interactive
- Используй code-assist, task_description — путь к `.code-task.md`, документация в `.sop/planning`
- Запусти code-assist в auto-режиме на доработку парсера конфигов

## Похожие
- [rpi](https://affpapa.org/nevibecode/skills/rpi.md) — скилл · 1500 установок
- [cook](https://affpapa.org/nevibecode/skills/cook.md) — скилл · 667 установок
- [build](https://affpapa.org/nevibecode/skills/parcadei-build.md) — скилл · 488 установок
- [attorney-assist](https://affpapa.org/nevibecode/skills/attorney-assist.md) — скилл · 939 установок
- [feature-development](https://affpapa.org/nevibecode/commands/feature-development.md) — команда · ★ 41729
- [conductor](https://affpapa.org/nevibecode/plugins/conductor.md) — плагин · ★ 41729

Из того же набора: [mikeyobrien/ralph-orchestrator](https://affpapa.org/nevibecode/by/mikeyobrien/ralph-orchestrator.md) — 4 карточки

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

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