Claude Codeの指示忘れ問題を解決！HooksでPython環境をpip禁止＆uv統一にする

## Package Management
- ONLY use uv, NEVER pip
- Installation: uv add package
- Running tools: uv run tool
- Upgrading: uv add --dev package --upgrade-package package
- FORBIDDEN: uv pip install, @latest syntax

#!/bin/bash



input=$(cat)


if [ -z "$input" ]; then
  echo '{"decision": "approve"}'
  exit 0
fi


tool_name=$(echo "$input" | jq -r '.tool_name' 2>/dev/null || echo "")
command=$(echo "$input" | jq -r '.tool_input.command // ""' 2>/dev/null || echo "")
file_path=$(echo "$input" | jq -r '.tool_input.file_path // .tool_input.path // ""' 2>/dev/null || echo "")
current_dir=$(pwd)


if [[ "$tool_name" == "Bash" ]]; then
  case "$command" in
    pip\ *|pip3\ *)
      
      pip_cmd=$(echo "$command" | sed -E 's/^pip[0-9]? *//' | xargs)
      
      case "$pip_cmd" in
        install\ *)
          packages=$(echo "$pip_cmd" | sed 's/install//' | sed 's/--[^ ]*//g' | xargs)
          
          
          if [[ "$pip_cmd" =~ -r\ .*\.txt ]]; then
            req_file=$(echo "$pip_cmd" | sed -n 's/.*-r \([^ ]*\).*/\1/p')
            echo "{
              \"decision\": \"block\",
              \"reason\": \"📋 requirements.txtからインストール:\\n\\n✅ 推奨方法:\\nuv add -r $req_file\\n\\nこれにより:\\n• requirements.txt内のすべての依存関係をpyproject.tomlに追加\\n• uv.lockファイルを自動生成/更新\\n• 仮想環境を自動的に同期\\n\\n💡 制約ファイルがある場合:\\nuv add -r $req_file -c constraints.txt\\n\\n📌 注意: この方法が最も確実で、バージョン指定も正しく処理されます\"
            }"
            exit 0
          fi
          
          
          if [[ "$pip_cmd" =~ --dev ]] || [[ "$pip_cmd" =~ -e ]]; then
            echo "{
              \"decision\": \"block\",
              \"reason\": \"🔧 開発依存関係をインストール:\\n\\nuv add --dev $packages\\n\\n編集可能インストール: uv add -e .\"
            }"
            exit 0
          fi
          
          
          echo "{
            \"decision\": \"block\",
            \"reason\": \"📦 パッケージをインストール:\\n\\nuv add $packages\\n\\n💾 'uv add' はpyproject.tomlに依存関係を保存します\\n🔒 uv.lockで再現可能な環境を保証\\n\\n💡 特殊なケース:\\n• URLからのインストール: パッケージを手動でダウンロードしてから追加\\n• 開発版: uv add --dev $packages\\n• ローカルパッケージ: uv add -e ./path/to/package\"
          }"
          exit 0
          ;;
        
        uninstall\ *)
          packages=$(echo "$pip_cmd" | sed 's/uninstall//' | sed 's/-y//g' | xargs)
          echo "{
            \"decision\": \"block\",
            \"reason\": \"🗑️ パッケージを削除:\\n\\nuv remove $packages\\n\\n✨ 依存関係も自動的にクリーンアップされます\"
          }"
          exit 0
          ;;
        
        list*|freeze*)
          echo '{
            "decision": "block",
            "reason": "📊 パッケージ一覧を確認:\n\n• プロジェクト依存関係: cat pyproject.toml\n• ロックファイル詳細: cat uv.lock\n• インストール済み一覧: uv tree\n• requirements.txt形式でエクスポート: uv export --format requirements-txt\n\n💡 'uv tree'はプロジェクトの依存関係ツリーを表示します"
          }'
          exit 0
          ;;
        
        *)
          
          echo "{
            \"decision\": \"block\",
            \"reason\": \"🔀 pipコマンドをuvで実行:\\n\\nuv pip $pip_cmd\\n\\n💡 パッケージのインストール/削除には 'uv add/remove' を使用してください\"
          }"
          exit 0
          ;;
      esac
      ;;
    
    
    python*|python3*|py\ *)
      
      args=$(echo "$command" | sed -E 's/^python[0-9]? //' | xargs)
      
      
      if [[ "$args" =~ ^-m ]]; then
        module=$(echo "$args" | sed 's/-m //')
        
        case "$module" in
          pip\ *)
            pip_cmd=$(echo "$module" | sed 's/pip //')
            
            if [[ "$pip_cmd" =~ ^install ]]; then
              packages=$(echo "$pip_cmd" | sed 's/install//' | sed 's/--[^ ]*//g' | xargs)
              if [[ "$pip_cmd" =~ -r\ .*\.txt ]]; then
                req_file=$(echo "$pip_cmd" | sed -n 's/.*-r \([^ ]*\).*/\1/p')
                echo "{
                  \"decision\": \"block\",
                  \"reason\": \"📋 requirements.txtからインストール:\\n\\n✅ 推奨方法:\\nuv add -r $req_file\\n\\n💡 これによりすべての依存関係がpyproject.tomlに追加されます\"
                }"
              else
                echo "{
                  \"decision\": \"block\",
                  \"reason\": \"📦 パッケージをインストール:\\n\\nuv add $packages\\n\\n💡 'uv add' はpyproject.tomlに依存関係を保存します\"
                }"
              fi
            else
              echo "{
                \"decision\": \"block\",
                \"reason\": \"🔀 pipコマンドをuvで実行:\\n\\nuv pip $pip_cmd\\n\\n💡 パッケージ管理には 'uv add/remove' を使用してください\"
              }"
            fi
            exit 0
            ;;
          *)
            echo "{
              \"decision\": \"block\",
              \"reason\": \"uvでモジュールを実行:\\n\\nuv run python -m $module\\n\\n🔄 uvは自動的に環境を同期してから実行します。\"
            }"
            exit 0
            ;;
        esac
      fi
      
      
      echo "{
        \"decision\": \"block\",
        \"reason\": \"uvでPythonを実行:\\n\\nuv run python $args\\n\\n✅ 仮想環境のアクティベーションは不要です！\"
      }"
      exit 0
      ;;
  esac
fi


echo '{"decision": "approve"}'

chmod +x path/to/enforce-uv.sh

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/enforce-uv.sh"
          }
        ]
      }
    ]
  }
}

## Package Management
- ONLY use uv, NEVER pip
- Installation: uv add package
- Running tools: uv run tool
- Virtual environment: always use uv-created .venv
- ... (詳細な説明が数十行)

## Environment
- Python package manager: uv