もがき系プログラマの日常

もがき系エンジニアの勉強したこと、日常のこと、気になっている技術、備忘録などを紹介するブログです。

Claude Code の質問が多いのでStop hookで矯正しようとした。

はじめに

こんばんは。

最近ずっと Claude Code で開発しているんですが、一つ地味なストレスがありました。

質問が多い。

「AでいいですかBでいいですか、ついでにCはどうします?」みたいに一度に質問を浴びせられると、こっちの脳が疲れるんですよね。読むのもしんどい。

というわけで、応答の「認知負荷」を機械的に下げる仕組みを作りました。今回はその話です。

あくまで「僕の認知不可」を下げるための仕掛けですので他の人には聞かないかもですよ。

Stop hook とは

Stop hook は、Claude が応答を返し終わったタイミングで発火します。

ここで応答内容をチェックして、条件を満たさなければ block を返す。すると Claude Code は「やり直し」を指示されたことになり、応答を書き直します。

気に入らない応答を機械的に突き返せます。

どんなルールにしたか

難しいのは出来そうになかったので、シンプルにしました。

  • 質問は1メッセージにつき1つまで
  • 平文は3000字未満(コードブロック内は除外)
  • 質問行は行頭に 👉 を付ける

ちなみに閾値は適当です。

質問行に絵文字マーカーを強制してるのは、パッと見で「どこで聞かれてるか」を分かりやすくするためです。

逆に質問じゃない行にマーカーを付けてたらそれもエラーにしてます。

実装

Stop hook は stdin で JSON を受け取ります。その中の応答テキストを検査して、違反があれば decision: "block" を返すだけです。

const violations = check(assistantText);
if (violations.length === 0) {
  process.exit(0);
}

console.log(JSON.stringify({ decision: "block", reason }));

「なぜ突き返したか」も表示します。

- 「?」が 3 個検出されました。質問は1つだけにしてください。
- 応答が 3500 文字あります。3000字未満にしてください。

みたいに具体的に書いておくと、ちゃんとその通りに直してくれます。文字数カウントはコードブロックを除外してるので、「長い説明はコードブロックに逃がす」という誘導にもなってます。

おわりに

ざっくりと作ったのでまぁめちゃくちゃ誤作動します。

でもまぁ「質問はこれ見たらいいんだな」っていうのがとりあえずわかりやすくなりました。

「AI の振る舞いを AI 自身に矯正させる」みたいな構図になっていて、作ってて面白かったです。

ではでは。