Dockerfile 别再让 AI 瞎写了——GitHub 官方这份 Skill 把规范焊死了

每次让 AI 给你写 Dockerfile，出来的版本都是一坨——几百 MB 起步、跑在 root、构建一次喝杯咖啡。这就是为什么 GitHub 官方把 multi-stage-dockerfile 这个 Skill 单独从 awesome-copilot 里拎出来沉淀成了一份工程规范。它不是教你写 Dockerfile，是直接把 Docker 官方推荐的多阶段构建范式,固化成 AI 复用的”操作手册”。

它解决了什么问题

大多数 AI 写出来的 Dockerfile 有三大通病：镜像臃肿、用 root 跑、构建缓存一塌糊涂。GitHub 官方这个 Skill 把答案提前编码到了 SKILL.md 里——构建阶段只装编译工具、运行时只拷产物、用 USER 切非 root、严格固定基础镜像版本号。AI 一旦接上,产出的 Dockerfile 就直接是 GitHub Container Registry 那种”生产可发”的水平,而不是 Demo 级。

核心亮点

• 分层缓存策略:明确要求”高频变更放后面”(代码 COPY 在 npm ci 之后),从源头解决 CI 上 docker build 慢如蜗牛的老毛病。
• 镜像最小化:推崇 distroless、alpine、slim 基础镜像,能少一个包就少一个包,攻击面顺手砍掉。
• 安全默认开启:USER 切非 root、移除构建工具、用 HEALTHCHECK 探活——不是建议,是”必须”。
• 语言无关:不是只服务 Node,Python/Go/Java/Rust 全都能套这套骨架。

开发者值得装它的理由

对个人开发者,装上之后你跟 Claude Code 说”帮我写个 Dockerfile”,得到的版本直接能 push 上 GHCR。对团队,你可以把这个 Skill 拉进 .github/skills/,所有成员共享同一份容器化规范,Code Review 阶段再也不用反复纠正镜像大小。配合 GitHub Actions 的 docker/build-push-action,从提交到镜像全链路打通。

更狠的是它走的还是 GitHub CLI v2.90.0+ 的 gh skill install 原生命令,一条命令钉到具体 commit SHA,供应链可追溯——这不是”装个提示词”,这是把 Dockerfile 写法的工程治理做成了 Skill 化的范本。

仓库整体 38.4k stars、整集合 2.2M installs,388 个 Skill 里它是开发者基建类最高频的那批。建议每个写后端/写全栈的同学,把它和 git-commit、refactor 一起放进仓库根目录。

👉 GitHub 仓库直链

GitHub: https://github.com/github/awesome-copilot/tree/main/skills/multi-stage-dockerfile