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

shell-and-workflows — правило для Claude Code: Docker и тесты

Правило shell-and-workflows описывает работу с Docker-сервисами проекта, типовые команды и порядок запуска тестов. Помогает выбрать, где выполнять фронтенд- и бэкенд-проверки.

Apache-2.0 ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install polar-skills@claude-settings
Открыть на GitHub

Что делает shell-and-workflows

В правиле собраны команды dev docker для входа в контейнеры, разового выполнения команд и повседневной работы: запустить сервисы, проверить их состояние, смотреть логи и остановить окружение. Для API и worker приведены команды миграций Alembic, для web — тесты и линтер на pnpm, для PostgreSQL — подключение к базе текущего экземпляра. Номер экземпляра и порты можно узнать через dev docker ports.

После git pull большинство изменений подхватывает hot reload; при изменении зависимостей правило предлагает перезапустить сервисы, а при изменениях Dockerfile или системных зависимостей — пересобрать их. Тесты бэкенда в контейнере api не запускаются: фикстуре нужен S3 на http://127.0.0.1:9000, недоступный контейнерам по этому адресу. Их запускают на хосте командой uv run task test согласно server/AGENTS.md; это ограничение важно учесть до проверки изменений.

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

  • зайти в контейнер нужного сервиса для отладки
  • выполнить разовую команду внутри Docker без интерактивной оболочки
  • запустить миграцию базы данных или создать новую
  • проверить состояние сервисов и просмотреть логи
  • выбрать место запуска фронтенд- и бэкенд-тестов

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

  • Подскажи, как запустить сервисы проекта и проверить их состояние через dev docker.
  • Выполни текущую миграцию Alembic в контейнере api и покажи подходящую команду.
  • Где запускать тесты web и backend в этом проекте?

Как установить shell-and-workflows

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install polar-skills@claude-settings

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

.claude/rules/shell-and-workflows.md

Поле paths во frontmatter ограничивает файлы

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

Вопросы о shell-and-workflows

Как установить shell-and-workflows в Claude Code?

Выполните /plugin marketplace add fcakyon/claude-codex-settings? Ниже исправление без пробела: сначала /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install polar-skills@claude-settings.

Что делает правило shell-and-workflows?

Оно описывает команды для Docker-контейнеров проекта, работы с миграциями, базой данных, логами и тестами. Также объясняет, когда после git pull перезапустить или пересобрать сервисы.

Где запускать бэкенд-тесты?

На хосте, командой uv run task test согласно server/AGENTS.md. В контейнере api тесты не работают, потому что их фикстуре нужен S3 по адресу http://127.0.0.1:9000.

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

shell-and-workflows.md · Apache-2.0
---
title: Shell Access and Common Workflows
category: Operations
tags: shell, exec, workflows, testing
---

# Shell Access and Common Workflows

## Shell into a container

```bash
dev docker shell api      # Python env (api)
dev docker shell worker   # Python env (worker)
dev docker shell web      # Node env
dev docker shell db       # postgres container (shared)
```

For one-off commands without an interactive shell, use `exec`:

```bash
dev docker exec api uv run alembic current
dev docker exec db psql -U polar -d polar_dev_<N> -c "SELECT 1"
dev docker exec redis redis-cli -n <N> dbsize
```

`exec`/`shell` auto-route by service name: app services hit this instance's
`polar-app-<N>` project, infra services hit `polar-shared`.

## Useful in-container commands

**api / worker (Python):**
```bash
uv run alembic upgrade head                             # run migrations
uv run alembic revision --autogenerate -m "message"     # create a migration
uv run alembic current                                  # show current revision
```
(Backend tests are the exception — they don't run in this container; see below.)

**web (Node):**
```bash
pnpm test
pnpm lint
```

**db (PostgreSQL):** the database is per-instance, so pass `polar_dev_<N>`, not
`polar`:
```bash
psql -U polar -d polar_dev_<N>
```

## Common workflows

**Daily development:**
```bash
dev docker up -d --wait     # start and wait until serving
dev docker ps               # confirm status
dev docker logs -f api      # watch as you work
dev docker down             # stop when done (data persists)
```

**After a git pull:** hot-reload handles most changes. If deps changed:
```bash
dev docker restart api worker web        # picks up new deps via startup uv sync / pnpm
# only if a Dockerfile or system dep changed:
dev docker up -b -d api worker web
```

**Run tests:**

Frontend unit tests run in the web container:
```bash
dev docker exec web pnpm test
```

Backend tests do **not** run in the `dev docker` api container. The suite's
session-wide `empty_test_bucket` fixture hard-requires S3 at
`http://127.0.0.1:9000` with `testing`-prefixed buckets, but containers can't
reach `localhost:9000` on the host — they use `minio:9000` internally with
per-instance `polar-s3-<N>` buckets. Run backend tests on the host with the
standard setup in `server/AGENTS.md` (`uv run task test`).

**Database operations:**
```bash
dev docker exec api uv run alembic upgrade head
dev docker exec api uv run alembic downgrade -1
dev docker exec db psql -U polar -d polar_dev_<N>
```

Find `<N>` (and the real ports) for the current worktree with `dev docker ports`.

© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings

Похожие правила IDE

Все правила IDE по теме «DevOps и инфраструктура» →
shell-testing-framework manutej Скилл shell-testing-framework помогает проектировать тесты для Bash-скриптов: от структуры Arrange–Act–Assert до проверки покрытия и производительности. CX Codex +1 441установок shell-scripting Ryan Snodgrass Плагин shell-scripting настраивает агента на разработку надёжных Bash-скриптов с защитным программированием. Помогает писать код по стандарту POSIX и покрывать сценарии тестами. CX Codex ★ 42 780звёзд репо error-diagnostics Seth Hobson Плагин error-diagnostics для Claude Code отслеживает ошибки и помогает находить их первопричины при расследовании сбоев в продакшен-системах. CX Codex ★ 42 780звёзд репо maui-shell-navigation dotnet Скилл maui-shell-navigation для Claude Code настраивает Shell-навигацию в .NET MAUI: вкладки, меню и переходы между страницами. Разбирает передачу параметров и подтверждение ухода со страницы. CX Codex +1 4 200установок shell-scripting-pro davila7 Субагент shell-scripting-pro для Claude Code пишет и дорабатывает shell-скрипты для автоматизации, развёртывания и системного администрирования. Подключается к таким задачам и помогает обработать ошибки, процессы и файлы. CX Codex 1 479установок hyva-exec-shell-cmd hyva-themes Скилл hyva-exec-shell-cmd находит стек разработки Magento и оборачивает консольные вызовы для контейнеров или локальной системы. CX Codex +1 1 400установок

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

Весь набор →
ui-image-gallery Правило ui-image-gallery задаёт стандарты для мобильных галерей: заставляет ИИ использовать библиотеку @nandorojo/galeria вместо самодельных модальных окон на Modal. CX Codex +1 ★ 1 216звёзд репо rendering-resource-hints Правило rendering-resource-hints учит агента вставлять в React-компоненты вызовы API React DOM для подсказок браузеру о ресурсах. Встраивается в серверные компоненты, чтобы загрузка файлов стартовала раньше, чем клиент получит HTML. CX Codex +1 ★ 1 216звёзд репо animation-gesture-detector-press Правило animation-gesture-detector-press для Claude Code переносит анимацию нажатия кнопки React Native в UI-поток, без перехода в JS. Меняет масштаб или прозрачность при нажатии. CX Codex +1 ★ 1 216звёзд репо commit-staged Скилл commit-staged формирует структурированные коммиты: прогоняет diff через /simplify, смотрит только staged-файлы и собирает понятные сообщения из контекста сессии. CX Codex +1 ★ 1 216звёзд репо js-request-idle-callback Правило js-request-idle-callback учит агента уводить аналитику, сохранение состояния и предзагрузку в простой браузера, чтобы интерфейс не подвисал на кликах. CX Codex +1 ★ 1 216звёзд репо pr-comment-resolver Субагент pr-comment-resolver находит неразрешённые замечания в пуллреквесте, исправляет код и готовит черновики ответов рецензентам. Помогает закрыть ревью без ручного разбора тредов. CX Codex ★ 1 216звёзд репо list-performance-item-types Правило list-performance-item-types для Claude Code задаёт типы элементов в списках с разной разметкой. Оно подключается при работе с такими списками и настраивает раздельное переиспользование компонентов. CX Codex +1 ★ 1 216звёзд репо manage-instances Правило manage-instances для параллельного запуска нескольких изолированных стеков приложения в отдельных worktree, каждый со своей БД, Redis и портами. CX Codex +1 ★ 1 216звёзд репо

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

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