godot-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Godot技能统一入口

Unified Entry for Godot Skills

技能目标

Skill Objectives

作为所有Godot相关技能的统一入口，根据用户描述智能选择最适合的子技能，并确保在调用任何子技能前MCP连接正常。用户无需了解15个具体技能的功能，系统会自动处理MCP连接状态。

Serve as the unified entry for all Godot-related skills, intelligently select the most suitable sub-skills based on user descriptions, and ensure the MCP connection is normal before invoking any sub-skills. Users don't need to understand the functions of the 15 specific skills, as the system will automatically handle the MCP connection status.

🔌 MCP连接管理

🔌 MCP Connection Management

连接检测

Connection Detection

自动检测：每次调用技能前自动检测MCP连接状态
连接验证：通过
```
mcp__godot-mcp__get_project_info
```
验证连接
状态报告：清晰的连接状态显示

Automatic Detection: Automatically detect MCP connection status before each skill invocation
Connection Verification: Verify connection via
```
mcp__godot-mcp__get_project_info
```
Status Reporting: Clear display of connection status

自动启动

Automatic Startup

集成auto-launcher：内置
```
godot-mcp-auto-launcher
```
功能
自动启动：连接失败时自动启动MCP服务器
重试机制：智能重试和错误恢复

Integrated auto-launcher: Built-in
```
godot-mcp-auto-launcher
```
functionality
Automatic Startup: Automatically start the MCP server when connection fails
Retry Mechanism: Intelligent retry and error recovery

严格约束

Strict Constraints

仅使用MCP工具：所有Godot操作必须通过
```
mcp__godot-mcp__*
```
工具
禁止直接操作：不能直接读写Godot项目文件
安全优先：确保项目数据安全

MCP Tools Only: All Godot operations must be performed using
```
mcp__godot-mcp__*
```
tools
No Direct Operations: Cannot directly read or write Godot project files
Security First: Ensure project data security

📚 集成的子技能 (15个)

📚 Integrated Sub-skills (15)

🎯 核心开发技能 (7个)

🎯 Core Development Skills (7)

godot-project-creator - 项目创建器
godot-gameplay-developer - 玩法开发
godot-ui-designer - UI设计器
godot-animation-studio - 动画工作室
godot-performance-optimizer - 性能优化器
godot-test-debugger - 测试调试器
godot-product-polisher - 产品打磨器

godot-project-creator - Project Creator
godot-gameplay-developer - Gameplay Developer
godot-ui-designer - UI Designer
godot-animation-studio - Animation Studio
godot-performance-optimizer - Performance Optimizer
godot-test-debugger - Test Debugger
godot-product-polisher - Product Polisher

🔧 专业功能技能 (5个)

🔧 Professional Function Skills (5)

godot-batch-operations - 批量操作器
godot-camera-system - 相机系统
godot-material-manager - 材质管理器
godot-resource-workflow - 资源工作流
godot-compatibility-checker - 兼容性检查器

godot-batch-operations - Batch Operations Tool
godot-camera-system - Camera System
godot-material-manager - Material Manager
godot-resource-workflow - Resource Workflow
godot-compatibility-checker - Compatibility Checker

📚 支持辅助技能 (3个)

📚 Support & Auxiliary Skills (3)

context7-auto-research - 自动研究员
chinese-dev-guide - 中文开发指南
gdscript-syntax-guide - GDScript语法指南

context7-auto-research - Auto Researcher
chinese-dev-guide - Chinese Development Guide
gdscript-syntax-guide - GDScript Syntax Guide

🎯 使用方式

🎯 Usage Methods

用户只需用自然语言描述需求，系统会自动：

检测MCP连接 → 确保Godot通信正常
分析用户意图 → 识别具体需求类型
选择最佳技能 → 智能匹配专业技能
调用子技能 → 执行具体功能(仅通过MCP工具)
返回结果 → 提供详细的处理结果

Users only need to describe their needs in natural language, and the system will automatically:

Detect MCP Connection → Ensure normal Godot communication
Analyze User Intent → Identify specific demand types
Select Optimal Skill → Intelligently match professional skills
Invoke Sub-skill → Execute specific functions (only via MCP tools)
Return Results → Provide detailed processing results

MCP连接检测流程

MCP Connection Detection Flow

用户请求 → 检测MCP连接 → [连接正常] → 继续处理
                ↓
            [连接失败] → 启动MCP服务器 → 重试检测 → 继续处理
                ↓
            [启动失败] → 报告错误 → 提供解决方案

User Request → Detect MCP Connection → [Connection Normal] → Continue Processing
                ↓
            [Connection Failed] → Start MCP Server → Retry Detection → Continue Processing
                ↓
            [Startup Failed] → Report Error → Provide Solutions

示例对话

Example Conversations

用户: 我想创建一个2D平台游戏项目
系统: [MCP检测: 连接正常] → [检测: 项目创建] → 调用godot-project-creator → 生成完整项目架构

用户: 实现角色跳跃和移动机制
系统: [MCP检测: 连接正常] → [检测: 玩法开发] → 调用godot-gameplay-developer → 创建物理系统

用户: 设计血条和主菜单界面
系统: [MCP检测: 连接正常] → [检测: UI设计] → 调用godot-ui-designer → 创建界面布局

用户: 优化游戏性能，提升帧率
系统: [MCP检测: 连接正常] → [检测: 性能优化] → 调用godot-performance-optimizer → 分析并优化

User: I want to create a 2D platformer game project
System: [MCP Detection: Connection Normal] → [Detection: Project Creation] → Invoke godot-project-creator → Generate complete project structure

User: Implement character jumping and movement mechanics
System: [MCP Detection: Connection Normal] → [Detection: Gameplay Development] → Invoke godot-gameplay-developer → Create physics system

User: Design health bar and main menu interface
System: [MCP Detection: Connection Normal] → [Detection: UI Design] → Invoke godot-ui-designer → Create interface layout

User: Optimize game performance and improve frame rate
System: [MCP Detection: Connection Normal] → [Detection: Performance Optimization] → Invoke godot-performance-optimizer → Analyze and optimize

如果MCP未连接的情况

If MCP is not connected

用户: 修复这个兼容性问题系统: [MCP检测: 连接失败] → [启动MCP服务器] → [重试检测成功] → [检测: 兼容性] → 调用兼容性检查器

undefined

User: Fix this compatibility issue System: [MCP Detection: Connection Failed] → [Start MCP Server] → [Retry Detection Successful] → [Detection: Compatibility] → Invoke compatibility checker

undefined

🧠 智能匹配规则

🧠 Intelligent Matching Rules

项目创建类

Project Creation Category

关键词：创建、新建、项目、初始化、开始、project、create、setup → 选择：godot-project-creator

Keywords: create, new, project, initialize, start, project, create, setup → Select: godot-project-creator

玩法开发类

Gameplay Development Category

关键词：玩法、逻辑、机制、系统、功能、gameplay、logic、mechanic、feature → 选择：godot-gameplay-developer

Keywords: gameplay, logic, mechanism, system, feature, gameplay, logic, mechanic, feature → Select: godot-gameplay-developer

UI设计类

UI Design Category

关键词：界面、UI、菜单、按钮、交互、interface、menu、hud、dialog → 选择：godot-ui-designer

Keywords: interface, UI, menu, button, interaction, interface, menu, hud, dialog → Select: godot-ui-designer

动画特效类

Animation & Effects Category

关键词：动画、特效、粒子、资源、animation、effects、particles、visual → 选择：godot-animation-studio

Keywords: animation, effects, particles, resource, animation, effects, particles, visual → Select: godot-animation-studio

性能优化类

Performance Optimization Category

关键词：性能、优化、帧率、内存、适配、performance、optimize、fps → 选择：godot-performance-optimizer

Keywords: performance, optimize, frame rate, memory, adaptation, performance, optimize, fps → Select: godot-performance-optimizer

测试调试类

Testing & Debugging Category

关键词：测试、调试、错误、bug、test、debug、unit、integration → 选择：godot-test-debugger

Keywords: test, debug, error, bug, test, debug, unit, integration → Select: godot-test-debugger

兼容性检查类

Compatibility Check Category

关键词：兼容性、版本、迁移、API、version、migration、upgrade → 选择：godot-compatibility-checker

Keywords: compatibility, version, migration, API, version, migration, upgrade → Select: godot-compatibility-checker

文档研究类

Documentation & Research Category

关键词：文档、研究、API、查询、documentation、research、latest → 选择：context7-auto-research

Keywords: documentation, research, API, query, documentation, research, latest → Select: context7-auto-research

中文支持类

Chinese Support Category

关键词：中文、本地化、双语、环境、chinese、localization → 选择：chinese-dev-guide

Keywords: chinese, localization, bilingual, environment, chinese, localization → Select: chinese-dev-guide

语法指南类

Syntax Guide Category

关键词：语法、GDScript、规范、代码、syntax、gdscript、style → 选择：gdscript-syntax-guide

Keywords: syntax, GDScript, specification, code, syntax, gdscript, style → Select: gdscript-syntax-guide

🔧 技能目录结构

🔧 Skill Directory Structure

godot-skills/
├── SKILL.md                    # 主技能定义
├── sub-skills/                 # 子技能目录 (15个专业技能)
│   ├── godot-project-creator/
│   ├── godot-gameplay-developer/
│   ├── godot-ui-designer/
│   ├── godot-animation-studio/
│   ├── godot-performance-optimizer/
│   ├── godot-test-debugger/
│   ├── godot-product-polisher/
│   ├── godot-batch-operations/
│   ├── godot-camera-system/
│   ├── godot-material-manager/
│   ├── godot-resource-workflow/
│   ├── godot-compatibility-checker/
│   ├── context7-auto-research/
│   ├── chinese-dev-guide/
│   ├── gdscript-syntax-guide/
│   └── skill-creator_技能创建器/

godot-skills/
├── SKILL.md                    # Main skill definition
├── sub-skills/                 # Sub-skills directory (15 professional skills)
│   ├── godot-project-creator/
│   ├── godot-gameplay-developer/
│   ├── godot-ui-designer/
│   ├── godot-animation-studio/
│   ├── godot-performance-optimizer/
│   ├── godot-test-debugger/
│   ├── godot-product-polisher/
│   ├── godot-batch-operations/
│   ├── godot-camera-system/
│   ├── godot-material-manager/
│   ├── godot-resource-workflow/
│   ├── godot-compatibility-checker/
│   ├── context7-auto-research/
│   ├── chinese-dev-guide/
│   ├── gdscript-syntax-guide/
│   └── skill-creator_技能创建器/

🔧 MCP错误处理

🔧 MCP Error Handling

连接失败处理

Connection Failure Handling

自动重试：MCP连接失败时自动重试3次
启动MCP：重试失败时调用
```
godot-mcp-auto-launcher
```
启动服务器
端口检测：支持9080和9081端口的自动检测
错误诊断：提供详细的错误信息和解决方案

Automatic Retry: Automatically retry 3 times when MCP connection fails
Start MCP: Invoke
```
godot-mcp-auto-launcher
```
to start the server if retries fail
Port Detection: Support automatic detection of ports 9080 and 9081
Error Diagnosis: Provide detailed error information and solutions

常见问题解决

Common Problem Solutions

问题1: "MCP连接失败"
解决: 自动启动MCP服务器，检测端口占用

问题2: "Godot编辑器未启动"
解决: 提醒用户启动Godot编辑器并启用MCP插件

问题3: "权限不足"
解决: 提供权限配置指导和解决方案

Problem 1: "MCP Connection Failed"
Solution: Automatically start the MCP server and detect port occupancy

Problem 2: "Godot Editor Not Started"
Solution: Remind users to start the Godot Editor and enable the MCP plugin

Problem 3: "Insufficient Permissions"
Solution: Provide permission configuration guidance and solutions

⚠️ 重要规则

⚠️ Important Rules

MCP工具使用约束

MCP Tool Usage Constraints

仅使用MCP工具：所有Godot操作必须通过
```
mcp__godot-mcp__*
```
工具
禁止直接文件操作：不能直接读写Godot项目文件(.tscn, .gd, .tres等)
安全优先：确保项目数据安全，避免意外修改
工具验证：每次操作前验证MCP工具可用性

MCP Tools Only: All Godot operations must be performed using
```
mcp__godot-mcp__*
```
tools
No Direct File Operations: Cannot directly read or write Godot project files (.tscn, .gd, .tres, etc.)
Security First: Ensure project data security and avoid accidental modifications
Tool Verification: Verify MCP tool availability before each operation

技能设计原则

Skill Design Principles

不依赖外部包：仅使用技能系统提供的功能
纯技能调用：通过Skill工具调用子技能
智能路由：基于关键词和模式匹配选择技能
容错处理：提供后备技能建议和错误恢复

No External Dependencies: Only use functions provided by the skill system
Pure Skill Invocation: Invoke sub-skills via Skill tools
Intelligent Routing: Select skills based on keyword and pattern matching
Fault Tolerance Handling: Provide backup skill suggestions and error recovery

MCP强制检查

MCP Mandatory Checks

连接前置：任何Godot操作前必须检测MCP连接
工具验证：验证所有MCP工具的可用性
状态报告：实时报告MCP连接状态
自动恢复：连接失败时自动尝试恢复

Connection Pre-check: Must detect MCP connection before any Godot operation
Tool Verification: Verify the availability of all MCP tools
Status Reporting: Real-time reporting of MCP connection status
Automatic Recovery: Automatically attempt recovery when connection fails

🎯 技能触发模式

🎯 Skill Trigger Modes

自动触发条件

Automatic Trigger Conditions

检测到Godot相关关键词
提到游戏开发、UI设计、性能优化等
需要项目创建或功能实现
MCP连接检测(最高优先级)

Detect Godot-related keywords
Mention game development, UI design, performance optimization, etc.
Need project creation or feature implementation
MCP Connection Detection(highest priority)

触发优先级

Trigger Priority

MCP连接检测 - 每次调用前必须执行
意图识别 - 分析用户具体需求
技能匹配 - 选择最适合的子技能
容错处理 - 提供后备方案

MCP Connection Detection - Must be executed before each invocation
Intent Recognition - Analyze user's specific needs
Skill Matching - Select the most suitable sub-skill
Fault Tolerance Handling - Provide backup solutions

MCP前置检查流程

MCP Pre-check Flow

用户请求 → [强制] MCP连接检测 → [成功] 意图分析 → 技能执行
                          ↓
                      [失败] 启动MCP → 重试检测 → 意图分析
                          ↓
                      [启动失败] 错误报告 → 解决方案

User Request → [Mandatory] MCP Connection Detection → [Success] Intent Analysis → Skill Execution
                          ↓
                      [Failed] Start MCP → Retry Detection → Intent Analysis
                          ↓
                      [Startup Failed] Error Report → Solutions

后备机制

Backup Mechanisms

MCP连接失败：自动调用godot-mcp-auto-launcher
技能匹配失败：提供相关技能列表
用户手动选择：允许指定特定技能
错误恢复：提供详细的使用建议

MCP Connection Failure: Automatically invoke godot-mcp-auto-launcher
Skill Matching Failure: Provide a list of related skills
Manual User Selection: Allow specifying a specific skill
Error Recovery: Provide detailed usage suggestions

MCP工具验证列表

MCP Tool Verification List

```
mcp__godot-mcp__get_project_info
```
- 项目信息获取
```
mcp__godot-mcp__create_node
```
- 节点创建
```
mcp__godot-mcp__update_node_property
```
- 节点属性更新
```
mcp__godot-mcp__create_script
```
- 脚本创建
```
mcp__godot-mcp__open_scene
```
- 场景打开
其他相关MCP工具...

目标: 为Godot开发者提供最便捷的技能统一入口，让复杂的开发工作变得简单高效！

```
mcp__godot-mcp__get_project_info
```
- Project Information Retrieval
```
mcp__godot-mcp__create_node
```
- Node Creation
```
mcp__godot-mcp__update_node_property
```
- Node Property Update
```
mcp__godot-mcp__create_script
```
- Script Creation
```
mcp__godot-mcp__open_scene
```
- Scene Opening
Other related MCP tools...

Goal: Provide the most convenient unified entry for Godot developers, making complex development work simple and efficient!