GitHub - htdt/godogen: Sử dụng Claude Code để xây dựng dự án Godot 4 hoàn chỉnh từ mô tả game

Godogen: Kỹ năng Claude Code xây dựng dự án Godot 4 từ mô tả game

Bạn chỉ cần mô tả những gì bạn muốn. Một chuỗi AI sẽ thiết kế kiến trúc, tạo ra hình ảnh, viết mã, và tạo ra toàn bộ dự án Godot 4. Dự án này bao gồm các cảnh được tổ chức, script rõ ràng và kiến trúc game hợp lý, hỗ trợ cả 2D và 3D và có thể chạy trên phần cứng thông thường.

Cách hoạt động

• Hai kỹ năng Claude Code: Quản lý toàn bộ chuỗi công việc — một lên kế hoạch, một thực hiện. Mỗi nhiệm vụ chạy trong bối cảnh mới để tập trung.
• Dự án Godot 4 thực: Bao gồm cây cảnh hợp lý, script và tổ chức tài nguyên.
• Tạo tài nguyên: Gemini tạo hình ảnh 2D và kết cấu; Tripo3D chuyển đổi hình ảnh thành mô hình 3D.
• Chuyên môn về GDScript: Tham khảo ngôn ngữ tùy chỉnh và tài liệu API để hỗ trợ tạo mã.
• Kiểm tra bằng hình ảnh: Chụp ảnh màn hình từ game chạy thực sự và phân tích. Phát hiện lỗi như z-fighting và kết cấu thiếu rất hiệu quả.
• Chạy trên phần cứng thông thường: Bất kỳ PC nào có Godot và Claude Code đều có thể chạy được.

Bắt đầu

Yêu cầu

• Godot 4 (headless hoặc editor) trên PATH
• Cài Claude Code
• Khóa API làm biến môi trường:
  • GOOGLE_API_KEY cho Gemini (tạo hình ảnh và kiểm tra bằng hình ảnh)
  • TRIPO3D_API_KEY cho Tripo3D (chuyển đổi hình ảnh 3D)
• Python 3 với pip
• Đã thử nghiệm trên Ubuntu và Debian. MacOS chưa kiểm tra, cần cấu hình khác cho captura.

Tạo dự án game

Chạy script publish.sh để tạo thư mục dự án mới gồm tất cả kỹ năng:

./publish.sh ~/my-game # Sử dụng teleforge.md làm CLAUDE.md
./publish.sh ~/my-game local.md # Sử dụng CLAUDE.md tùy chỉnh

Điều này tạo ra thư mục với .claude/skills/ và CLAUDE.md, sau đó khởi tạo repo git. Mở Claude Code trong thư mục đó và bắt đầu chỉ định game cần tạo.

Chạy trên VM

Một phiên chạy có thể kéo dài vài giờ. Chạy trên VM đám mây giúp máy tính của bạn rảnh rỗi và cung cấp GPU để chụp hình từ Godot.

Các kỹ năng hoạt động tốt nhất với Claude Code Opus 4.6. Sonnet 4.6 hoạt động nhưng cần hướng dẫn nhiều hơn từ người dùng.

Lộ trình

• Di cư tạo hình ảnh sang grok-imagine-image
• Di cư sprite sheet sang grok-imagine-video
• Thêm hướng dẫn cho xuất bản game (Android)
• Xuất bản game đầy đủ như demo công khai

Theo dõi tiến trình: @alex_erm