godot-agent
为AI智能体提供结构化控制Godot引擎的CLI工具与MCP服务。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：godot-agent。 它的用途是：为AI智能体提供结构化控制Godot引擎的CLI工具与MCP服务。 完整的 Skill 内容见：https://321skill.com/skills/godot-agent/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用godot-agent在我的项目‘MyGame’中创建一个名为‘Player’的新场景，并添加一个CharacterBody2D节点。”，AI会调用`gda scene create`等命令，并直接获得结构化的JSON结果，确认场景和节点已成功创建，而非返回一堆难以解析的引擎日志。
介绍
godot-agent（gda）解决了AI编程助手在Godot开发中“只写代码、无法感知结果”的痛点。它通过一个统一的命令行界面，为AI或自动化脚本提供了对Godot引擎的机器可读、结构化控制。
使用时，你可以通过gda命令直接操作Godot项目，例如创建场景、编辑节点与脚本、导出构建包。它支持两种模式：无需任何项目设置的“无头模式”用于静态操作，以及通过后台守护进程连接运行中游戏的“实时模式”，用于读取运行时场景树、模拟输入、捕获截图等。
该工具非常适合正在开发Godot游戏的智能体开发者、全栈开发者以及需要将Godot项目构建流程自动化的运维工程师。它让AI助手能像开发者一样“看到”并“操作”游戏项目，形成完整的开发闭环。
需要注意的是，该项目目前处于1.0之前的版本，虽然所有命令功能完整，但CLI接口在1.0正式版前仍可能发生变化。
核心特点
与同类工具相比，其核心区别在于：1）所有命令输出均为单一、结构化的JSON对象，专为AI智能体解析设计，彻底避免了从引擎日志中抓取信息的麻烦；2）同一套操作接口同时提供了CLI、Skill包和MCP服务器三种接入方式，能灵活适配不同的AI代理工作流。
注意事项
不适合需要直接使用Godot编辑器进行可视化、交互式设计的场景。
常见问题
godot-agent需要在我的Godot项目中安装插件吗？
不需要。它是一个独立的外部CLI工具，通过Godot引擎的可执行文件进行通信，无需修改你的项目。
可以用它来自动化测试或构建游戏吗？
可以。它的无头模式非常适合在CI/CD流水线中自动执行场景编辑、脚本修改和项目导出等构建任务。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/godot-agent/raw/index.md 读取 godot-agent 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/godot-agent/raw/index.md（查看排版版本）