添加 claude code game studios 到项目

.claude/hooks/validate-commit.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+# Claude Code PreToolUse hook: Validates git commit commands
+# Receives JSON on stdin with tool_input.command
+# Exit 0 = allow, Exit 2 = block (stderr shown to Claude)
+#
+# Input schema (PreToolUse for Bash):
+# { "tool_name": "Bash", "tool_input": { "command": "git commit -m ..." } }
+
+INPUT=$(cat)
+
+# Parse command -- use jq if available, fall back to grep
+if command -v jq >/dev/null 2>&1; then
+    COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+else
+    COMMAND=$(echo "$INPUT" | grep -oE '"command"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/"command"[[:space:]]*:[[:space:]]*"//;s/"$//')
+fi
+
+# Only process git commit commands
+if ! echo "$COMMAND" | grep -qE '^git[[:space:]]+commit'; then
+    exit 0
+fi
+
+# Get staged files
+STAGED=$(git diff --cached --name-only 2>/dev/null)
+if [ -z "$STAGED" ]; then
+    exit 0
+fi
+
+WARNINGS=""
+
+# Check design documents for required sections
+DESIGN_FILES=$(echo "$STAGED" | grep -E '^design/gdd/')
+if [ -n "$DESIGN_FILES" ]; then
+    while IFS= read -r file; do
+        if [[ "$file" == *.md ]] && [ -f "$file" ]; then
+            for section in "Overview" "Player Fantasy" "Detailed" "Formulas" "Edge Cases" "Dependencies" "Tuning Knobs" "Acceptance Criteria"; do
+                if ! grep -qi "$section" "$file"; then
+                    WARNINGS="$WARNINGS\nDESIGN: $file missing required section: $section"
+                fi
+            done
+        fi
+    done <<< "$DESIGN_FILES"
+fi
+
+# Validate JSON data files -- block invalid JSON
+DATA_FILES=$(echo "$STAGED" | grep -E '^assets/data/.*\.json$')
+if [ -n "$DATA_FILES" ]; then
+    # Find a working Python command
+    PYTHON_CMD=""
+    for cmd in python python3 py; do
+        if command -v "$cmd" >/dev/null 2>&1; then
+            PYTHON_CMD="$cmd"
+            break
+        fi
+    done
+
+    while IFS= read -r file; do
+        if [ -f "$file" ]; then
+            if [ -n "$PYTHON_CMD" ]; then
+                if ! "$PYTHON_CMD" -m json.tool "$file" > /dev/null 2>&1; then
+                    echo "BLOCKED: $file is not valid JSON" >&2
+                    exit 2
+                fi
+            else
+                echo "WARNING: Cannot validate JSON (python not found): $file" >&2
+            fi
+        fi
+    done <<< "$DATA_FILES"
+fi
+
+# Check for hardcoded gameplay values in gameplay code
+# Uses grep -E (POSIX extended) instead of grep -P (Perl) for cross-platform compatibility
+CODE_FILES=$(echo "$STAGED" | grep -E '^src/gameplay/')
+if [ -n "$CODE_FILES" ]; then
+    while IFS= read -r file; do
+        if [ -f "$file" ]; then
+            if grep -nE '(damage|health|speed|rate|chance|cost|duration)[[:space:]]*[:=][[:space:]]*[0-9]+' "$file" 2>/dev/null; then
+                WARNINGS="$WARNINGS\nCODE: $file may contain hardcoded gameplay values. Use data files."
+            fi
+        fi
+    done <<< "$CODE_FILES"
+fi
+
+# Check for TODO/FIXME without assignee -- uses grep -E instead of grep -P
+SRC_FILES=$(echo "$STAGED" | grep -E '^src/')
+if [ -n "$SRC_FILES" ]; then
+    while IFS= read -r file; do
+        if [ -f "$file" ]; then
+            if grep -nE '(TODO|FIXME|HACK)[^(]' "$file" 2>/dev/null; then
+                WARNINGS="$WARNINGS\nSTYLE: $file has TODO/FIXME without owner tag. Use TODO(name) format."
+            fi
+        fi
+    done <<< "$SRC_FILES"
+fi
+
+# Print warnings (non-blocking) and allow commit
+if [ -n "$WARNINGS" ]; then
+    echo -e "=== Commit Validation Warnings ===$WARNINGS\n================================" >&2
+fi
+
+exit 0