# setup

Проводит проект от «песочницы нет» до запуска ИИ-агента внутри devcontainer aicontainer с настройкой под конкретный стек.

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

## Что делает

Скилл определяет стек проекта, проверяет, подходит ли вообще Linux-контейнер, предлагает план кастомизации и после подтверждения применяет его. Вся работа идёт с хоста: если `/etc/aic` уже существует или выставлены переменные `REMOTE_CONTAINERS`, `DEVCONTAINER`, `AIC_TOOLS`, значит вы внутри песочницы, и запись в `.devcontainer/` заблокирована хуком PreToolUse — тогда скилл останавливается и просит запустить настройку из терминала хоста.

Кастомизация живёт только в файлах, которые принадлежат проекту: `Dockerfile.project`, `docker-compose.override.yml`, `chown-paths`, `post-create.project.sh`, `vscode-extensions`, `firewall-allowlist`, `shell-rc.zsh`, `statusline.{sh,mjs,js,py}`. Файлы `devcontainer.json` и `docker-compose.yml` трогать нельзя: их пишет `aic init`, а `aic sync` перезаписывает, выживают только выборы `AIC_TOOLS` и `AIC_SHELL`. Собирает не `aic up`, а `aic rebuild` — у управляемого Compose стоит `pull_policy: missing`, поэтому закэшированный образ переиспользуется и `Dockerfile.project` не выполняется.

Если скилл пишет `Dockerfile.project` или добавляет монтирование, `aic validate`, `up` и `rebuild` будут падать до тех пор, пока человек не выполнит `aic trust`. Команда требует TTY, из инструмента Bash её не запустить, и обойти это флагом `--allow-unsafe` нельзя. Доверие привязано к хешу конфигурации: любая правка `docker-compose.override.yml` или `Dockerfile.project` его снимает, так что конфиг стоит довести до финала до запроса.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add stefanoginella/aicontainer --skill setup -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add stefanoginella/aicontainer --skill setup -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add stefanoginella/aicontainer --skill setup -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install stefanoginella/aicontainer setup
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add stefanoginella/aicontainer --skill setup -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/stefanoginella/aicontainer --path tools/claude-plugin/skills/setup
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add stefanoginella/aicontainer --skill setup -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/stefanoginella/aicontainer/tree/HEAD/tools/claude-plugin/skills/setup/SKILL.md

## Когда брать
- определить стек проекта и решить, подходит ли ему Linux-devcontainer
- собрать план кастомизации песочницы под Python, Postgres или language server
- перенести настройки инструментов, алиасы и statusline в новое окружение
- разобраться, почему после `aic up` пропали все собранные инструменты
- пройти `aic trust` после правки `Dockerfile.project`

## Примеры запросов агенту
- Настрой aicontainer в этом проекте
- Проверь, что мы на хосте, и предложи план кастомизации под мой стек
- Обнови существующую настройку aicontainer под новый стек

## Похожие
- [devcontainer-setup](https://affpapa.org/nevibecode/skills/devcontainer-setup.md) — скилл · 5200 установок
- [setup-auditor](https://affpapa.org/nevibecode/skills/setup-auditor.md) — скилл · 469 установок
- [devcontainer](https://affpapa.org/nevibecode/skills/devcontainer.md) — скилл · 315 установок
- [docker-agent-run](https://affpapa.org/nevibecode/skills/docker-agent-run.md) — скилл · 746 установок
- [docker-sandboxes-network-credentials](https://affpapa.org/nevibecode/skills/docker-sandboxes-network-credentials.md) — скилл · 724 установки
- [sandbox-guard](https://affpapa.org/nevibecode/skills/sandbox-guard.md) — скилл · 483 установки

## Другие версии с тем же именем
- [setup · alirezarezvani](https://affpapa.org/nevibecode/skills/setup.md) — 1480 установок
- [setup · aws](https://affpapa.org/nevibecode/skills/aws-setup.md) — 1500 установок
- [setup · marketcalls](https://affpapa.org/nevibecode/skills/marketcalls-setup.md) — 2000 установок
- [setup · assistant-ui](https://affpapa.org/nevibecode/skills/assistant-ui-setup.md) — 6100 установок
- [setup · aladicf](https://affpapa.org/nevibecode/skills/aladicf-setup.md) — 605 установок

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

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