Cursor 遊戲開發 AI 規則：修正 Unity 與 Godot 程式碼生成錯誤

我在使用 Cursor 開發 Unity 和 Godot 小型遊戲時，經常遇到 AI 代理犯下重複的錯誤。這些問題包括刪除 using 語句（導致 CS0246 錯誤）、虛構出像 GameObject.FindByTag 這類不存在的 API，以及混淆 Unity 6 和 Unity 2022 的 API。

在 Godot 專案中，AI 則常在 Godot 4 專案裡寫出 Godot 3 的語法，例如 yield、export 和 KinematicBody2D。

為了解決這些問題，我特別為 Cursor 編寫了規則檔案。目前有兩個免費的開源儲存庫，皆採用 MIT 授權。Unity 專案的規則可在 GitHub 找到，它能阻止 AI（Cursor、Claude Code、ChatGPT）生成有問題的 Unity C# 程式碼，例如缺少 using、虛構 API 或混淆 Unity 6 與 2022 版本。

另一個 Godot 4 專案的規則儲存庫也已上線，它能防止 AI（Cursor、Claude Code、ChatGPT）在 Godot 4 專案中寫出 Godot 3 的程式碼，例如 yield、export、onready、舊版 connect() 和虛構 API。

設定方式很簡單，只需將 .cursor/ 資料夾和 AGENTS.md 檔案複製到你的專案根目錄（例如 Assets/ 或 project.godot 旁邊）。

核心規則是 alwaysApply；其他規則則透過 glob 模式（例如 `/*.cs、/*.gd）附加。AGENTS.md 檔案也涵蓋了 Claude Code 和 Codex 的使用方式。你可以快速測試一下，問 AI「為玩家添加跳躍功能」，它應該會自動讀取 ProjectVersion.txt（Unity）或使用 await / @export / CharacterBody2D`（Godot），而不需要額外提示。

此外，itch 平台上也有一個付費的完整版本，包含更多規則和任務提示，但免費的儲存庫本身就已足夠獨立使用。我最希望能聽到大家在使用 Unity 或 Godot 時，AI 代理還會犯哪些錯誤，這樣我就可以為它們添加更多規則。