添加 claude code game studios 到项目

2026-05-15 14:52:29 +08:00
parent dff559462d
commit a16fe4bff7
415 changed files with 78609 additions and 0 deletions
--- a/.claude/docs/hooks-reference/pre-commit-design-check.md
+++ b/.claude/docs/hooks-reference/pre-commit-design-check.md
@@ -0,0 +1,70 @@
+# Hook: pre-commit-design-check
+
+## Trigger
+
+Runs before any commit that modifies files in `design/` or `assets/data/`.
+
+## Purpose
+
+Ensures design documents and game data files maintain consistency and
+completeness before they enter version control. Catches missing sections,
+broken cross-references, and invalid data before they propagate.
+
+## Implementation
+
+```bash
+#!/bin/bash
+# Pre-commit hook: Design document and game data validation
+# Place in .git/hooks/pre-commit or configure via your hook manager
+
+DESIGN_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '^design/')
+DATA_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '^assets/data/')
+
+EXIT_CODE=0
+
+# Check design documents for required sections
+if [ -n "$DESIGN_FILES" ]; then
+    for file in $DESIGN_FILES; do
+        if [[ "$file" == *.md ]]; then
+            # Check for required sections in GDD documents
+            if [[ "$file" == design/gdd/* ]]; then
+                for section in "Overview" "Detailed" "Edge Cases" "Dependencies" "Acceptance Criteria"; do
+                    if ! grep -qi "$section" "$file"; then
+                        echo "ERROR: $file missing required section: $section"
+                        EXIT_CODE=1
+                    fi
+                done
+            fi
+        fi
+    done
+fi
+
+# Validate JSON data files
+if [ -n "$DATA_FILES" ]; then
+    for file in $DATA_FILES; do
+        if [[ "$file" == *.json ]]; 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
+            if [ -n "$PYTHON_CMD" ] && ! "$PYTHON_CMD" -m json.tool "$file" > /dev/null 2>&1; then
+                echo "ERROR: $file is not valid JSON"
+                EXIT_CODE=1
+            fi
+        fi
+    done
+fi
+
+exit $EXIT_CODE
+```
+
+## Agent Integration
+
+When this hook fails, the committer should:
+1. For missing design sections: invoke the `game-designer` agent to complete
+   the document
+2. For invalid JSON: invoke the `tools-programmer` agent or fix manually