はじめに

ソフトウェア開発には「コードを書く」以外にも多くの定型作業があります。PR作成、コードレビュー、テスト作成、ドキュメント更新、リリースノート生成——これらの作業は重要ですが、時間がかかり、つい後回しになりがちです。

Claude Codeは対話的なコーディング支援だけでなく、これらのワークフロー全体を自動化する能力を持っています。本記事では、Claude Codeの機能を組み合わせて業務ワークフローを自動化する具体的な方法を解説します。

自動化を支える3つの機能

1. APIモード（--print）

Claude Codeを非対話型で実行し、スクリプトやCIパイプラインから呼び出します。

claude -p --output-format json "タスクの指示"

2. Hooks

ツール実行の前後にカスタムスクリプトを挿入し、承認フロー・ログ記録・通知を自動化します。

3. Custom Skills

頻出タスクをスラッシュコマンドとしてテンプレート化し、チーム全体で再利用できるようにします。

自動化パターン1：PR自動レビュー

PRが作成されたタイミングでClaude Codeが自動的にコードレビューを行い、コメントを投稿するワークフローです。

セットアップ

GitHub Actionsを使った実装例です。

name: Auto Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Claude Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          npm install -g @anthropic-ai/claude-code
          DIFF=$(git diff origin/main...HEAD)
          REVIEW=$(echo "$DIFF" | claude -p \
            "このPRのdiffをレビューして。以下の観点でチェック：
            1. バグの可能性
            2. セキュリティリスク
            3. パフォーマンスの問題
            4. コーディング規約への準拠
            結果をMarkdownで出力して。")
          echo "$REVIEW" > review.md

効果

導入チームからの報告では、以下の効果が確認されています。

• レビュー待ち時間が平均2日→数分に短縮
• 人間のレビュアーが「本質的な設計レビュー」に集中できるように
• 軽微なバグ（typo、未使用変数、エラーハンドリング漏れ）の検出率が向上

自動化パターン2：リリースノート自動生成

スプリント終了時やリリース時に、マージされたPRからリリースノートを自動生成します。

#!/bin/bash
# generate-release-notes.sh

SINCE_TAG=$(git describe --tags --abbrev=0)
COMMITS=$(git log ${SINCE_TAG}..HEAD --oneline)
PRS=$(gh pr list --state merged --search "merged:>=$(git log -1 --format=%ci $SINCE_TAG | cut -d' ' -f1)" --json title,number,labels)

NOTES=$(echo "$PRS" | claude -p \
  "以下のマージ済みPR一覧からリリースノートを生成して。
  カテゴリ（新機能/改善/バグ修正/その他）に分類して。
  各項目はPR番号へのリンク付きで。
  フォーマットはKeep a Changelog形式で。")

echo "$NOTES"

自動化パターン3：依存関係の自動更新

定期的に依存関係の更新を確認し、安全な更新を自動的にPRとして作成します。

#!/bin/bash
# update-dependencies.sh（cronで週1実行）

claude -p --max-turns 10 \
  "以下の手順で依存関係を安全に更新して：
  1. npm outdatedで更新可能なパッケージを確認
  2. patchバージョンの更新を適用
  3. npm testでテストを実行
  4. テストが通った場合のみ、変更をコミット
  5. 更新内容をまとめたPRの説明文を生成"

自動化パターン4：日次コード品質レポート

毎朝、コードベースの品質指標をレポートとして生成し、Slackに投稿します。

#!/bin/bash
# daily-quality-report.sh

REPORT=$(claude -p --max-turns 5 --output-format json \
  "以下の観点でプロジェクトの品質を分析して：
  1. テストカバレッジの状況
  2. TypeScriptの型エラー（npx tsc --noEmit）
  3. ESLintの警告・エラー数
  4. TODO/FIXMEコメントの数と内容
  5. 直近1週間で追加された技術的負債
  結果をJSON形式で出力して。")

# Slack Webhookで通知
curl -X POST "$SLACK_WEBHOOK_URL" \
  -H 'Content-Type: application/json' \
  -d "{\"text\": \"📊 日次コード品質レポート\n$(echo $REPORT | jq -r '.result')\"}"

Custom Skillsによるチーム標準化

Custom Skillsを使って、チーム共通のワークフローをスラッシュコマンドとしてテンプレート化します。

プロジェクトの.claude/skillsディレクトリに配置

<!-- .claude/skills/create-pr.md -->
# PRの作成

以下の手順でPRを作成してください：
1. 現在のブランチの変更内容を分析
2. Conventional Commits形式のコミットメッセージを生成
3. 変更内容からPRのタイトルと説明文を生成
4. テストが通ることを確認
5. gh pr create でPRを作成

PRの説明文には以下を含めてください：
- 変更の概要
- テスト方法
- レビュアーへの注意点

チームメンバーは/create-prと入力するだけで、標準化されたプロセスでPRを作成できます。

段階的な導入アプローチ

ワークフロー自動化は一気に進めるのではなく、段階的に導入することを推奨します。

Step 1：手動実行（1-2週目）

Claude Codeのコマンドを手動で実行し、出力結果を人間が確認してから適用します。

Step 2：半自動化（3-4週目）

スクリプト化するが、最終的な適用は人間が承認するフローにします。

Step 3：完全自動化（5週目以降）

十分な信頼性が確認できた作業のみ、完全自動化に移行します。

手動 → 半自動 → 完全自動
（すべてのステップで監視とフィードバックループを維持）

コスト管理のポイント

自動化を進めると、APIの呼び出し回数が増えてコストが膨らむ可能性があります。

• --max-turnsの設定 — 各自動化タスクに必ず上限を設定
• モデルの使い分け — 簡単なタスクはSonnet、複雑なタスクはOpusを使用
• キャッシュの活用 — 同じ分析を繰り返さないようにキャッシュを実装
• 月次レビュー — トークン消費量を月次で確認し、不要な自動化を見直す

まとめ

Claude Codeによるワークフロー自動化は、「コードを書く」だけでなく開発プロセス全体の効率化を実現します。APIモード、Hooks、Custom Skillsの3つの機能を組み合わせることで、PR作成からリリースノート生成まで幅広いタスクを自動化できます。まずは最も時間のかかっている定型作業を一つ選んで自動化してみることから始めてみてください。