/hooks機能を活用した堅牢化

[meme-dayo]

Stop

• ポーリング型🤖は入力待機モードに入った瞬間にhookで無理やり起こす
  • プロジェクトの重要文書のパスを渡す
  • 確率的に生のドキュメントを渡すhooks v3をv0.6.3で導入

"block"はClaudeの停止を防ぐ。Claudeが進行方法を知るためにreasonを入力する。

{
  "decision": "block" | undefined,
  "reason": "Must be provided when Claude is blocked from stopping"
}

例：あなたはポーリング型のエージェントです。待機状態に入ることは許可されていません。CLAUDE.md, XX.md, directory_map, 他関連ファイル を再度、読みなさい。並行タスクを進めてください。それでも待機する場合は sleep 10等を使用します。

SessionStart

• agent_and_pane_id_table.jsonlへのclaude_session_id追加で使用

SubagentStop

• telemetry/以下のpythonコードで.claude/jsonを管理しているが一元化

Notification

Claude Codeが通知を送信するときに実行
プロンプト入力が少なくとも60秒間アイドル状態の場合。「Claudeはあなたの入力を待っています」
ユーザ以外には通知不可？

• 指定のファイルが更新されたら

Precompact

各エージェントのコンテキスト使用率はcontext_monitor系のPythonコードで把握できるので優先度は低い

UserPromptSubmit

agent_sendによるメッセージ受信も含む？

PreToolUse

絶対に禁止させたいものを除きPostToolUseでフィードバックで事足りる

PostToolUse

• 全エージェント：Desktop Commander MCPサーバの start_processツールを使用時（またはBashツールでssh scp sftpコマンドを実行した後） ssh_sftp_usage.mdを参照するよう警告（v0.6.6で実装）
• PGが Write | Edit | MultiEditの際 _v{バージョン}というファイル名だった際に 対応するファイルかバッチジョブが 開始・終了時刻と経過時間を出力するかをサブエージェントが確認する

hooksの解説

Note

Anthropic公式
https://docs.anthropic.com/ja/docs/claude-code/hooks
動画
https://www.youtube.com/watch?v=s71I9pVdsv8

[meme-dayo]

v0.3で導入
hooks自動セットアップの流れは以下のフローチャートを参照
#23 (comment)

[meme-dayo]

2回目のSTOP阻止が機能しない

2回目以降STOP hooksでは"stop_hook_active": true を受け取る。
これにより無限ループを防ぐことができる

実際hooks/template/stop_polling.pyで２回目以降はNoneを返す処理を行っていた（～v0.3.12）

def generate_block_reason(agent_info, stop_hook_active):
    """ポーリング型エージェント用のブロック理由を生成"""
    
    # stop_hook_activeがtrueの場合は、繰り返しを防ぐ
    if stop_hook_active:
        return None

修正案

• STOP試行回数を用いて制御
  • /.claude/hooks/以下にstop_count.txtを作成
  • カウンタの値に応じてhooks処理を分岐（例：10回目は終了等）

[meme-dayo]

SEが「監視＝成果が上がるまで待機」と勘違い
実際には進捗を聞く必要がある

• agent_sendし返さないことも全滅に繋がる

[meme-dayo]

既存の問題点（マルチエージェントのhooksに含めるべき情報）
exitできない→コマンドの無限ループでコンテキストを無駄に消費

• agent_send.shの使い方（存在）をPM以外忘れる
• hooksの内容に引っ張られる
  • PGがコードを転送&実行を行わず、永遠に手元で追加コード実装
  • 進捗のない重複したレポートの量産
• sleep 10 だけでなく、その直後の行動も促す必要がある
• 必要以上にauto-compactを恐れる
• 要件定義書を見る頻度が低い
• READを促すのではなく、生のデータを渡すべきかもしれない

[meme-dayo]

v0.6.6でPostToolUseによるSSH接続アシストを追加

[meme-dayo]

v1はstop hooksのハーネスは緩めに設定した。完全自律性よりも以下を優先

• "待機宣言の無限ループ"回避
• 途中のユーザ干渉で問題が起きにくい