Godot Kit

个人笔记

我为自己做了这个，它被分散在各种不同的项目中，我试图尽我所能地捆绑它，接受它，使用它，改变它，做任何事情，它都是你的，如果你想让我添加任何东西或有一个很酷的想法，伸出手来或做任何事，做公关，玩得开心，让你的游戏成为现实！

Godot工具包

基于AI的Godot 4.x开发工具包

    

Godot Kit是用于Godot 4.x游戏开发的全面AI技能包。它是为使用AI编码助手的游戏开发人员而构建的——Claude Code、GitHub Copilot、Antigravity或任何兼容MCP的工具。您将获得专家GDScript模式、调试知识、UI系统、roguelike蓝图、粒子向导和4个MCP服务器，这些服务器使您的AI助手在运行时可以访问Godot编辑器、资源库、本地知识索引和编辑器日志。

______________________________________________________________________

一次快速安装

将您平台的提示复制到您的AI助手中，它将处理一切。没有手动步骤，没有手动编辑的配置文件。你的AI读取指令，克隆仓库，将每个文件复制到正确的位置，创建Python环境，并验证结果。

克劳德代码

Install the Godot Kit bundle from https://github.com/SufficientDaikon/godot-kit into my project:

1. Clone the repo to a temp directory
2. Copy each subdirectory from skills/ to ~/.claude/skills/{name}/
3. Copy agents/AGENTS.md to my project root
4. Create ~/.claude/agents/ if needed, copy agents/*.agent.md there
5. Create .vscode/mcp-servers/ in my project, copy mcp-servers/*.py there
6. Create a Python venv at .venv/ and pip install fastmcp httpx
7. Copy platforms/claude-code/.mcp.json to my project root as .mcp.json
8. In .mcp.json, set GODOT_PATH to my Godot executable (ask me if you can't find it)
9. Update Python server paths in .mcp.json to use .venv/Scripts/python.exe (Windows) or .venv/bin/python (macOS/Linux)
10. Create .claude/prompts/ if needed, copy prompts/ contents there
11. Copy mcp-knowledge/ to my project root
12. Delete the temp clone
13. Verify: skills exist in ~/.claude/skills/, .mcp.json is valid JSON, and the venv can import fastmcp

VSCode/GitHubCopilot

Install the Godot Kit bundle from https://github.com/SufficientDaikon/godot-kit into my workspace:

1. Clone the repo to a temp directory
2. Copy each subdirectory from skills/ to ~/.copilot/skills/{name}/
3. Copy agents/AGENTS.md to my project root
4. Create ~/.copilot/agents/ if needed, copy agents/*.agent.md there
5. Create .vscode/mcp-servers/ in my project, copy mcp-servers/*.py there
6. Create a Python venv at .venv/ and pip install fastmcp httpx
7. Copy platforms/vscode/mcp.json to .vscode/mcp.json
8. In .vscode/mcp.json, set GODOT_PATH to my Godot executable (ask me if unsure)
9. On macOS/Linux, change .venv/Scripts/python.exe to .venv/bin/python in the Python server commands
10. Copy docs/copilot-instructions.md to .github/copilot-instructions.md
11. Create .github/prompts/ if needed, copy prompts/ contents there
12. Copy mcp-knowledge/ to my project root
13. Delete the temp clone
14. Verify: ~/.copilot/skills/ has 9 subdirectories, .vscode/mcp.json is valid JSON, .venv has fastmcp

反重力

Install the Godot Kit bundle from https://github.com/SufficientDaikon/godot-kit into this project:

1. Clone the repo to a temp directory
2. Create .antigravity/skills/ if needed
3. For each subdirectory in skills/, copy its SKILL.md to .antigravity/skills/{name}.md
4. Copy agents/AGENTS.md to project root
5. Create .antigravity/mcp-servers/, copy mcp-servers/*.py there
6. Create a Python venv at .venv/ and pip install fastmcp httpx
7. Add MCP server entries to my Antigravity config (gopeak via npx -y gopeak with GODOT_PATH, plus the 3 Python servers)
8. Create .antigravity/prompts/ if needed, copy prompts/ contents there
9. Copy mcp-knowledge/ to project root
10. Delete the temp clone

开爪/其他AI CLIs

Install the Godot Kit bundle from https://github.com/SufficientDaikon/godot-kit:

1. Clone the repo to a temp directory
2. Copy skills/ directory contents to wherever your tool stores skill/instruction files
3. Copy agents/AGENTS.md to project root as agent instructions
4. Copy mcp-servers/*.py to your project, create a Python venv, pip install fastmcp httpx
5. Configure your tool's MCP settings to run the Python servers and use npx -y gopeak with GODOT_PATH set to your Godot executable and GOPEAK_TOOL_PROFILE set to "compact"
6. Copy prompts/ and mcp-knowledge/ to appropriate locations
7. Delete the temp clone

______________________________________________________________________

所得

                         +---------------------------+
                         |   omega-gdscript-expert   |
                         |      (meta-coordinator)   |
                         +---------------------------+
                                     |
              +----------+-----------+-----------+----------+
              |          |           |           |          |
         best-     gdscript-   gdscript-   debugging  particles
        practices   mastery    patterns
              |          |           |           |          |
         genre-     ui-system   mcp-server-
        roguelike               index
                                    |
              +----------+----------+----------+----------+
              |          |          |          |          |
           Gopeak   Context7   Asset Lib  Knowledge  Editor
          (110+     (live       (search/   (local     Logs
           tools)    docs)      download)  patterns)  (tail)

Omega元技能位于顶端。当你的AI助手遇到Godot问题时，Omega会激活正确的专业技能。MCP服务器层为您的助理运行时工具提供了与Godot编辑器交互、查找文档、搜索资源库、查询本地知识索引和读取编辑器日志的功能。

______________________________________________________________________

技能参考

______________________________________________________________________

MCP服务器

______________________________________________________________________

代理

Godot Kit附带了3个代理定义：

______________________________________________________________________

先决条件

______________________________________________________________________

安装脚本

如果您更喜欢脚本安装而不是单提示方法，请使用 install/ 目录。

Windows（PowerShell）

git clone https://github.com/SufficientDaikon/godot-kit.git C:\temp\godot-kit
C:\temp\godot-kit\install\install.ps1 -Platform vscode -GodotPath "C:\Godot\Godot_v4.3-stable_win64.exe"

支持 -Platform 值： claude-code, vscode, antigravity

macOS/Linux（Bash）

git clone https://github.com/SufficientDaikon/godot-kit.git /tmp/godot-kit
bash /tmp/godot-kit/install/install.sh --platform claude-code --godot-path /usr/local/bin/godot

支持 --platform 值： claude-code, vscode, antigravity

这两个脚本执行相同的7个步骤：安装技能、安装代理、复制MCP服务器脚本、创建具有依赖关系的Python venv、使用Godot路径编写MCP配置、复制提示和知识文件，并验证结果。

______________________________________________________________________

配置

设置GODOT_PATH

每个MCP配置都需要知道Godot可执行文件的位置。安装脚本和一个提示指令会自动处理此问题，但如果您以后需要更改它：

Gopeak工具配置文件

Gopeak通过 GOPEAK_TOOL_PROFILE 环境变量：

可选服务器

所有MCP服务器都是可选的。如果您不需要特定的服务器，请从MCP配置文件中删除其条目。这些技能仍然有效——他们只是无法从该服务器调用工具。

______________________________________________________________________

项目结构

godot-kit/
  skills/
    omega-gdscript-expert/     # P1 meta-coordinator
    godot-best-practices/      # P2 scene organization, signals, resources
    godot-gdscript-mastery/    # P2 static typing, signal architecture
    godot-gdscript-patterns/   # P2 state machines, components, scenes
    godot-debugging/           # P2 error interpretation, troubleshooting
    godot-particles/           # P2 GPU particles, shaders
    godot-genre-roguelike/     # P2 procedural generation, permadeath
    godot-ui-system/           # P2 themes, HUD, tweens
    mcp-server-index/          # P3 MCP server registry
  agents/
    AGENTS.md                  # Root agent instructions
    Godot helper.agent.md      # Full Godot helper agent
    Plan.agent.md              # Multi-phase planning agent
  mcp-servers/
    asset_library_server.py    # Godot Asset Library search/download
    knowledge_server.py        # Local knowledge index
    log_server.py              # Editor log tailing
    requirements.txt           # Python dependencies (fastmcp, httpx)
  platforms/
    claude-code/
      install-instructions.md
    vscode/
      mcp.json                 # VSCode MCP server config template
      install-instructions.md
    antigravity/
      install-instructions.md
    open-claw/
      install-instructions.md
  prompts/
    omega-godot-agent.prompt.md
    project-first-reference-only.prompt.xml
  mcp-knowledge/
    knowledge_data/            # Local knowledge index entries
  omniskill-bundle/
    bundle.yaml                # Bundle definition for all skills
    meta-skill/                # Omega meta-skill coordinator
  install/
    install.ps1                # Windows installer
    install.sh                 # macOS/Linux installer
  workflows/
    ci.yml                     # GitHub Actions: Godot build + test
    mcp_verify.yml             # GitHub Actions: MCP verification
    verify_mcp_setup.ps1       # PowerShell MCP verification script
  docs/
    copilot-instructions.md    # GitHub Copilot workspace instructions
    code_examples.md           # Before/after GDScript refactoring
    handoff.md                 # Agent session handoff example
  LICENSE                      # MIT
  README.md

______________________________________________________________________

故障排除

______________________________________________________________________

贡献

欢迎捐款。请参阅 平台/ 随着人工智能工具的发展，可能需要更新的平台特定安装说明目录。

要添加新技能，请执行以下操作：

1. 在下创建新目录 skills/ 带着一个 SKILL.md 文件
2. 将技能添加到 omniskill-bundle/bundle.yaml
3. 更新 mcp-server-index 如果你的技能引入了新的MCP工具布线规则
4. 在提交PR之前，至少使用一个AI平台进行测试

______________________________________________________________________

许可证

麻省理工学院——见 许可证 了解详情。