Initial commit

2025-11-30 09:08:19 +08:00
commit db818a4853
17 changed files with 4551 additions and 0 deletions
--- a/commands/restart.md
+++ b/commands/restart.md
@@ -0,0 +1,141 @@
+---
+description: Quickly restart the running Godot game
+allowed_tools:
+  - mcp__godot__stop_project
+  - mcp__godot__run_project
+  - mcp__godot__get_debug_output
+---
+
+Quickly restart the running Godot project for fast iteration during development.
+
+# Process
+
+1. **Stop the current instance**
+   - Use mcp__godot__stop_project to stop the running game
+   - Display: `♻️  Restarting game...`
+
+2. **Wait briefly** (0.5 seconds) for clean shutdown
+
+3. **Start the project again**
+   - Use mcp__godot__run_project with projectPath set to current working directory
+
+4. **Get initial output**
+   - Wait 1.5 seconds
+   - Use mcp__godot__get_debug_output to check for errors
+
+5. **Display result**
+
+## If restart successful:
+```
+✓ Game restarted successfully!
+
+  Quick stats:
+  • Restart time: <elapsed_time>
+  • Status: Running
+
+  Commands:
+    /gd:restart     Restart again
+    /gd:debug       View debug output
+    /gd:stop        Stop the game
+
+  💡 Tip: Keep this workflow for rapid iteration:
+     Edit code → Save → /gd:restart → Test
+```
+
+## If errors occurred:
+```
+⚠ Game restarted with errors:
+
+<formatted_errors>
+
+  Use /gd:debug for detailed error information
+
+  Commands:
+    /gd:debug       View full debug output
+    /gd:stop        Stop the game
+
+  Would you like help fixing these errors?
+```
+
+## If no game was running:
+```
+ℹ No game was running. Starting fresh...
+
+<use same output as /gd:run>
+```
+
+# Usage Tips
+
+Display these tips the first time user runs /gd:restart:
+
+```
+💡 Restart Command Tips:
+
+   1. Fast Iteration: Use /gd:restart after making code changes
+      instead of manually stopping and starting the game.
+
+   2. Keyboard Shortcut: Save this command for quick access
+      (check if your terminal supports command aliases)
+
+   3. Watch Your Console: Errors from the restart will be
+      displayed immediately.
+
+   4. No Need to Stop First: /gd:restart handles stopping
+      automatically.
+
+   Typical workflow:
+   1. Make changes to your code
+   2. Save (Cmd+S / Ctrl+S)
+   3. Run /gd:restart
+   4. Test your changes
+   5. Repeat!
+```
+
+# Performance Optimization
+
+Track restart metrics for user feedback:
+```
+📊 Restart Performance:
+   • This restart: 2.1s
+   • Average: 2.3s
+   • Fastest: 1.8s
+
+   Your game restarts quickly! This is great for iteration.
+```
+
+# Error Recovery
+
+If restart fails:
+```
+❌ Restart failed!
+
+   Possible causes:
+   - Previous instance didn't shut down cleanly
+   - Godot editor is not responding
+   - MCP server connection issue
+
+   Try these steps:
+   1. Wait a few seconds and try again
+   2. Check if Godot editor is running
+   3. Run /gd:setup to verify MCP configuration
+
+   Or manually:
+   1. /gd:stop (ensure game stops)
+   2. /gd:run (start fresh)
+```
+
+# Integration with Error Monitoring
+
+After restart, if errors detected, activate godot-debugging skill hints:
+```
+🔍 Detected issues in restart:
+
+   [ERROR] Null instance in player.gd:45
+
+   Common cause: Node references changed or removed
+
+   Quick fix: Verify all @onready var paths are correct
+              after scene modifications.
+
+   Want detailed help? Just ask about this error!
+```