name: help-dockerfile description: Dockerfile の作成・改善を支援する。「Dockerfile を作って」「Dockerfile 作成」「Dockerfile をレビュー」「Dockerfile 改善」「Dockerfile 最適化」「Dockerfile lint」「マルチステージビルド」「alpine 化」「イメージサイズ削減」「Dockerfile のベストプラクティス」などで起動。 allowed-tools: [Read, Write, Edit, Glob, Bash] context: fork agent: shiiman-docker:dockerfile-reviewer

Help Dockerfile

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

対応操作

実行手順

1. 意図の判定

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

2. 新規作成の場合

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

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

言語別テンプレート生成

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

# 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 検出時):

# 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 検出時):

# 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 の存在確認

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

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

以下の観点で解析:

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

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

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

出力フォーマット（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 をマルチステージに変換:

# 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
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）
• ❌ 機密情報をハードコードしない