cursor Init 完善多人协同changelog，以及godot相关基础skill和代码规范

.cursor/hooks/check-changelog.sh

@@ -1,58 +1,132 @@
 #!/usr/bin/env bash
-# Changelog sync guard — stop hook (bash 版)
+# Changelog sync guard：比较 Godot 源码/配置与本会话起点、changelog 的 mtime。
 
-input=$(cat)
+emit_empty() {
+    printf '{}\n'
+}
 
-# === 豁免检查 1：环境变量跳过标志 ===
-if [ -n "$CURSOR_SKIP_CHANGELOG" ]; then
-    echo '{}'; exit 0
+cat >/dev/null
+
+if [ -n "${CURSOR_SKIP_CHANGELOG:-}" ]; then
+    emit_empty
+    exit 0
 fi
 
-# === 豁免检查 2：从 stdin 解析 composer_mode ===
-mode=$(echo "$input" | python3 -c "import sys,json; print(json.load(sys.stdin).get('composer_mode',''))" 2>/dev/null || echo "")
-if [ -n "$mode" ] && [ "$mode" != "agent" ]; then
-    echo '{}'; exit 0
-fi
+script_dir=$(CDPATH= cd -- "$(dirname -- "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)
+cursor_dir=$(dirname -- "$script_dir")
+repo_root=$(dirname -- "$cursor_dir")
+changelog="$cursor_dir/changelog/changelog-headlines.md"
+ack_file="$cursor_dir/changelog/.changelog-ack"
+session_marker="$cursor_dir/changelog/.session-start"
 
-# === 豁免检查 3：从 stdin 文本匹配 debug 上下文关键词 ===
-if echo "$input" | grep -qiE '"mode"\s*:\s*"debug"|debug[\s_-]?mode|Debug Mode'; then
-    echo '{}'; exit 0
-fi
-
-changelog=".cursor/changelog/changelog-headlines.md"
-srcDir="art-agent"
-
-# === 豁免检查 4：changelog 文件不存在 ===
 if [ ! -f "$changelog" ]; then
-    echo '{}'; exit 0
+    emit_empty
+    exit 0
 fi
 
-clMtime=$(stat -c %Y "$changelog" 2>/dev/null || stat -f %m "$changelog" 2>/dev/null)
+get_mtime() {
+    stat -c %Y "$1" 2>/dev/null || stat -f %m "$1" 2>/dev/null
+}
 
-# === 豁免检查 5：ack 标记文件足够新 ===
-ackFile=".cursor/changelog/.changelog-ack"
-if [ -f "$ackFile" ]; then
-    ackMtime=$(stat -c %Y "$ackFile" 2>/dev/null || stat -f %m "$ackFile" 2>/dev/null)
-    if [ "$ackMtime" -ge "$clMtime" ] 2>/dev/null; then
-        echo '{}'; exit 0
+if [ -f "$ack_file" ]; then
+    changelog_mtime=$(get_mtime "$changelog")
+    ack_mtime=$(get_mtime "$ack_file")
+    if [ -n "$changelog_mtime" ] && [ -n "$ack_mtime" ] &&
+        [ "$ack_mtime" -ge "$changelog_mtime" ] 2>/dev/null; then
+        emit_empty
+        exit 0
     fi
 fi
 
-# === 豁免检查 6：stdin 中无文件编辑证据 ===
-if ! echo "$input" | grep -qE 'StrReplace|Write\s*tool|edit_file|file_write|write_to_file|Created file|Modified file|Wrote contents|"tool"\s*:\s*"(str_replace|write|edit)"'; then
-    echo '{}'; exit 0
+comparison_file=$changelog
+if [ -f "$session_marker" ]; then
+    changelog_mtime=$(get_mtime "$changelog")
+    session_mtime=$(get_mtime "$session_marker")
+    if [ -n "$changelog_mtime" ] && [ -n "$session_mtime" ] &&
+        [ "$session_mtime" -gt "$changelog_mtime" ] 2>/dev/null; then
+        comparison_file=$session_marker
+    fi
 fi
 
-# === 核心检查：是否有源文件比 changelog 更新 ===
-newerFile=$(find "$srcDir" -type f \( -name "*.py" -o -name "*.tsx" -o -name "*.ts" -o -name "*.css" \) \
-    ! -path "*/node_modules/*" ! -path "*/.next/*" ! -path "*/__pycache__/*" ! -path "*/venv/*" \
-    -newer "$changelog" -print -quit 2>/dev/null)
+newer_file=''
+while IFS= read -r candidate; do
+    newer_file=$candidate
+    break
+done < <(
+    find "$repo_root" \
+        \( -type d \( \
+            -name '.git' -o \
+            -name '.cursor' -o \
+            -name '.godot' -o \
+            -name 'node_modules' -o \
+            -name '__pycache__' -o \
+            -name 'venv' -o \
+            -name '.venv' -o \
+            -name 'dist' -o \
+            -name 'build' -o \
+            -name 'out' -o \
+            -name 'bin' -o \
+            -name 'obj' -o \
+            -name 'export' -o \
+            -name 'exports' -o \
+            -name 'coverage' -o \
+            -name 'tmp' -o \
+            -name 'temp' \
+        \) -prune \) -o \
+        \( -type f \( \
+            -iname 'project.godot' -o \
+            -iname '*.gd' -o \
+            -iname '*.tscn' -o \
+            -iname '*.tres' -o \
+            -iname '*.res' -o \
+            -iname '*.gdshader' -o \
+            -iname '*.cfg' -o \
+            -iname '*.json' -o \
+            -iname '*.cs' -o \
+            -iname '*.csproj' -o \
+            -iname '*.py' -o \
+            -iname '*.ps1' -o \
+            -iname '*.sh' \
+        \) -newer "$comparison_file" -print \) 2>/dev/null
+)
 
-if [ -n "$newerFile" ]; then
-    fname=$(basename "$newerFile")
-    msg="[Hook] Source file updated (e.g. $fname) but changelog not synced. Run dev-changelog Skill operation A NOW to write all three changelog layers."
-    echo "{\"followup_message\":\"$msg\"}"
+if [ -z "$newer_file" ]; then
+    emit_empty
+    exit 0
+fi
+
+relative_file=${newer_file#"$repo_root"/}
+message="[Hook] Godot source/config is newer than the changelog (e.g. $relative_file). Run dev-changelog Skill operation A now: add a fragment under .cursor/changelog/entries/ and rebuild the changelog views."
+
+python_cmd=''
+for candidate in python3 python; do
+    if command -v "$candidate" >/dev/null 2>&1 &&
+        "$candidate" -c 'import json' >/dev/null 2>&1; then
+        python_cmd=$candidate
+        break
+    fi
+done
+
+if [ -n "$python_cmd" ]; then
+    result=$(
+        printf '%s' "$message" | "$python_cmd" -c '
+import json
+import sys
+
+print(json.dumps(
+    {"followup_message": sys.stdin.read()},
+    ensure_ascii=False,
+    separators=(",", ":"),
+))
+' 2>/dev/null
+    ) || result='{}'
+    if [ -n "$result" ]; then
+        printf '%s\n' "$result"
+    else
+        emit_empty
+    fi
 else
-    echo '{}'
+    emit_empty
 fi
+
 exit 0