improve

ref: https://martinfowler.com/articles/harness-engineering.html

Step 1: データ取得

bash "${CLAUDE_PLUGIN_ROOT}/scripts/aggregate-hook-logs.sh" --since ${ARGUMENTS:-14} --format json

Step 2: スキップ判定

以下は改善不要。件数のみカウントして先頭で報告:

• ask_flow が user_allowed / user_denied のみで、current_settings.ask_bash_prefixes にマッチ → 意図的 ask
• permission_modes == ["plan"] のみ → plan mode 仕様
• count < 3 → ノイズ（ただし危険パターンや error は低頻度でも拾う）

Step 3: 根本原因の分析

IMPORTANT: シグナルから直接アクションに飛ばない。まず「なぜこのパターンが発生しているか」を分析する。

各グループについて、以下を問う:

• なぜ user_allowed が多いのか？ — 本当に allow すべきか、それともそもそも Claude がそのコマンドを使う必要がないのでは？代替ツール（Read, Grep 等）で済むなら CLAUDE.md でガイドする方が正しい
• なぜ denied が繰り返されるのか？ — CLAUDE.md にルールがないのか、あるのに守れていないのか。後者なら表現を変える必要がある
• なぜ複雑な one-liner が生まれるのか？ — 既存のツールやスキルで代替できないか。スクリプト抽出は最終手段
• なぜ危険コマンドが通過しているのか？ — permission mode が bypassPermissions だったのか、prefix マッチの抜け穴か

各グループについて根本原因を1行で要約してから Step 4 の分類に進む。

Step 4: 分類

各グループを以下のカテゴリに分類する（複数該当可 — 例: deny 追加 + CLAUDE.md ルール追加のように、センサーとガイドの二重防御が適切な場合がある）。

IMPORTANT: プロジェクト対応は案内のみ。Claude 自身は cd しない。

(1) フィードフォワード改善 — ガイドの追加・修正

Claude の行動を事前に操舵するガイドを改善する。

CLAUDE.md ルール追加:

• シグナル: 同一 cmd_prefix で auto_denied または user_denied が繰り返される → Claude が禁止行動を学習できていない
• 例: git add -A denied ×5 → 「ファイルを個別に add」/ cat 頻発 → 「Read ツールを使え」

(2) フィードバック改善 — 権限・センサーの調整

権限ルールと hook バリデータを調整する。

allow 追加 (摩擦削減):

• シグナル: user_allowed が多い + current_settings.allow_bash_prefixes に該当なし
• pattern が近い既存 allow があれば拡張を提案

スクリプト抽出 → allow (摩擦削減):

• シグナル: example_commands に 200+ char の one-liner や複合シェル構文 (&&, |, for, $(...)) で user_allowed が繰り返される
• → .claude/scripts/<name>.sh に抽出し Bash(bash ~/.claude/scripts/<name>.sh*) で allow