‹ 首页

polar-local-environment

@fcakyon · 收录于 1 周前 · 上游提交 6 天前

This skill should be used when setting up or managing Polar local development environment with Docker.

场景本地开发环境配置

适合你，如果需要在本地用 Docker 运行 Polar 开发环境

/ 下载安装
polar-local-environment.skill双击,或拖进 Claude 桌面版 / Cowork,即完成安装↓ .skill↓ .zip
用别的 agent?下载 .zip 解压,把文件夹放进它的技能目录
Claude Code~/.claude/skills/(项目级 .claude/skills/)
Codex CLI~/.codex/skills/
Cursor自动读取上面两处目录
其他工具见其文档的「skills」目录;两个下载是同一份文件,只是名字不同
/ 通过 npx 安装 校验哈希
npx oh-my-skill add fcakyon/claude-codex-settings/polar-local-environment
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- fcakyon/claude-codex-settings/polar-local-environment
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify fcakyon/claude-codex-settings/polar-local-environment
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
773GitHub stars
~550最小装载
~1K含声明引用
~2.8K文本包总量
镜像托管

怎么用

技能原文 SKILL.md作者撰写 · Apache-2.0 · 44b7c00

Local Environment Skill

This skill enables Claude to help manage the Polar local development environment using Docker. Use this when the user needs to start, stop, debug, or understand the local development stack.

Instance Auto-Detection

The dev docker command automatically detects the correct instance number. No manual -i flag is needed in most cases.

Detection priority:

  1. CONDUCTOR_PORT env var → (port - 55000) / 10 + 1
  2. Workspace path hash → stable instance derived from the repo root path

You can override with -i N if needed, but auto-detection handles Conductor workspaces automatically.

When to Use
  • User asks to start/stop the local environment
  • User needs to view logs or debug issues
  • User wants to run multiple isolated instances
  • User needs to understand the service architecture
  • User encounters container or service errors
Quick Reference

| Task | Command | |------|---------| | Start full stack | dev docker up -d | | Stop services | dev docker down | | View all logs | dev docker logs | | View service logs | dev docker logs {service} | | Follow logs | dev docker logs -f | | Check status | dev docker ps | | Restart service | dev docker restart {service} | | Shell access | dev docker shell {service} | | Fresh start | dev docker cleanup -f && dev docker up -d | | With monitoring | dev docker up --monitoring -d | | Force rebuild | dev docker up -b -d |

Services

| Service | Default Port | Description | |---------|-------------|-------------| | api | 8000 | FastAPI backend | | worker | - | Background job processor | | web | 3000 | Next.js frontend | | db | 5432 | PostgreSQL database | | redis | 6379 | Redis cache | | minio | 9000/9001 | S3-compatible storage | | prometheus | 9090 | Metrics (optional) | | grafana | 3001 | Dashboards (optional) |

Instance Port Mapping

Port = Base Port + (Instance × 100)

| Instance | API | Web | DB | Redis | MinIO | |----------|-----|-----|-----|-------|-------| | 0 | 8000 | 3000 | 5432 | 6379 | 9000 | | 1 | 8100 | 3100 | 5532 | 6479 | 9100 | | 2 | 8200 | 3200 | 5632 | 6579 | 9200 |

Rules Index

| Rule | Category | Description | |------|----------|-------------| | [service-architecture](rules/service-architecture.md) | Reference | Service details |

按 Apache-2.0 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。
…