Back to Details

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)

  1. godot-project-creator - 项目创建器
  2. godot-gameplay-developer - 玩法开发
  3. godot-ui-designer - UI设计器
  4. godot-animation-studio - 动画工作室
  5. godot-performance-optimizer - 性能优化器
  6. godot-test-debugger - 测试调试器
  7. godot-product-polisher - 产品打磨器
  1. godot-project-creator - Project Creator
  2. godot-gameplay-developer - Gameplay Developer
  3. godot-ui-designer - UI Designer
  4. godot-animation-studio - Animation Studio
  5. godot-performance-optimizer - Performance Optimizer
  6. godot-test-debugger - Test Debugger
  7. godot-product-polisher - Product Polisher

🔧 专业功能技能 (5个)

🔧 Professional Function Skills (5)

  1. godot-batch-operations - 批量操作器
  2. godot-camera-system - 相机系统
  3. godot-material-manager - 材质管理器
  4. godot-resource-workflow - 资源工作流
  5. godot-compatibility-checker - 兼容性检查器
  1. godot-batch-operations - Batch Operations Tool
  2. godot-camera-system - Camera System
  3. godot-material-manager - Material Manager
  4. godot-resource-workflow - Resource Workflow
  5. godot-compatibility-checker - Compatibility Checker

📚 支持辅助技能 (3个)

📚 Support & Auxiliary Skills (3)

  1. context7-auto-research - 自动研究员
  2. chinese-dev-guide - 中文开发指南
  3. gdscript-syntax-guide - GDScript语法指南
  1. context7-auto-research - Auto Researcher
  2. chinese-dev-guide - Chinese Development Guide
  3. gdscript-syntax-guide - GDScript Syntax Guide

🎯 使用方式

🎯 Usage Methods

用户只需用自然语言描述需求，系统会自动：
  1. 检测MCP连接 → 确保Godot通信正常
  2. 分析用户意图 → 识别具体需求类型
  3. 选择最佳技能 → 智能匹配专业技能
  4. 调用子技能 → 执行具体功能(仅通过MCP工具)
  5. 返回结果 → 提供详细的处理结果
Users only need to describe their needs in natural language, and the system will automatically:
  1. Detect MCP Connection → Ensure normal Godot communication
  2. Analyze User Intent → Identify specific demand types
  3. Select Optimal Skill → Intelligently match professional skills
  4. Invoke Sub-skill → Execute specific functions (only via MCP tools)
  5. 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

  1. MCP连接检测 - 每次调用前必须执行
  2. 意图识别 - 分析用户具体需求
  3. 技能匹配 - 选择最适合的子技能
  4. 容错处理 - 提供后备方案
  1. MCP Connection Detection - Must be executed before each invocation
  2. Intent Recognition - Analyze user's specific needs
  3. Skill Matching - Select the most suitable sub-skill
  4. 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!