用途:该技能面向容器化开发,把包安装和代码执行都放进 Docker 容器,避免污染主机,并让不同项目的环境保持一致。核心思路是 Docker 优先。
主要能力:命令在容器内执行;阻止主机上的 npm、npx、yarn、pnpm、node、tsx、bun 等命令,并建议或转换为 docker exec;执行前自动检查容器状态。
使用方式:首次启动容器用 docker compose --profile dev up -d,用 docker ps --filter "name=my-project" 验证;在容器内运行命令如 docker exec my-project-dev-1 npm install、npm test、npm run build。在 Claude Code 中不要加 -it,否则会报 not a TTY。执行任何 npm/node 命令前必须先检查容器是否运行。
适用场景:需要隔离依赖、可复现环境、跨项目避免版本冲突时使用,例如安装依赖、测试、类型检查、构建与数据库迁移。
限制:npm run dev 一般由 docker-compose 负责,不必再 exec;git 和文件编辑在主机进行,源码通过卷挂载自动同步;node_modules 只存在于容器命名卷中。配置、健康检查、原生模块等更多内容见项目内 setup.md 与 health-checks.md。相关技能包括 docker-enforce、docker-optimizer、docker-guard。