CI/CDの前に止める：pre-commitフレームワーク導入によるコード品質の強制 (v3.x対応)

17 June 2025

Update: 13 January 2026

「タイポ修正」や「リンター適用」といったコミットメッセージを、プロジェクトの履歴で何度も目にしていませんか？このような些細なミスは、コードレビューの過程でシニアエンジニアの時間を無駄に消費させ、チーム全体の生産性を低下させる主犯格です。人間が気をつける精神論で解決しようとするのは間違いです。もし、これらのミスをコミットボタンを押した瞬間に自動的に修正できるとしたらどうでしょうか？ここでは、Gitフックのネイティブ機能をラップし、チーム全体で設定を共有可能なpre-commitフレームワークの導入について、現場レベルの視点で解説します。

なぜシェルスクリプトのGitフックでは不十分なのか

多くの現場で、.git/hooks/pre-commit に直接シェルスクリプトを書こうとする動きが見られますが、これはすぐに破綻します。理由は単純で、.git ディレクトリ内のフックファイルはバージョン管理の対象外だからです。

開発者が各自でスクリプトをコピー＆ペーストして権限を付与する運用は、スケーラビリティがありません。誰かが環境構築を忘れた瞬間、フォーマットの崩れたコードがリポジトリに混入し、CIパイプラインを破壊します。

注意： CI/CDでのチェックは「最終防衛ライン」であり、フィードバックループが遅すぎます。ローカル環境でコミットする瞬間に弾くのが、最も低コストな品質管理です。

ここで紹介するPython製の pre-commit フレームワークは、.pre-commit-config.yaml という単一の設定ファイルをリポジトリで管理するだけで、全開発者のフック実行環境を統一します。言語に依存せず、Node.js、Go、Terraformなどあらゆるプロジェクトに適用可能です。

The Solution: 構成と実装

以下は、Python (Black, Flake8) と JavaScript (Prettier) が混在するプロジェクトにおいて、コミット時に自動修正とチェックを走らせるための実戦的な設定です。末尾の改行修正や巨大ファイルのコミット防止も標準機能で行います。

1. インストール

Homebrewまたはpipでインストールします。これはローカル環境に一度だけ行えば良い作業です。

pip install pre-commit
# または
brew install pre-commit

2. 設定ファイル (.pre-commit-config.yaml)

リポジトリルートに配置します。特定のバージョンを固定することで、チーム全員が同じルールの下で開発できます。

repos:
  # 基本的なファイルチェック
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.4.0
    hooks:
      - id: trailing-whitespace  # 行末の不要なスペース削除
      - id: end-of-file-fixer    # ファイル末尾の改行確保
      - id: check-yaml           # YAML構文チェック
      - id: check-added-large-files # 巨大ファイルの混入防止

  # Python: Black (フォーマッター)
  - repo: https://github.com/psf/black
    rev: 23.3.0
    hooks:
      - id: black

  # JavaScript/Frontend: Prettier
  - repo: https://github.com/pre-commit/mirrors-prettier
    rev: v3.0.0
    hooks:
      - id: prettier
        types_or: [css, javascript, html]  # 適用ファイルを指定

3. フックの有効化

設定ファイルを作成したら、以下のコマンドでGitフックを有効化します。このコマンドはリポジトリをクローンした直後に一度だけ実行する必要があります。

pre-commit install

これで、次回の git commit からフックが自動実行されます。もしコードが規定に違反している場合、自動修正が行われ、コミットは一度中断されます。開発者は修正内容を確認（git add）し、再度コミットするだけです。

Best Practice: 既存の巨大なリポジトリに導入する場合、全てのファイルに対して一度だけ手動実行し、ベースラインを整えることを推奨します。
コマンド: pre-commit run --all-files

パフォーマンス比較

手動運用とpre-commit導入後のワークフローの違いを比較しました。フィードバック速度の劇的な改善が見て取れます。

手法	検知タイミング	フィードバック時間	修正コスト
手動チェック	PRレビュー時	数時間〜数日	高（コンテキストスイッチ発生）
CIパイプライン	Push後	5分〜20分	中（再Pushが必要）
Pre-commit	Commit時	数秒	低（即時修正）

Conclusion

Gitフックによる自動化は、単なる「便利ツール」ではなく、チーム開発における衛生管理の要です。pre-commit フレームワークを導入することで、スタイルの議論や些細なミス修正といった非生産的な作業を排除し、ロジックやアーキテクチャの議論に集中できる環境を整えてください。今すぐ .pre-commit-config.yaml をリポジトリに追加しましょう。

Automation DevOps git ja pre-commit python