shell-and-workflows — правило для Claude Code: Docker и тесты
Правило shell-and-workflows описывает работу с Docker-сервисами проекта, типовые команды и порядок запуска тестов. Помогает выбрать, где выполнять фронтенд- и бэкенд-проверки.
Apache-2.0 ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install polar-skills@claude-settingsЧто делает 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-settings2Вручную: положить файлы
.claude/rules/shell-and-workflows.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/shell-and-workflows.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/shell-and-workflows.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/shell-and-workflows.mdВручную: положить файлы
.clinerules/shell-and-workflows.mdПо шагам, с командами для каждой платформы: 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