dockerfile-audit/
├── SKILL.md            # 入口：frontmatter + 指令（必需）
├── checks.md           # 规则细则参考（按需加载，不进主上下文）
└── scripts/
    └── audit.py        # 确定性扫描脚本（被执行，不被加载进上下文）

mkdir -p ~/.claude/skills/dockerfile-audit/scripts

---
name: dockerfile-audit
description: 审查 Dockerfile 的安全隐患与镜像瘦身机会。当用户提到 Dockerfile 审查、镜像安全、容器加固、镜像瘦身、减小镜像体积时使用。输出按严重级别排序、带行号与修复命令的清单。
argument-hint: [Dockerfile路径，默认 ./Dockerfile]
disable-model-invocation: true
allowed-tools: Bash(python3 *)
---

#!/usr/bin/env python3
"""Dockerfile 静态扫描：安全 + 瘦身。仅依赖标准库。"""
import json, re, sys
from pathlib import Path

SEV = {"CRITICAL": 0, "HIGH": 1, "MEDIUM": 2, "LOW": 3}
SECRET = re.compile(r"(?i)(password|passwd|secret|token|api[_-]?key|private[_-]?key|aws_access)")

def audit(path):
    lines = Path(path).read_text(errors="replace").splitlines()
    findings, has_user, has_hc, stages, bases = [], False, False, 0, []
    for i, raw in enumerate(lines, 1):
        s, up = raw.strip(), raw.strip().upper()
        m = re.match(r"FROM\s+(\S+)", s, re.I)
        if m:                                          # FROM 行：版本锁定 + 基础镜像体积
            img = m.group(1); stages += 1; bases.append(img)
            if ":latest" in img or ("@" not in img and ":" not in img.split("@")[0]):
                findings.append({"line": i, "sev": "HIGH", "cat": "security", "rule": "unpinned-base",
                    "msg": f"基础镜像未锁版本/用 :latest ({img})，应固定到 digest 或明确 tag"})
            if re.search(r"(ubuntu|debian|centos|fedora)\b", img, re.I) and "slim" not in img:
                findings.append({"line": i, "sev": "MEDIUM", "cat": "size", "rule": "heavy-base",
                    "msg": f"完整 OS 镜像 ({img})，可换 alpine/distroless/slim"})
        if up.startswith("USER "): has_user = True
        if up.startswith("HEALTHCHECK"): has_hc = True
        if re.match(r"ADD\s+https?://", s, re.I):
            findings.append({"line": i, "sev": "LOW", "cat": "security", "rule": "add-url",
                "msg": "ADD 远程 URL 不可复现且有供应链风险，改 COPY + 多阶段"})
        if re.match(r"COPY\s+\.\s+", s, re.I):
            findings.append({"line": i, "sev": "HIGH", "cat": "security", "rule": "copy-dot-all",
                "msg": "COPY . 会把 .git/.env/密钥一起带进镜像，配 .dockerignore 并精确指定路径"})
        if (up.startswith("ENV ") or up.startswith("ARG ")) and SECRET.search(s):
            findings.append({"line": i, "sev": "CRITICAL", "cat": "security", "rule": "secret-in-layer",
                "msg": "ENV/ARG 疑似硬编码密钥，构建层会永久留存，改运行期注入"})
        if "apt-get install" in s and "--no-install-recommends" not in s:
            findings.append({"line": i, "sev": "LOW", "cat": "size", "rule": "apt-recommends",
                "msg": "未加 --no-install-recommends，装入推荐包"})
        if "apt-get install" in s and not any("rm -rf /var/lib/apt" in l for l in lines[i:i+5]):
            findings.append({"line": i, "sev": "MEDIUM", "cat": "size", "rule": "apt-no-clean",
                "msg": "apt 安装后未同层清理 /var/lib/apt/lists，缓存烤进镜像"})
        if re.match(r"apt-get\s+(upgrade|dist-upgrade)", s, re.I):
            findings.append({"line": i, "sev": "MEDIUM", "cat": "size", "rule": "apt-upgrade",
                "msg": "apt-get upgrade 让层不可复现且增大体积，交给基础镜像维护"})
    if not has_user:
        findings.append({"line": 0, "sev": "CRITICAL", "cat": "security", "rule": "runs-as-root",
            "msg": "默认以 root 运行，增加 USER 指令指定非 root 用户"})
    if not has_hc:
        findings.append({"line": 0, "sev": "LOW", "cat": "security", "rule": "no-healthcheck",
            "msg": "缺少 HEALTHCHECK，编排器无法感知真实健康"})
    if stages <= 1:
        findings.append({"line": 0, "sev": "MEDIUM", "cat": "size", "rule": "no-multistage",
            "msg": "未多阶段构建，编译器/构建工具残留进最终镜像"})
    findings.sort(key=lambda f: (SEV[f["sev"]], f["line"]))
    return findings

if __name__ == "__main__":
    p = sys.argv[1] if len(sys.argv) > 1 else "Dockerfile"
    print(json.dumps({"file": p, "findings": audit(p)}, ensure_ascii=False, indent=2))

# Dockerfile 安全 + 瘦身双体检

对给定 Dockerfile 做静态扫描并给出可执行修复建议。审查以确定性脚本结果为准，再补充脚本判断不了的上下文点。

## 目标文件
!`cat $ARGUMENTS 2>/dev/null || cat Dockerfile`

## 第一步：跑确定性扫描
执行内置脚本，得到结构化发现（JSON）：
```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/audit.py "${CLAUDE_PROJECT_DIR}/$ARGUMENTS"
```

## 第二步：补充上下文判断
脚本只做规则匹配。请结合上面读到的真实 Dockerfile 内容，补充脚本无法判断的问题，至少检查：
- WORKDIR 是否是写死的绝对路径、是否配合 chown 避免权限坑；
- ENTRYPOINT/CMD 是否暴露了调试端口或 shell 注入面（如 `sh -c` 直接拼变量）；
- 多个 RUN 是否能合并成一层以减少镜像层数；
- .dockerignore 是否配套（如脚本里命中 copy-dot-all，务必点名提醒）。

## 输出格式
严格按下表结构输出，按严重级别排序，每条含：级别、类别(安全/瘦身)、所在行、规则名、问题、**可直接执行的修复命令或片段**。最后给一段「优先修前三项」的总结，并估算瘦身收益（如「换 alpine + 多阶段预计 -180MB」）。

完整规则细则见 [checks.md](checks.md)。

## runs-as-root (CRITICAL, security)
**为何危险**：容器以 uid 0 运行，逃逸即获宿主 root。
**修复**：
    RUN groupadd -r app && useradd -r -g app app
    USER app

/dockerfile-audit

/dockerfile-audit services/api/Dockerfile

FROM ubuntu:latest
ENV DB_PASSWORD=s3cret
RUN apt-get update && apt-get install -y python3 pip curl vim
COPY . /app
RUN pip install -r /app/requirements.txt
CMD ["python3", "/app/main.py"]

flowchart TD
    A["你敲 /dockerfile-audit api/Dockerfile"] --> B["Claude Code 渲染 SKILL.md"]
    B --> C{"动态注入 !`cat Dockerfile`"}
    C -->|替换为真实文件内容| D["$ARGUMENTS → api/Dockerfile"]
    B --> E["模型读正文指令"]
    E --> F["跑 audit.py<br/>确定性规则匹配"]
    F --> G["输出 JSON 发现"]
    G --> H["模型结合真实文件<br/>补充上下文判断"]
    H --> I["按级别排序输出<br/>带行号+修复命令"]
    C -.失败/默认.-> J["cat Dockerfile"]
    style C fill:#fef3c7
    style F fill:#dbeafe
    style H fill:#dcfce7

/plugin install skill-creator@claude-plugins-official
/reload-plugins

请用 skill-creator 评测我的 dockerfile-audit 技能