Claude CodeのHook + Skillで、コミット後の変更を自動的にコミットする方法

私はGitを使ってすべての執筆コンテンツを管理しています。記事、素材、アウトライン、草稿など、すべてがリポジトリ内にあります。問題は、私がよくコミットを忘れてしまうことです。記事を書き終え、推敲し、公開した後、他のことに取り掛かってしまいます。数日後にgit statusを見ると、未コミットの変更が山積みになっています。

現在、私はClaude Codeを使って執筆プロセスを実行しており、素材分析から完成稿の公開まで、基本的にすべてを任せています。毎回のタスクでファイルを変更しているのだから、変更後に自動的にコミットさせられないでしょうか？

Claude CodeはHookメカニズムをサポートしており、特定のイベント（セッション開始、ツール呼び出し前後、タスク終了など）が発生したときに自動的にスクリプトを実行します。考え方はGit Hookと似ていますが、Claude Codeのライフサイクルにフックされています。

私はプロジェクトの.claude/settings.local.jsonに以下を追加しました：

"hooks": { "Stop": [{ "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/auto-commit.sh" }] }] }

スクリプトが行うことはシンプルです：ワークスペースに未コミットの変更（新規ファイル、変更、削除）があるかどうかをチェックし、もしあれば、Claude Codeが停止するのを阻止し、「まだやるべきことが残っています、コミットしてください」と伝えます。

if git diff --quiet && git diff --cached --quiet && \ [ -z "$(git ls-files --others --exclude-standard)" ]; then exit 0 # 変更なし、正常終了 fi # 変更あり、ブロックする echo '{"decision": "block", "reason": "检测到未提交的变更，请调用 /commit 技能提交更新。"}'

もう一つの詳細：コミット自体も「タスク終了」をトリガーするため、処理しないと無限ループになります。スクリプトはstop_hook_activeを使用してこれを回避します。

Commit Skill：コミットを意味のあるものにする

Hookはブロックするだけです。具体的なコミット方法はCommit Skillに依存します。

SkillはClaude Codeのスキルモジュールで、.claude/skills/に配置されます。

まず、変更されたファイルのパスを分析し、記事、スキル設定、コードのどれが変更されたかを判断します。

テーマごとにグループ化してコミットし、すべてを1つのコミットに詰め込まないようにします。例えば、2つの記事を変更した場合は、2回に分けてコミットします。

自動的に中国語のコミットメッセージを生成し、フォーマットは固定です：記事には「添加/润色/更新 + 主题」、コードには「优化/修复 + 功能」を使用します。

明確にコミットするファイルを指定し、git add . を避けます。

42257b3 添加 Amodei NYT 访谈整理文章 c4eee96 添加 Peter Steinberger OpenClaw 访谈整理文章 e2a01da 润色 Suleyman FT 专访文章

それぞれが何を変更したかを明確に説明しており、「update files」や「misc changes」のような意味のない情報ではありません。

2つのメカニズムの連携：Hookは門番として機能し、変更が漏れないように保証します。Skillは実行者として機能し、毎回のコミットが意味を持つように保証します。私はもうコミットのことを気にかける必要がなくなりました。

ファイルパス：.claude/hooks/auto-commit.sh

#!/bin/bash # Stop hook: タスク完了後に未コミットの変更を自動検出し、commit skillをトリガー INPUT=$(cat) STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false') # 無限ループ防止：コミット後に再度トリガーされた場合はそのまま通過 if [ "$STOP_HOOK_ACTIVE" = "true" ]; then exit 0 fi # 未コミットの変更があるかチェック cd "$CLAUDE_PROJECT_DIR" 2>/dev/null || exit 0 # ワークスペースに変更があるかチェック（変更済み、新規ファイルなど） if git diff --quiet 2>/dev/null && git diff --cached --quiet 2>/dev/null && [ -z "$(git ls-files --others --exclude-standard 2>/dev/null)" ]; then # 変更なし、正常終了 exit 0 fi # 未コミットの変更あり、Claudeの停止を阻止し、commitの実行を継続させる cat <<'EOF' {"decision": "block", "reason": "检测到未提交的变更，请调用 /commit 技能提交更新。"} EOF

ファイルパス：.claude/skills/commit/SKILL.md

--- name: commit description: 現在コミットされていない変更をコミットします。変更内容を自動分析し、規範的なコミットメッセージを生成し、ディレクトリごとのグループコミットまたはすべての変更の一括コミットをサポートします。 --- # Git Commit スキル 現在コミットされていない変更をgitリポジトリにコミットします。 ## ワークフロー ### ステップ1：未コミットの変更を確認 git status --short 変更タイプの分析： - M - 変更済み - ?? - 新規ファイル（未追跡） - D - 削除済み - R - リネーム済み ### ステップ2：変更内容の分析 変更されたファイルのパスに基づいて変更タイプを判断： | パスパターン | 変更タイプ | |----------|----------| | posts/YYYY-MM-DD/[slug]/ | 記事関連 | | .claude/skills/ | スキル設定 | | src/ | スクリプトコード | | .r2-upload-map/ | リソースマッピング（通常は単独でコミットしない） | | その他 | プロジェクト設定 | ### ステップ3：コミット戦略の決定 単一テーマの変更：すべてのファイルを一度にコミット 複数テーマの変更：ディレクトリ/テーマごとにグループ化してコミット グループ化の優先順位： 1. 記事ディレクトリ（記事ごとに1コミット） 2. スキルディレクトリ（スキルごとに1コミット） 3. コード変更（1つのコミットにまとめる） 4. 設定ファイル（1つのコミットにまとめる） ### ステップ4：コミットメッセージの生成 フォーマット規範： - 中国語を使用 - 変更内容を簡潔に記述 - 50字以内 よく使われるテンプレート： - 記事：添加 [記事テーマの概要]、润色 [記事タイトル]、更新 [記事タイトル] - スキル：添加 [スキル名] 技能、更新 [スキル名] 技能 - コード：优化 [機能の説明]、修复 [問題の説明] - 設定：更新项目配置 ### ステップ5：コミットの実行 git add <file1> <file2> ... git commit -m "commit message" 注意： - git add . や git add -A の使用を避ける - コミットするファイルを明確に指定 - 一時ファイル（.bak-*、.html.bak-*）を除外 ### ステップ6：結果の確認 git log --oneline -3 最近のコミット履歴を出力して成功を確認。 ## 除外ルール 以下のファイルはデフォルトでコミットしません： - *.bak-* - バックアップファイル - .DS_Store - macOSシステムファイル - node_modules/ - 依存関係ディレクトリ - .r2-upload-map/*.json - 通常は記事と一緒にコミットします。単独でのコミットが要求されない限り

ファイルパス：.claude/settings.local.json

{ "hooks": { "Stop": [{ "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/auto-commit.sh" }] }] } }