Pre-Commitフックのセットアップ
前提条件
開始前に、以下を確認してください。
- Gitリポジトリが存在すること —
.git/ディレクトリを確認します。見つからない場合は、ユーザーに通知して処理を停止します。 - パッケージマネージャーが利用可能であること — 以下の検出後、関連するツールがインストールされていることを確認します。
- Python:
uv --versionを実行してuvが利用可能であることを確認 - JS/TS:
npx --versionを実行してnpxが利用可能であることを確認
- Python:
前提条件が満たされない場合、不足しているものとそのインストール方法をユーザーに通知します。
ステップ1: プロジェクトタイプの検出
プロジェクトルートで以下を確認します。
| シグナル | 結果 |
|---|---|
pyproject.toml があり、package.json がない | Python → python-setup.md を読む |
package.json があり、pyproject.toml がない | JS/TS → js-setup.md を読む |
| 両方ともある | ユーザーに確認(以下を参照) |
| どちらもない | サポートされているプロジェクトがないことをユーザーに通知し、停止 |
両方とも検出された場合
AskUserQuestion を使用して、3つのオプションを提示します。
- A) Python のみ —
python-setup.mdに従う - B) JS/TS のみ —
js-setup.mdに従う - C) 両方 — 「両言語モード」セクションを含む
python-setup.mdに従う
ステップ2: 有効にするチェックをユーザーに確認
言語固有のセットアップファイルに委譲します。各ファイルは AskUserQuestion を介して利用可能なチェックを提示します。
ユーザーがチェックを選択しなかった場合: フックがインストールされないことをユーザーに通知し、正常に終了します。
ステップ3: フレームワークのインストール
言語固有のセットアップファイルに従います。
ステップ4: 設定の生成
言語固有のセットアップファイルに従って、ユーザーの選択に基づいて設定ファイルを作成します。
ステップ5: フックのインストール
言語固有のセットアップファイルに従って、Git でフックをアクティブ化します。
ステップ6: 検証
コードベース全体に対してフックを実行して、正常に動作することを確認します。
ステップ7: 検証失敗の処理
- リンターやフォーマットの違反が見つかった場合、可能な限り自動修正(
ruff --fix、ruff format、prettier --write)して再実行します。 - 型チェックやテストの失敗が発生した場合、ユーザーに通知し、フック設定ファイルのみをコミットして続行します。
ステップ8: コミット
作成または変更されたすべての設定ファイルをステージングしてコミットします。