掲載済み (2026-08-15号)
278 153文字 • 1分

Claude Codeに「同じ指摘を二度させない」仕組みをhookで自作する

日本語

掲載情報

概要

Claude Codeのhook機能を活用し、AIへの指摘事項をファイル化して違反回数に応じた段階的な制約(警告・確認・禁止)を自動適用する仕組みの解説。

詳細内容

Claude Codeにおける「同じ指摘を繰り返す」ストレスを解消するため、独自のhookシステムを構築した事例記事です。指摘内容をMarkdownファイルとして永続化し、指摘回数(count)に応じてhookの強制力を段階的に引き上げる仕組み(warn → ask → deny)を導入しています。 具体的には以下の3つのhookを組み合わせています: 1. **UserPromptSubmit**: 確定したルールをコンテキストに自動注入。 2. **PreToolUse**: ツール実行前にルールの違反を検知し、必要に応じてブロック。 3. **Stop**: 完了時に特定条件(GitHub ActionsのSHAピン留め等)を満たしているか最終チェック。 また、正規表現による誤検知への対策や、コンテキスト圧迫を防ぐための優先度付きルール要約、hook自体のバグで作業を停止させないための例外処理など、実用的な設計の工夫が詳しく解説されています。