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

.cursor/rules/common/pitfall-recall.mdc

@@ -1,31 +1,29 @@
-## 踩坑经验自动检索
+---
+description: 在 Debug、运行时错误或重复失败时被动检索既有踩坑经验
+alwaysApply: true
+---
 
-### 被动检测触发
+# 踩坑经验被动检索
 
-Agent 在以下场景中，应自动读取 `.cursor/pitfalls/pitfalls.md` 并进行匹配检索：
+## 触发条件
 
-1. **进入 Debug mode**：读取全部条目，将当前错误症状与已有记录比对
-2. **遇到运行时错误**：提取错误信息关键词，在"症状"字段中检索匹配
-3. **同一问题第二次出现**：如果当前会话中某个错误已出现过一次且未解决，强制检索
+出现任一情况时读取 `.cursor/pitfalls/pitfalls.md`：
 
-### 匹配策略
+- 进入 Debug 或系统化故障排查；
+- 遇到运行时、构建、配置、版本或工具链错误；
+- 同一问题在当前会话中第二次出现。
 
-```
-1. 提取当前问题的信号：错误信息关键词、涉及文件/模块、技术栈
-2. 在 pitfalls.md 中匹配：
-   - 硬匹配：错误关键词出现在条目的"症状"中
-   - 软匹配：模块/技术栈出现在条目的"关联"中
-3. 命中时在分析开头提示：
-   > 注意：之前遇到过类似问题 [PF-xxx]：[标题]。根因是 [xxx]，先排查这个方向。
-```
+文件不存在或只有模板时跳过，不报错。
 
-### 写入提醒
+## 匹配方式
 
-Agent 在完成涉及 debug/修复的任务后，应读取 `pitfall-journal` Skill 并执行其"操作 A：写入记录"流程。
-判断标准：问题的根因是否"非显而易见"——如果只看代码逻辑觉得应该没问题，但实际运行时才暴露，就值得记录。
+1. 提取错误关键词、涉及模块、运行环境和复现条件。
+2. 优先匹配条目的“症状”，再匹配“关联”或技术栈。
+3. 命中时简短指出相似记录、既有根因和首要排查方向。
+4. 将命中结果视为假设，必须用当前证据验证；同一条记录每次会话最多提醒一次。
 
-### 注意
+## 任务结束
 
-- 检索结果是**辅助参考**，不是确定性答案——匹配到不代表根因一定相同
-- pitfalls.md 不存在时跳过，不报错
-- 每次会话中对同一条 pitfall 最多提醒一次
+若根因只能通过实际运行或多步排查发现，读取 `.cursor/skills/pitfall-journal/SKILL.md` 并按其流程记录。纯拼写、明显语法错误或普通业务逻辑调整不记录。
+
+用户限制可修改范围或 Skill 缺失时，不越权写入，只报告待记录事项。