本地调试（magic-stack）

magic-stack 是一个工具无关的全局技能：用于跨项目的本地 Docker 调试 —— adopt 已有容器、共享 infra（postgres/redis/kafka 等）、模板化的热更新应用容器、 Markdown 预览。安装到 ~/.magic-stack/。

本机启动 / 调试 / 联调任何服务都应走 magic-stack，而非裸 docker compose / docker run。

安装

magic-stack 作为 Claude Code 技能（skill）安装，安装后命令全局可用。

全局共享基础设施

magic-stack 维护一套共享 infra，端口统一 17XXX 前缀（与原服务默认端口解耦）：

服务	宿主端口
workbench（工作台）	17070
postgres	17432
redis	17379
kafka	17092

更多端口见 magic-stack 全局 infra 配置。