godot-mcp: Skill for Claude Code

Godot 测试调试专家技能

技能概述

godot-test-debugger 是专门用于 Godot 游戏测试和调试的智能化技能，能够根据用户的自然语言描述自动完成单元测试、集成测试、性能测试、错误诊断、调试工具创建、问题定位等全面的测试调试工作。

核心功能

🧪 自动化测试系统

• 单元测试：自动生成和运行单元测试
• 集成测试：复杂场景的集成测试
• 性能测试：帧率、内存、加载性能测试
• 回归测试：版本更新后的回归检测

🔍 智能错误诊断

• 异常捕获：全面的游戏异常捕获和分类
• 错误分析：深度分析错误原因和影响范围
• 修复建议：提供具体的修复方案和代码建议
• 预防措施：预防同类错误的再次发生

🛠️ 调试工具生成

• 调试界面：创建功能完整的调试UI界面
• 日志系统：智能日志记录和分类系统
• 性能监控：实时性能监控和可视化
• 状态检查器：游戏状态实时检查工具

📊 测试报告生成

• 测试覆盖度：代码覆盖度和功能覆盖度分析
• 缺陷统计：缺陷分类、优先级和趋势分析
• 性能报告：详细的性能分析报告
• 质量评估：整体代码质量评估和建议

使用方法

单元测试创建

用户: "为我的角色控制系统创建完整的单元测试"
系统: 自动实现：
- 分析角色控制系统的所有功能
- 生成移动、跳跃、攻击等测试用例
- 创建边界条件和异常情况测试
- 设置测试数据和预期结果
- 运行测试并生成报告

性能测试实施

用户: "测试游戏在1000个敌人同时存在时的性能表现"
系统: 智能测试：
- 创建大规模场景测试环境
- 监控帧率、内存、CPU使用率
- 测试不同设备配置下的表现
- 分析性能瓶颈和优化建议
- 生成详细的性能测试报告

错误诊断和修复

玩家报告游戏在某个关卡崩溃，需要找出问题"
系统: 全面诊断：
- 分析崩溃日志和错误信息
- 重现崩溃场景和条件
- 定位问题代码和根本原因
- 提供多种修复方案
- 验证修复效果

调试工具创建

用户: "为开发团队创建一个完整的调试工具界面"
系统: 智能生成：
- 实时性能监控面板
- 游戏状态查看和修改工具
- 场景导航和对象检查器
- 命令控制台和脚本执行器
- 日志查看和过滤系统

工作流程

1. 测试需求分析

# 分析测试需求
- 识别核心功能模块
- 确定测试类型和范围
- 评估测试复杂度和优先级
- 制定测试计划和时间安排

2. 测试用例设计

# 设计测试用例
- 正常功能测试用例
- 边界条件测试用例
- 异常情况测试用例
- 性能压力测试用例

3. 自动测试实施

# 执行自动化测试
- 生成测试代码
- 配置测试环境
- 运行测试套件
- 收集测试结果

4. 问题诊断修复

# 诊断和修复问题
- 分析测试失败原因
- 定位问题代码位置
- 提供修复建议
- 验证修复效果

MCP 工具集成

测试执行工具

• create_test_scene - 创建测试场景
• run_unit_test - 运行单元测试
• run_integration_test - 运行集成测试
• run_performance_test - 运行性能测试

调试分析工具

• analyze_error_log - 分析错误日志
• detect_memory_leaks - 检测内存泄漏
• profile_script_performance - 分析脚本性能
• debug_node_hierarchy - 调试节点层次

代码质量工具

• check_code_coverage - 检查代码覆盖度
• analyze_code_complexity - 分析代码复杂度
• validate_script_syntax - 验证脚本语法
• check_naming_conventions - 检查命名规范

报告生成工具

• generate_test_report - 生成测试报告
• create_bug_report - 创建缺陷报告
• export_performance_data - 导出性能数据
• visualize_test_results - 可视化测试结果