Agent skill

help-dockerfile

Dockerfile の作成・改善を支援する。「Dockerfile を作って」「Dockerfile 作成」「Dockerfile をレビュー」「Dockerfile 改善」「Dockerfile 最適化」「Dockerfile lint」「マルチステージビルド」「alpine 化」「イメージサイズ削減」「Dockerfile のベストプラクティス」などで起動。

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/help-dockerfile

SKILL.md

Help Dockerfile

Dockerfile の作成・改善を支援します。

対応操作

操作 トリガー例
新規作成 「Dockerfile を作って」「Dockerfile 作成」
レビュー/Lint 「Dockerfile をレビュー」「Dockerfile lint」「Dockerfile 改善」
最適化 「マルチステージビルド」「alpine 化」「サイズ削減」

実行手順

1. 意図の判定

  • 新規作成: 「作って」「作成」「生成」→ 新しい Dockerfile を作成
  • レビュー/Lint: 「レビュー」「lint」「改善」「チェック」→ Dockerfile を静的解析
  • 最適化: 「最適化」「alpine」「マルチステージ」「サイズ削減」→ 既存 Dockerfile を最適化

2. 新規作成の場合

プロジェクトの言語/フレームワーク特定

bash
ls package.json go.mod requirements.txt Gemfile pom.xml build.gradle Cargo.toml 2>/dev/null

言語別テンプレート生成

Node.js (package.json 検出時):

dockerfile
# Build stage
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci

# Production stage
FROM node:20-alpine
RUN addgroup -S app && adduser -S app -G app
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY . .
USER app
EXPOSE 3000
CMD ["node", "index.js"]

Go (go.mod 検出時):

dockerfile
# Build stage
FROM golang:1.22-alpine AS builder
WORKDIR /app
COPY go.* ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o main .

# Production stage
FROM scratch
COPY --from=builder /app/main /main
ENTRYPOINT ["/main"]

Python (requirements.txt 検出時):

dockerfile
# Build stage
FROM python:3.12-slim AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir --target=/app/deps -r requirements.txt

# Production stage
FROM python:3.12-slim
RUN useradd -m -r app
WORKDIR /app
ENV PYTHONPATH=/app/deps
COPY --from=builder /app/deps /app/deps
COPY . .
USER app
CMD ["python", "main.py"]

.dockerignore も同時に作成

.git
.gitignore
README.md
Dockerfile*
docker-compose*
.env*
*.log
node_modules
__pycache__
*.pyc
.pytest_cache
coverage
.coverage
dist
build
*.egg-info

3. レビュー/Lint の場合

Dockerfile の静的解析を行い、ベストプラクティスに基づいた提案をします。

Dockerfile の存在確認

bash
ls Dockerfile* docker/Dockerfile* 2>/dev/null

ベストプラクティスに基づいてチェック

以下の観点で解析:

セキュリティ（重要度: 高）:

チェック 問題 推奨
USER 指定 root で実行 非 root ユーザーを指定
機密情報 ハードコードされた秘密 ARG/ENV + ビルド時注入
ADD vs COPY リモート URL や tar 展開 COPY を優先
apt-get キャッシュ残存 rm -rf /var/lib/apt/lists/*

パフォーマンス（重要度: 中）:

チェック 問題 推奨
マルチステージ 単一ステージで大きいイメージ マルチステージビルド
レイヤー最適化 複数の RUN 1つの RUN に結合
.dockerignore 不要ファイルのコピー .dockerignore を作成
ベースイメージ フルイメージ使用 alpine/slim を検討

メンテナンス性（重要度: 低）:

チェック 問題 推奨
タグ固定 FROM node:latest FROM node:20-alpine
LABEL メタデータなし LABEL で情報追加
WORKDIR 相対パス使用 絶対パスを指定

出力フォーマット（Lint）

## Dockerfile 解析結果

**ファイル**: {path}
**ベースイメージ**: {base_image}
**ステージ数**: {stages}

---

### 問題点

| 重要度 | 行 | カテゴリ | 内容 | 推奨 |
|--------|-----|----------|------|------|
| 🔴 高 | 1 | セキュリティ | `FROM node:latest` | タグを固定: `FROM node:20-alpine` |
| 🔴 高 | 25 | セキュリティ | root ユーザーで実行 | `USER node` を追加 |
| 🟡 中 | 10-15 | パフォーマンス | 複数の RUN 命令 | 1つの RUN に結合 |
| 🟢 低 | - | メンテナンス | LABEL がない | メタデータを追加 |

---

### 改善版 Dockerfile（参考）

{最適化された Dockerfile の例}

4. 最適化の場合

既存の Dockerfile を読み込み、以下の観点で最適化:

マルチステージビルド化

単一ステージの Dockerfile をマルチステージに変換:

dockerfile
# Before
FROM node:20
WORKDIR /app
COPY . .
RUN npm install
CMD ["npm", "start"]

# After
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY . .
CMD ["npm", "start"]

alpine 化

フルイメージを alpine に変更:

Before After サイズ削減
node:20 node:20-alpine ~900MB → ~180MB
python:3.12 python:3.12-slim ~1GB → ~150MB
golang:1.22 golang:1.22-alpine ~800MB → ~250MB

レイヤー最適化

dockerfile
# Before
RUN apt-get update
RUN apt-get install -y curl
RUN apt-get install -y git
RUN rm -rf /var/lib/apt/lists/*

# After
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
        curl \
        git && \
    rm -rf /var/lib/apt/lists/*

5. 出力フォーマット

## Dockerfile 作成完了

**ファイル**: Dockerfile
**ベースイメージ**: {base_image}
**ステージ数**: {stages}
**推定サイズ**: {estimated_size}

### 特徴

- ✅ マルチステージビルド
- ✅ 非 root ユーザー
- ✅ alpine ベースイメージ
- ✅ .dockerignore 同梱

### 次のステップ

1. `docker build -t myapp .` でビルド
2. `docker run -p 3000:3000 myapp` で実行

注意事項

  • ✅ マルチステージビルドを推奨
  • ✅ alpine/slim イメージを推奨
  • ✅ 非 root ユーザーでの実行を推奨
  • ✅ .dockerignore を同時に作成
  • ✅ レビューは /shiiman-docker:lint に委譲（SSOT）
  • ❌ 機密情報をハードコードしない

Didn't find tool you were looking for?

Be as detailed as possible for better results