Nếu bạn từng yêu cầu AI “làm một game 3D”, rất có thể thứ nhận được chỉ là một cảnh gồm các khối có thể di chuyển: chuyển động nhân vật cứng nhắc, chiến đấu thiếu phản hồi, tài nguyên phải tự chuẩn bị, cuối cùng còn phải tự thiết lập môi trường mới có thể chạy. Mục tiêu của 歸藏 Game Skill là cung cấp cho trợ lý lập trình AI một quy trình sản xuất đã được kiểm chứng qua dự án thực tế, để AI có thể tiến hành theo từng giai đoạn, từ làm rõ yêu cầu, chuẩn bị tài nguyên, thiết kế chuyển động và chiến đấu cho đến kiểm thử và đóng gói.
Bài viết này lấy dự án demo 《雾锁山门》 trong kho mã làm bối cảnh, giới thiệu cách cài đặt và sử dụng Skill này, cũng như cách đưa ra yêu cầu game để AI dễ thực hiện hơn.
歸藏 Game Skill là gì
Đây là một Skill dành cho các trợ lý lập trình AI như Claude Code và Codex. Sau khi cài đặt, bạn có thể trực tiếp mô tả game muốn làm, chẳng hạn như “tạo một game hành động 3D trên web, góc nhìn từ trên xuống, đề tài võ hiệp”. AI sẽ trước tiên hỏi về tác phẩm tham khảo, góc nhìn, bầu không khí, phạm vi game, công cụ tài nguyên và hạn mức có thể sử dụng, sau đó triển khai từng bước theo quy trình.
Đây không phải là một game engine tự động tạo ra sản phẩm hoàn chỉnh, cũng không phải công cụ có thể hoàn thành mọi việc chỉ bằng một câu lệnh. Nó giống một bộ quy chuẩn sản xuất dự án dành cho AI hơn, bao gồm kế hoạch theo giai đoạn, các điểm kiểm tra, đề xuất về cảm giác chiến đấu, phương pháp tạo tài nguyên, các vấn đề thường gặp và script đóng gói.
Dự án demo có thể làm được gì
《雾锁山门》 trong kho mã là một game hành động 3D góc nhìn từ trên xuống, đề tài tiên hiệp, bao gồm một màn chơi, một trận chạm trán với quái nhỏ và một trận Boss, kèm cốt truyện và lồng tiếng. Bạn có thể chơi thử trực tiếp tại trang demo trực tuyến, không cần cài đặt.
- Hình ảnh: Bao gồm cỏ lay động theo gió, hiệu ứng sương mù nhiều lớp, tuyết, núi xa và phản chiếu trên các bệ đá mặt nước, được xây dựng bằng three.js và WebGL có khả năng tương thích tốt.
- Nhân vật và bối cảnh: Sử dụng 5 nhân vật 3D có xương, 2 vũ khí, 12 loại đạo cụ bối cảnh và 5 loại vật phẩm rơi.
- Chiến đấu: Bao gồm combo 3 đòn, né tránh, đỡ đòn, phản đòn, kết liễu, uống thuốc, ngự kiếm và tuyệt kỹ “Vạn Kiếm Quy Tông”; Boss có chiến đấu 2 giai đoạn.
- Âm thanh: Bao gồm lồng tiếng, nhạc nền, âm thanh môi trường và hiệu ứng chiến đấu, tổng cộng có 8 đoạn lồng tiếng.
- Phát hành: Mã nguồn có thể được xây dựng thành website tĩnh trực tuyến, tệp HTML đơn khoảng 33MB hoặc gói ngoại tuyến dành cho container bị hạn chế.
Cài đặt Skill
Sử dụng Git để clone
Nếu sử dụng Claude Code, bạn có thể clone kho mã vào thư mục skills tương ứng:
git clone https://github.com/op7418/guizang-game-skill ~/.claude/skills/guizang-game-skillKhi sử dụng Codex hoặc công cụ lập trình AI khác, hãy đặt kho mã vào thư mục skills theo quy ước của công cụ đó. Sau khi cài đặt xong, hãy mở lại hoặc làm mới môi trường lập trình AI để môi trường có thể đọc nội dung Skill.
Chuẩn bị môi trường chạy và công cụ tài nguyên
Dự án yêu cầu cài đặt cục bộ Node.js 18+, chủ yếu dùng để chạy máy chủ cục bộ và thực hiện quy trình đóng gói. Công cụ tài nguyên không bắt buộc tuyệt đối, nhưng sẽ ảnh hưởng rõ rệt đến chất lượng cuối cùng.
- Tripo: Dùng để chuyển hình ảnh thành mô hình 3D và thực hiện gắn xương.
- 即梦 hoặc công cụ tạo hình ảnh khác: Dùng cho hình thiết lập nhân vật, biểu tượng, chữ tiêu đề và các tài nguyên khác; cũng có thể chuẩn bị phần lồng tiếng.
- Suno: Dùng để tạo nhạc nền; Skill có thể hỗ trợ sắp xếp prompt âm nhạc.
Nếu không có các dịch vụ này, bạn có thể sử dụng mô hình miễn phí, hình học tạo theo thuật toán và các tài nguyên miễn phí khác, nhưng chất lượng hình ảnh có thể giảm. Trong dự án thực tế, trước hết tạo hình thiết lập nhân vật, sau đó chuyển hình thiết lập thành mô hình 3D thường dễ đạt kết quả ổn định hơn so với việc trực tiếp tạo mô hình bằng văn bản.
Lần đầu sử dụng: Đưa ra yêu cầu cho AI
Sau khi cài đặt Skill, không nên chỉ nhập “làm một game 3D”. Bạn nên nói rõ trước về đề tài, góc nhìn, nền tảng, phạm vi lối chơi và các công cụ hiện có. Dưới đây là một câu lệnh mẫu phù hợp để bắt đầu dự án:
Làm một game hành động 3D trên web, đề tài võ hiệp, góc nhìn từ trên xuống, gồm một màn chơi, một đợt quái nhỏ và một Boss.
Tôi có thể sử dụng Tripo và 即梦.AI thường sẽ tiếp tục hỏi chi tiết dựa trên yêu cầu này. Bạn có thể bổ sung video tham khảo, phong cách mỹ thuật mong muốn, thiết bị mục tiêu, có cần hỗ trợ cảm ứng trên điện thoại hay không, thời lượng game dự kiến và có cần xuất thành tệp HTML đơn hay không.
Nguyên tắc quan trọng là trước tiên hãy để AI nghiên cứu và lập kế hoạch, sau đó mới bắt đầu viết mã. Video tham khảo, nền tảng mục tiêu và điều kiện tài nguyên càng rõ ràng thì càng ít phải làm lại về sau.
Quy trình sản xuất đầy đủ
歸藏 Game Skill chia quy trình sản xuất thành 5 giai đoạn sau:
- Nghiên cứu và lập kế hoạch: Phân tích tác phẩm tham khảo, xác định góc nhìn, lối chơi, phạm vi bối cảnh và kế hoạch theo giai đoạn, đồng thời ghi lại phương thức triển khai.
- Thiết lập và tài nguyên: Xây dựng thế giới và hình thiết lập nhân vật, chuyển hình ảnh thành mô hình 3D rồi hoàn tất việc gắn xương.
- Chuyển động: Sử dụng các chuyển động dựng sẵn do nền tảng tài nguyên cung cấp; với phần còn thiếu, tính toán vị trí tay chân trong tư thế bằng chương trình.
- Cảm giác điều khiển và hiệu ứng: Lần lượt triển khai các phản hồi chiến đấu như động tác chuẩn bị, động tác hồi kết, khựng hình khi trúng đòn, đánh bật, đỡ đòn, phản đòn và ngắt bằng né tránh; đồng thời sử dụng lưới và shader để tạo hiệu ứng.
- Âm thanh và đóng gói: Thêm hiệu ứng âm thanh, lồng tiếng và nhạc nền, nén tài nguyên, sau đó xây dựng phiên bản trực tuyến, phiên bản tệp đơn hoặc phiên bản dành cho container bị hạn chế.
Để AI tự xác minh kết quả
Một trọng điểm của Skill này là yêu cầu AI không chỉ kiểm tra xem console có báo lỗi hay không mà còn phải trực tiếp quan sát hình ảnh. Quy trình khuyến nghị chuẩn bị sớm các công cụ tự kiểm thử, để AI có thể tiến từng khung hình, truy cập trực tiếp màn chơi chỉ định thông qua tham số URL và dùng bảng chẩn đoán F3 để xem trạng thái chạy.
AI có thể tự chụp ảnh màn hình, sau đó đối chiếu với yêu cầu để kiểm tra vị trí nhân vật, góc nhìn camera, hiệu ứng, UI và trạng thái chiến đấu. Bạn vẫn cần chơi thử và phản hồi, nhưng không phải lần nào cũng tự mình tìm kiếm các vấn đề hình ảnh rõ ràng.
Khi phản hồi, bạn không cần sử dụng thuật ngữ chuyên môn. Chẳng hạn, bạn có thể nói “chuyển động rất cứng”, “cảm giác đánh rất tệ”, “camera bị mái nhà che khuất” hoặc “nhân vật trông nhỏ đi một nửa”. Skill sẽ hỗ trợ AI chuyển những mô tả này thành các nhiệm vụ kiểm tra và chỉnh sửa có thể thực hiện.
Thiết kế cảm giác chiến đấu cơ bản
Đối với game hành động, chức năng chạy được không có nghĩa là cảm giác điều khiển đã đạt yêu cầu. Skill nhấn mạnh các điểm sau trong quy trình chiến đấu:
- Thiết lập thời gian chuẩn bị trước khi tấn công và thời gian hồi kết sau khi ra đòn để chuyển động có nhịp điệu.
- Thêm một khoảng khựng hình ngắn khi đánh trúng để làm nổi bật phản hồi tấn công.
- Thiết lập mức độ đánh bật khác nhau tùy theo loại tấn công.
- Phân biệt đỡ đòn thông thường và phản đòn, đồng thời cho phép né tránh ngắt chuyển động hiện tại.
- Để kẻ địch tấn công luân phiên, tránh việc tất cả kẻ địch cùng lúc vây đánh người chơi.
- Thiết kế các biến đổi chiến đấu như giai đoạn 2, cảnh đứng dậy và lời thoại cho Boss.
Khi triển khai, nên xem các mục này như một danh sách kiểm tra và xác minh từng mục, thay vì chỉ tập trung vào việc nhân vật có thể di chuyển hay tấn công. Các năng lực như combo, kiếm quyết và tuyệt kỹ cũng cần được điều chỉnh đồng thời dựa trên hoạt ảnh, phán định trúng đòn, hiệu ứng và âm thanh.
Xử lý các vấn đề thường gặp
Trong game 3D trên web có nhiều vấn đề không biểu hiện trực tiếp dưới dạng lỗi mã, vì vậy kho mã cung cấp một danh sách lỗi chuyên biệt. Khi gặp các hiện tượng dưới đây, bạn có thể ưu tiên tham khảo references/pitfalls.md:
- Phím điều hướng hoặc trạng thái nhập liệu bị kẹt.
- Hoạt ảnh dựng sẵn khiến nhân vật bị hất khỏi vị trí ban đầu.
- Hiệu ứng phát sáng quá mạnh, khiến hình ảnh bị cháy sáng.
- Camera bị mái công trình che khuất.
- Kích thước nhân vật sau khi đóng gói không nhất quán với môi trường phát triển.
Những vấn đề này thường cần được kiểm tra lần lượt dựa trên xử lý đầu vào, xương gốc của hoạt ảnh, va chạm camera, tham số hậu kỳ và tỷ lệ tài nguyên. Không nên chỉ dựa vào việc “không có lỗi” để kết luận chức năng đã hoàn tất.
Chọn hình thức phát hành
Website tĩnh trực tuyến
Phiên bản trực tuyến có thể kết xuất bối cảnh trước, sau đó tiếp tục tải tài nguyên trong quá trình chạy. Hình thức này phù hợp để triển khai trên dịch vụ lưu trữ tĩnh, đồng thời có thể bổ sung cần điều khiển cảm ứng trên điện thoại, thiết lập chất lượng hình ảnh, chuyển đổi chất liệu độ phân giải cao và cấu hình phím.
HTML tệp đơn
Phiên bản tệp đơn sẽ đóng gói mô hình, texture, nhạc và lồng tiếng vào cùng một tệp HTML. Tài nguyên gốc của dự án demo gần 100MB, sau khi đóng gói còn khoảng 33MB. Cách này thuận tiện cho việc chia sẻ và chạy ngoại tuyến, nhưng cần đặc biệt chú ý đến việc nén tài nguyên và dung lượng tệp cuối cùng.
Gói ngoại tuyến cho container bị hạn chế
Nếu nền tảng mục tiêu không thể kết nối mạng, không thể sử dụng WASM và giới hạn gói là 10MiB, cần xây dựng riêng một phiên bản tương thích. Dự án demo đã được làm thành gói ngoại tuyến khoảng 8MiB dành cho các giới hạn kiểu công cụ nhỏ của Xiaohongshu.
Các hình thức phát hành khác nhau không chỉ đơn giản là sao chép cùng một cấu hình. Nên xác định nền tảng mục tiêu từ giai đoạn đầu của dự án để có thể đưa ra lựa chọn phù hợp về định dạng tài nguyên, cách tải và phạm vi chức năng.
Tham khảo tài liệu trong kho mã
Sau khi cài đặt xong, bạn có thể yêu cầu AI trực tiếp đọc các tệp sau và tham khảo chúng ở giai đoạn tương ứng:
SKILL.md: quy trình tổng thể và các điểm kiểm tra ở từng giai đoạn.references/assets.md: tạo tài nguyên và nguồn tài nguyên miễn phí.references/characters-animation.md: nhân vật, khung xương và hoạt ảnh.references/combat-feel.md: thiết kế cảm giác chiến đấu.references/vfx-ui-audio.md: hiệu ứng, giao diện và âm thanh.references/pitfalls.md: các vấn đề thường gặp và cách khắc phục.references/packaging.md: tối ưu dung lượng, đóng gói, lưu trữ và khả năng tương thích với môi trường chứa bị hạn chế.scripts/: xử lý đầu vào, máy chủ cục bộ và ba tập lệnh đóng gói.
Cần lưu ý gì khi sử dụng?
Skill này không thể thay thế việc chơi thử thủ công và không đảm bảo tạo ra thành phẩm chất lượng cao ngay từ lần đầu. Quá trình制作 《雾锁山门》 đã trải qua nhiều vòng chơi thử; mỗi vòng phát hiện một số vấn đề, sau đó AI tiếp tục chỉnh sửa. Vì vậy, bạn cần liên tục quan sát trò chơi và đưa ra phản hồi.
Các cách cộng tác hiệu quả hơn bao gồm: cung cấp video tham khảo; yêu cầu AI nghiên cứu trước khi bắt tay thực hiện; để AI ưu tiên tích hợp các công cụ tài nguyên có sẵn; chạy thử và chụp ảnh xác minh sau khi hoàn thành từng giai đoạn; tiến hành kiểm tra dung lượng sớm ngay khi xác định nền tảng.
Hiện tại, Skill đã được sử dụng trọn một lần trong một dự án hoàn chỉnh và đã trải qua một lần kiểm tra đối chiếu ở cấp độ kế hoạch. Skill phù hợp hơn với việc giúp bạn giảm các sai lầm về định hướng và những lần thử sai lặp lại, thay vì cam kết rằng mọi chủ đề đều có thể tự động đạt được cùng một mức độ hoàn thiện.
Tóm tắt
歸藏 Game Skill chia quy trình制作 game hành động 3D trên trình duyệt thành các bước có thể thực hiện: trước tiên làm rõ yêu cầu, sau đó chuẩn bị tài nguyên và hoạt ảnh, tiếp theo tinh chỉnh cảm giác chiến đấu, hiệu ứng và âm thanh, cuối cùng hoàn tất việc đóng gói theo giới hạn của nền tảng. Sau khi cài đặt, bạn có thể bắt đầu từ một yêu cầu game cụ thể và để AI liên tục lặp lại giữa việc lập kế hoạch, triển khai và xác minh.
Nếu muốn tìm hiểu thêm về các chi tiết đầy đủ, bạn có thể xem kho lưu trữ GitHub và chơi thử 《雾锁山门》. Bản thân Skill sử dụng AGPL-3.0; mỹ thuật, mô hình, lồng tiếng, nhạc nền và nội dung văn bản trong game demo thuộc về tác giả, vì vậy khi sử dụng, vui lòng tuân thủ giấy phép tương ứng của từng loại.