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 编码稳定性。