observe-setting

observe-setting (hook 設定ウィザード)

Hard rules

• ユーザー明示確認なしに settings.json を編集しない (soul.md 高リスク変更ルール準拠)
• 既存 settings.json の他フィールドを破壊しない (jq で minimal merge、全文上書き禁止)
• env 変数の有効値範囲を逸脱した設定を受け入れない (例: 間隔 < 5 分は拒否)

実行手順

0. 現在の設定確認

USER_SETTINGS="${HOME}/.claude/settings.json"
PROJ_SETTINGS=".claude/settings.json"

# 現状値の取得 (env var ベース)
for s in "$USER_SETTINGS" "$PROJ_SETTINGS"; do
  if [ -f "$s" ]; then
    echo "=== $s ==="
    jq '.env // {} | with_entries(select(.key | startswith("OBSERVE_")))' "$s" 2>/dev/null
    jq '.hooks // {}' "$s" 2>/dev/null | head -20
  fi
done

1. AskUserQuestion で 4 件確認

1. 定期リマインダー 有効? → 有効 / 無効
2. 定期リマインダー有効時の間隔 (分)? → 15 / 30 / 60 / 90 / 120 (or 自由入力)
3. セッション終了時 (SessionEnd) に自動で /observe を起動? → 有効 / 無効
4. git commit 時に /observe リマインダーを注入? → 有効 / 無効
5. 設定保存先 → ユーザー全体 (~/.claude/settings.json) / プロジェクト個別 (.claude/settings.json)

2. 設定値を env var として保存

TARGET="${USER_SETTINGS}"  # or PROJ_SETTINGS
TMP=$(mktemp)
jq --arg interval "$INTERVAL_MINUTES" \
   --arg periodic "$PERIODIC_ENABLED" \
   --arg on_end "$ON_END_ENABLED" \
   --arg on_commit "$ON_COMMIT_ENABLED" '
   .env = (.env // {}) + {
     "OBSERVE_PERIODIC_ENABLED": $periodic,
     "OBSERVE_PERIODIC_INTERVAL_MINUTES": $interval,
     "OBSERVE_ON_END_ENABLED": $on_end,
     "OBSERVE_ON_COMMIT_ENABLED": $on_commit
   }' "$TARGET" > "$TMP" && mv "$TMP" "$TARGET"

3. hook 配線確認

plugin がインストールされていれば hooks/hooks.json で UserPromptSubmit / Stop / PostToolUse:Bash 配線済。env var で各 hook の挙動が切り替わる。手動配線は不要。

4. 動作確認の案内

設定保存後、ユーザーに以下を案内:

• OBSERVE_PERIODIC_ENABLED=false に変更した場合 → 次プロンプトでリマインダー注入停止
• OBSERVE_ON_END_ENABLED=true に変更した場合 → 次 SessionEnd で /observe 自動起動
• OBSERVE_ON_COMMIT_ENABLED=true に変更した場合 → 次 git commit 後にリマインダー注入

env 変数一覧 (hooks 連動)

変数名	デフォルト	効果
OBSERVE_PERIODIC_ENABLED	true	UserPromptSubmit で経過時間リマインダーを注入するか
OBSERVE_PERIODIC_INTERVAL_MINUTES	60	リマインダー注入の経過時間しきい値 (分)
OBSERVE_ON_END_ENABLED	true	SessionEnd hook で /observe 自動起動を促すか
OBSERVE_ON_COMMIT_ENABLED	true	git commit / push 後にリマインダー注入するか

想定問答

• Q: 普段の運用に最適な間隔は? A: 30-60 分が目安。15 分はリマインダーが頻繁すぎ、120 分以上は摩擦検出の鮮度が落ちる
• Q: セッション終了時 (SessionEnd) の自動 /observe を切るのは? A: 短時間セッションが多い (5 分以下) 場合、毎回 /observe が走るとノイズになる。無効推奨
• Q: プロジェクト個別とユーザー全体、どちらの設定保存先が推奨? A: 複数プロジェクトで異なる方針ならプロジェクト個別、全プロジェクト統一ならユーザー全体

関連

• hooks/hooks.json -- 配線定義
• hooks/observe-periodic-check.sh -- 60 分リマインダー本体
• skills/observe/SKILL.md -- 観察スキル本体