К основному содержанию
скилл CX Codex

skillshare-devcontainer — скилл для Claude Code: тесты в контейнере

Скилл skillshare-devcontainer гоняет команды ss, Go-тесты и веб-интерфейс skillshare внутри devcontainer, чтобы на macOS не получить тихо неверный результат.

MIT ★ 3 269 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add runkids/skillshare --skill skillshare-devcontainer -a claude-code
Открыть на GitHub

Что делает skillshare-devcontainer

Скилл держит все запуски внутри devcontainer: ss и skillshare, go test, make test, make check, старт веб-интерфейса. Хост тут macOS, а бинарник проекта собран под Linux, поэтому та же команда на хосте либо падает, либо отдаёт неверный результат молча. Перед работой скилл просит выполнить python3 scripts/ai-context.py testing и дальше опирается на этот раздел как на источник правил по тестам.

Внутри контейнера исходники лежат в /workspace через bind-mount. Обёртка ss собирает бинарник при каждом вызове, так что после правки файлов на хосте можно сразу делать docker exec $CONTAINER ss <команда> без make build и перезапуска. Для проверок, которые меняют конфиг (init, install, sync), есть ssenv: отдельные HOME-каталоги вида ~/.ss-envs/<name>/, чтобы не портить состояние контейнера по умолчанию.

Контейнер поднимается одной командой make devc, рядом стоят make devc-up, make devc-down, make devc-reset. Веб-интерфейс запускается через docker exec $CONTAINER ui и открывается на http://localhost:45173, логи лежат в /tmp/api-dev.log и /tmp/vite-dev.log. Git-команды и правку кода скилл не трогает — это остаётся на хосте. E2E-прогоны он отдаёт другому скиллу, cli-e2e-test, потому что там своя изоляция через ssenv.

Какие задачи решает

  • прогнать Go-тесты в Linux-контейнере, а не на macOS-хосте
  • проверить ss install в чистом HOME через ssenv
  • воспроизвести баг из репорта в изолированном окружении
  • поднять веб-интерфейс skillshare и посмотреть логи
  • убедиться, что правка в исходниках подхватилась без пересборки

Примеры запросов агенту

  • Прогони go test ./internal/install/... в devcontainer и покажи, какие тесты упали
  • Создай ssenv-окружение и проверь в нём ss sync
  • Запусти веб-интерфейс skillshare в контейнере

Как установить skillshare-devcontainer

1Через Skills CLI (Vercel)

npx skills add runkids/skillshare --skill skillshare-devcontainer -a claude-code

2Вручную: положить файлы

~/.claude/skills/skillshare-devcontainer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/skillshare-devcontainer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о skillshare-devcontainer

Как установить skillshare-devcontainer в Claude Code?

Выполните npx skills add runkids/skillshare --skill skillshare-devcontainer -a claude-code. Файл скилла появится в ~/.claude/skills/skillshare-devcontainer/SKILL.md.

Что делает skillshare-devcontainer?

Запускает CLI, тесты и веб-интерфейс skillshare внутри devcontainer. Сначала он читает python3 scripts/ai-context.py testing, потом действует по правилам из этого раздела.

Почему команды нельзя запускать прямо на хосте?

Хост — macOS, а бинарник проекта собран под Linux. На хосте команда либо упадёт, либо выдаст неверный результат без ошибки, поэтому нужен docker exec в контейнер.

Исходный текст

SKILL.md · MIT
---
name: skillshare-devcontainer
description: >-
  Run CLI commands, tests, and debugging inside the skillshare devcontainer.
  Use this skill whenever you need to: execute skillshare CLI commands for
  verification, run Go tests (unit or integration), reproduce bugs, test new
  features, start the web UI, or perform any operation that requires a Linux
  environment. All CLI execution MUST happen inside the devcontainer — never
  run skillshare commands on the host. If you are about to use Bash to run
  `ss`, `skillshare`, `go test`, or `make test`, stop and use this skill
  first to ensure correct container execution.
argument-hint: "[command-to-run | task-description]"
metadata: 
  targets: [claude, universal]
---

Execute CLI commands and tests inside the devcontainer. The host machine is macOS but the project binary is Linux — running CLI commands on the host will silently produce wrong results or fail. This skill prevents that mistake.

Before acting, run `python3 scripts/ai-context.py testing` and follow that topic. The topic is the source of truth for repository execution boundaries and test rules; this skill retains the interactive workflow and command recipes.

## When to Use This

- Running `ss` / `skillshare` commands for verification
- Running `go test`, `make test`, `make check`
- Reproducing a bug report
- Testing a feature you just implemented
- Starting the web UI dashboard
- Any command that needs the skillshare binary or Go toolchain

## When NOT to Use This

- Editing source code (do that on host via Read/Edit tools)
- Running `git` commands (git works on host)
- Running `make fmt`, `make lint` (host-safe Go toolchain commands; no container needed)
- E2E test runbooks → use `cli-e2e-test` skill instead (it handles ssenv isolation)

## Architecture: Two Layers of Isolation

```
Host (macOS)
  └─ Devcontainer (Linux, Debian-based)
       ├─ Default HOME: /home/developer (persistent volume)
       ├─ Source: /workspace (bind-mount of repo root)
       └─ ssenv environments: ~/.ss-envs/<name>/ (isolated HOME dirs)
```

**Devcontainer** = Linux environment with Go, git, pnpm, air (hot-reload). Source code is at `/workspace` (bind-mount of the host repo). The `ss` / `skillshare` wrapper auto-builds from source on every invocation — **no manual `make build` needed**. Edit code on the host, then immediately `docker exec` to run it; the change is picked up automatically.

**ssenv** = Isolated HOME directories within the devcontainer. Each env gets its own `~/.config/skillshare/`, `~/.claude/`, etc. Use ssenv when you need a clean state (testing init, install, sync) without polluting the container's default HOME.

## Zero-Rebuild Workflow

Source code is bind-mounted into the container at `/workspace`. The `ss` wrapper runs `go build` transparently on every invocation:

1. Edit files on host (Read/Edit tools)
2. `docker exec $CONTAINER ss <command>` — picks up your changes instantly
3. No `make build`, no restart, no rebuild step

This also applies to `go test` — tests always compile against the latest source. The Web UI backend uses `air` for hot-reload (same zero-rebuild experience).

## Entering the Devcontainer

The quickest way — one command builds, initialises, and enters the shell:

```bash
make devc           # build + init + interactive shell (one step)
make devc-up        # start only (no shell)
make devc-down      # stop
make devc-restart   # restart + re-run start-dev.sh
make devc-reset     # full reset (remove volumes), then `make devc` to re-init
make devc-status    # show container status
```

Works with **or without** VS Code — `make devc` handles the full lifecycle autonomously.

### Programmatic access (for `docker exec` workflows)

```bash
CONTAINER=$(docker compose -f .devcontainer/docker-compose.yml ps -q skillshare-devcontainer 2>/dev/null)
```

If `$CONTAINER` is empty, tell the user:
> Devcontainer is not running. Start it with `make devc-up`.

Then verify the binary:
```bash
docker exec $CONTAINER bash -c \
  '/workspace/.devcontainer/ensure-skillshare-linux-binary.sh && ss version'
```

## Running Commands

### Simple command (uses container's default HOME)

```bash
docker exec $CONTAINER ss <command> [flags]
```

Good for: `ss version`, `ss status`, `ss list`, `ss check`, `ss audit`.

### Command with isolated HOME (clean state)

```bash
ENV_NAME="test-$(date +%s)"
docker exec $CONTAINER ssenv create "$ENV_NAME" --init
docker exec $CONTAINER ssenv enter "$ENV_NAME" -- ss status
# Cleanup when done:
docker exec $CONTAINER ssenv delete "$ENV_NAME" --force
```

Good for: testing `init`, `install`, `sync`, `uninstall` — anything that modifies config/state.

### Multi-command sequence

```bash
docker exec $CONTAINER ssenv enter "$ENV_NAME" -- bash -c '
  ss install runkids/demo-skills --track --force
  ss list
  ss sync
'
```

Always use `bash -c '...'` for multi-command sequences inside `ssenv enter`.

### Go tests

```bash
# All tests (unit + integration)
docker exec $CONTAINER bash -c 'cd /workspace && make test'

# Unit tests only
docker exec $CONTAINER bash -c 'cd /workspace && make test-unit'

# Integration tests only
docker exec $CONTAINER bash -c 'cd /workspace && make test-int'

# Specific test
docker exec $CONTAINER bash -c 'cd /workspace && go test ./tests/integration -run TestInit_Fresh -count=1'

# Specific package
docker exec $CONTAINER bash -c 'cd /workspace && go test ./internal/install/... -count=1'
```

Always `cd /workspace` before Go commands — ssenv changes HOME which can break module resolution.

### Go tests with auth disabled

Token-resolution tests (`TestResolveToken`, `TestAuthEnv` in `internal/install`) need auth credentials removed:

```bash
docker exec $CONTAINER bash -lc '
  eval "$(credential-helper --eval off)"
  cd /workspace
  go test ./internal/install -run "TestResolveToken|TestAuthEnv" -count=1
  eval "$(credential-helper --eval on)"
'
```

## Web UI Dashboard

```bash
# Start (global mode)
docker exec $CONTAINER ui

# Start (project mode — uses ~/demo-project)
docker exec $CONTAINER ui -p

# Stop
docker exec $CONTAINER ui stop
```

Dashboard accessible at `http://localhost:45173` (Vite dev server with HMR).
API backend at `http://localhost:49420`.
Logs: `/tmp/api-dev.log`, `/tmp/vite-dev.log`.

## ssenv Quick Reference

| Shortcut | Full form | Purpose |
|----------|-----------|---------|
| `ssnew <name>` | `ssenv create <name>` + enter | Create and enter isolated shell |
| `ssuse <name>` | `ssenv enter <name>` | Enter existing isolated shell |
| `ssrm <name>` | `ssenv delete <name> --force` | Delete environment |
| `ssls` | `ssenv list` | List all environments |
| `ssback` | `ssenv reset` | Leave isolated context |
| `sshelp` | `help` | Show all devcontainer commands |

For automation (non-interactive), prefer `ssenv enter <name> -- <command>` over `ssnew`/`ssuse` (which launch subshells).

## Ports

| Port | Service | Notes |
|------|---------|-------|
| 45173 | Vite dev server | React dashboard with HMR |
| 49420 | Go API backend | `skillshare ui` server |
| 48888 | Docusaurus | `docs` command in devcontainer |

## Common Mistakes to Avoid

1. **Running `ss` on host** — macOS binary won't match Linux container; always `docker exec`
2. **Forgetting `cd /workspace`** — Go tests fail if HOME was changed by ssenv
3. **Using `make test` on host** — builds macOS binary, then tests run against wrong arch
4. **Skipping `--init` on ssenv create** — env won't have config; most commands will fail
5. **Not cleaning up ssenv** — `ssenv delete <name> --force` after done; or ask user
6. **Running from /workspace root without -g** — the `ss` wrapper auto-redirects to `~/demo-project` in project mode; use `-g` for global or set `SKILLSHARE_DEV_ALLOW_WORKSPACE_PROJECT=1`
7. **Running `make build` before testing** — unnecessary; the `ss` wrapper auto-builds from source every time

## Rules

Apply the `testing` topic. If a command recipe here conflicts with that topic or current repo configuration, verify the current configuration and update both in the same change.

© runkids · MIT · runkids/skillshare

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
devcontainer-setup trailofbits Скилл devcontainer-setup для Claude Code создаёт изолированный devcontainer с предустановленным Claude Code, инструментами для Python, Node, Rust или Go и постоянными томами. Контейнер изолирует запуск агента в песочнице проекта. CX Codex +1 5 800установок devcontainer jwynia Диагностирует сбои в devcontainer.json, ускоряет запуск контейнеров и помогает настроить одинаковое окружение для локальной VS Code и GitHub Codespaces. CX Codex +1 329установок devcontainer-mcp aniongithub Сервер devcontainer-mcp переносит запуск тестов, сборку и команды ИИ-агента в изолированные dev-контейнеры. Это защищает рабочую машину от лишних пакетов и случайных правок в системе. CX Codex +1 ★ 28звёзд репо verify официальный anthropics Скилл verify для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который тестирует изменения в harness end-to-end без Docker. CX Codex +1 257установок setup stefanoginella Скилл setup проводит проект от «песочницы нет» до запуска ИИ-агента внутри devcontainer aicontainer с настройкой под конкретный стек. CX Codex +1 ★ 23звёзд репо env-scout Gordon Mickel Субагент env-scout сканирует репозиторий на наличие шаблонов .env, Docker, скриптов сборки и документации. Работает внутри оркестратора flow-next. CX Codex ★ 730звёзд репо

Из того же набора10

Весь набор →
skillshare-code-review Скилл skillshare-code-review для Claude Code проверяет изменения в skillshare до создания PR или в открытом pull request. Запускается по просьбе разобрать diff, ветку, диапазон коммитов или PR. CX Codex +1 ★ 3 269звёзд репо skillshare-changelog Скилл skillshare-changelog собирает запись в CHANGELOG.md из коммитов в conventional-формате и переносит её на страницу changelog сайта. CX Codex +1 ★ 3 269звёзд репо skillshare-windows-utm Скилл skillshare-windows-utm проверяет работу skillshare на гостевой Windows в UTM: собирает коммит в devcontainer, передаёт бинарники в виртуалку и запускает E2E-тесты путей и симлинков. CX Codex +1 ★ 3 269звёзд репо skillshare-implement-feature Скилл skillshare-implement-feature ведёт реализацию Go-фичи от спецификации до проверок по TDD. Подходит для новых CLI-команд, флагов и внутренних пакетов. CX Codex +1 ★ 3 269звёзд репо skillshare-release Скилл skillshare-release помогает готовить и проверять релизы skillshare: сверяет PR от Release Please, обновляет документацию и инспектирует черновики. CX Codex +1 ★ 3 269звёзд репо skillshare Управляет ресурсами Skillshare CLI: синхронизирует скиллы и настройки между инструментами, проверяет конфигурацию и работает с общей памятью. CX Codex +1 ★ 3 269звёзд репо skillshare-ui-website-style Скилл skillshare-ui-website-style для Claude Code держит дизайн-систему Skillshare в React-дашборде и сайте на Docusaurus. Покрывает правку стилей и добавление компонентов без расхождения с токенами. CX Codex +1 ★ 3 269звёзд репо skillshare-cli-e2e-test Скилл skillshare-cli-e2e-test запускает изолированные E2E-тесты CLI в devcontainer по сценариям из ai_docs/tests с отчётами через mdproof. CX Codex +1 ★ 3 269звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой