Godot-Autopilot
AGENTS.md1 starsChanged 17 days agoMITView on GitHub
Godot Autopilot(GDA):进程内 GDExtension,把 Godot 编辑器经 MCP(127.0.0.1:9527/mcp)暴露给 AI 客户端。C++17 + godot-cpp + mcp-cpp-sdk,工具经 ToolSpec 数据化注册。 本页是最小上下文入口;项目事实与文档规则见 docs/wiki/index.md。 docs/wiki/index.md(页面索引、三层分工细则、编写规则、维护步骤);安全与并发契约见 docs/wiki/security_contract.md。
In this repository16 other files it gives its agents.
- cpp-registrationSkill
- domain-tool-authoringSkill
- gda-demo-e2eSkill
- gda-e2e-analysisSkill
- skill-proposerSkill
- thread-security-gateSkill
- wiki-maintainerSkill
- godot-autopilot-contentSkill
- godot-autopilot-csharpSkill
- godot-autopilot-resourcesSkill
- godot-autopilot-runtimeSkill
- godot-autopilot-scene-systemSkill
- godot-autopilot-scriptingSkill
- godot-autopilot-serversSkill
- godot-autopilotSkill
- godot-autopilot-toolsSkill
The file
Files
AGENTS.md
Godot Autopilot(GDA):进程内 GDExtension,把 Godot 编辑器经 MCP(127.0.0.1:9527/mcp)暴露给 AI 客户端。C++17 + godot-cpp + mcp-cpp-sdk,工具经 ToolSpec 数据化注册。
本页是最小上下文入口;项目事实与文档规则见 docs/wiki/index.md。
命令
- 构建部署:
uv run main.py build+uv run main.py deploy(子命令:build/deploy/package/clean/test/tui;deploy下--release/--demos <名称...>,package下--libs-dir <dir>) - 手动构建:
cmake --preset debug && cmake --build --preset debug - 快速验证:
ctest --preset debug -E "^gda_runner_|^pool_"(L1 + 守卫 + CLI,秒级;排除 L2 用例与池 fixture,避免拉起池) - L2 池化:
uv run main.py test --all(两阶段:阶段 A 串行跑 L1 + 守卫 + CLI,阶段 B 跑 L2 池化、默认-j 5;--legacy-l2回退 legacy 编排) - CLI 单测:
bun test cli/tests(Bun + TS,秒级) - 版本只改根
VERSION,随后重新 configure
每次在场的硬约束
- 所有 Godot API 必须经
CommandQueue在主线程执行(submit()/ 带预算的等待入口);直接调用必崩,main_thread_guard在 ctest 阶段静态拦截,编译通过不算过。execute_sync()已无调用点且是无界等待,不得新增调用。 - 新增
.cpp要在两处登记:根CMakeLists.txt的add_library()与tests/CMakeLists.txt的GDA_UNIT_BUSINESS_SOURCES(src/tools/*_ops.cpp由 glob 自动纳入,只需登记非*_ops.cpp的源文件)。漏登根CMakeLists.txt后果最重:该编译单元不进插件产物,问题只在运行时暴露(L2 用例整体 ERROR,定位困难);漏登GDA_UNIT_BUSINESS_SOURCES仅在有 L1 用例引用其符号时才在 L1 链接期报错,无引用时完全静默(等于没有覆盖)。详见 .agents/skills/cpp-registration/SKILL.md。 - 依赖是
third_party/下的 git submodule:构建前必须已检出(git clone --recurse-submodules,或git submodule update --init --recursive),缺失则 configure 直接报错,不做网络回退。 - 构建生成器双路径:CMake 预设按 ninja 可用性自适应——有 ninja 用
debug/release,无则用debug-portable/release-portable(共用build/{debug,release});main.py各子命令自动选路,手动cmake --preset/ctest --preset须自己补-portable后缀。见 build.md「预设」。 - 源码禁止注释:除
// namespace结尾标记外不得有//或/*…*/,解释写进 wiki;comment_guard在 ctest 阶段拦,编译通过不算过。 - 默认安全姿态不可静默放宽:仅绑环回、脱敏默认开、授权列表默认为空、导出期拒绝工具调用 / MCP 资源 / MCP 提示词三类入口。
- 数值一律以运行时统计为准,权威口径见
docs/wiki/tests.md的数值核算总表;本页不记录计数。 - L2 池模式用例共享常驻编辑器会话:新增用例须自清理场景与文件;累计态敏感用例(如调试器错误计数)加入
tests/pool/pools.json的isolated,不得依赖池复位清除会话级状态;池模式下用例的requires被忽略,授权由所在池的allow决定。 - CLI 为 Bun+TS 源码直跑:零运行时依赖、无构建步骤;发布流程另产出各平台独立二进制(5 个目标 +
sha256sums.txt)。技能书钉#<VERSION>(由version_sync_guard兜底)。
三层文档分工
| 层 | 位置 | 承载 |
| 入口 | 本文件 | 命令与硬约束 —— 保持最小、少变更 |
| 事实 | docs/wiki/ | 陈述性事实:架构、模块行为、数值口径、历史结论与坑 |
- 一个知识只有一个权威落点,其它位置改成引用。
- 写入前判据:只是让人知道现状 → wiki;每次会话都必须在场且稳定 → 本页。
协作
git status的大量M多为 CRLF 伪变更(仓库无.gitattributes),核查一律以git diff HEAD为准。- 提交信息
<type>(<scope>): <中文描述>,scope 用中文功能域,按功能域拆分提交。 - 多代理并行时子代理只写代码不编译,主代理统一 configure/build 再分批测(并行编译会锁);L1 禁调已注册 handler。
- 面向 MCP 客户端的技能书(
godot-autopilot-*)由skills/模板生成到当前打开工程的res://.agents/skills/;本仓库测试床路径为tests/testbed/.agents/skills/。
知识库入口
docs/wiki/index.md(页面索引、三层分工细则、编写规则、维护步骤);安全与并发契约见 docs/wiki/security_contract.md。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

