Godot 4.7 的 Codex Skill:把Godot 4.7的開發者文件做成了Skill
先說結論
有了這款 Skill,Codex 會更加精確,直接透過本地查詢和命中,降低網路搜尋的不穩定性。錄屏在 YouTube。
直接下載倉庫壓縮包:godot-4.7-codex-docs-skill.zip。專案頁:godot-4.7-codex-docs-skill。
Godot當前的問題是:正在執行的編輯器並沒有把類文件開放給AI直接存取
有網友說,Godot 官方 Git 倉庫裡已經有了 godot-proposals#13608 的改進,但是還沒合併到主程式碼中。合併之後,Agent 可以直接向正在執行的編輯器要文件。
提案仍是 open,2025-11-10 提出。它給 EditorPlugin 增加 EditorInterface.get_documentation(class_name),返回當前編輯器裡的類文件,包含 GDExtension 加進來的類。
實現 PR godot#112628 仍是 open。改動大約幾十行,包的是編輯器內部已有的文件資料。2026-06-11,JetBrains Rider 還在催合併。卡住的是返回值 Dictionary 的文件怎麼寫。功能沒有被否掉。
4.7 裡還沒有讓外掛向當前引擎要類文件的呼叫。在這個 PR 進入正式版之前,本地 Markdown 是可用的做法。它和 Godot MCP 放在一起用。MCP 讀寫已經開啟的編輯器裡的場景和節點(Godot MCP)。這些頁負責簽名。
怎麼用這份 Godot Codex Skill
在文件倉庫裡開啟 Codex 或 Cursor 時,AGENTS.md 和這份 Godot Codex Skill 會生效。用 $godot-47-docs 問一個類或一個方法。
遊戲專案和這份倉庫並排放著開啟時,旁邊的倉庫不會自動變成 Skill。對話方塊裡要同時寫出 $godot-47-docs 和文件目錄的絕對路徑,檢索才發生在 gdd_*.md 所在的目錄。只點名 SKILL.md、不給路徑,搜尋會跑在遊戲倉庫裡。
在 Codex 裡,把這個資料夾加到專案可以讀取的目錄。輸入 $godot-47-docs 啟用。要單獨帶上一頁,輸入 @,再輸入 gdd 和類名或方法名,選中那個檔案。這一頁進入上下文,目錄裡其餘檔案留在外面。
小結
模型寫出的 Godot 程式碼不穩定,主要來自幾個版本同時存在。當前的這個倉庫就是為了解決由於不同版本的細微差別可能導致的 Bug 報錯問題,增強 Godot 4.7 版本的 AI 編碼穩定性。