Claude of Tanks: משחק תלת מימד שלם שנבנה עם סוכני AI

מה זה Claude of Tanks?

Claude of Tanks הוא משחק קרבות טנקים בסגנון World of Tanks, שבנוי ישירות ב-Three.js ורץ בדפדפן. אין מה להוריד ואין התקנה. נכנסים לאתר ומשחקים, במחשב או בטלפון עם שליטת מגע.

מה שמעניין כאן הוא לא רק המשחק. זה מי בנה אותו ואיך. לפי ה-README, קווין ב. ליו יצר, עיצב וניהל את הפרויקט, וקלוד וקודקס עזרו במחקר, בבניית הטנקים, בסימולציה, ברשת, בעיצוב, בביצועים, בבדיקות, בתיעוד ובהעלאה לאוויר. זה בדיוק התפקיד שהרבה בעלי עסקים לא מאמינים שהם יכולים למלא: לא לכתוב את הקוד, אלא לנהל את מי שכותב אותו.

איך משחקים ב-Claude of Tanks?

1. נכנסים לאתר cot.kevinliu.studio מהמחשב או מהטלפון.
2. בוחרים טנק במוסך ומצב משחק: קרב רגיל, תפוס את הדגל, שליטה באזור, קמפיין של שש משימות ועוד.
3. משחקים לבד מול בוטים, או פותחים חדר פרטי ושולחים לחברים קישור.

במחשב נוהגים עם WASD, מכוונים עם העכבר ויורים בלחיצה שמאלית. בטלפון מקבלים כפתורי מגע ייעודיים לתנועה, כיוון, כוונת וירי, ולא מסך מחשב מוקטן.

ומה עם שרת? לפי ה-README, משחק בחדר פרטי רץ בדפדפן של מי שפתח את החדר, בחיבור ישיר בין השחקנים. אין מסד נתונים ואין שרת משחק ייעודי. רק כדי שחדרים באינטרנט ימצאו אחד את השני יש שירות קטן לתיאום, ובחלק מהרשתות המוגבלות צריך גם שרת ממסר.

איך מפתח אחד בנה משחק כזה עם סוכני AI?

התשובה הקצרה: הוא לא ביקש "תבנה לי משחק טנקים". הוא בנה מערכת עבודה. כל טנק, מפה ומערכת במשחק עוברים תהליך קבוע, עם הוראות כתובות לסוכן, מדידות, ושערי בדיקה שהסוכן צריך לעבור לפני שמשהו נכנס למשחק.

שלושה דברים שבולטים כשקוראים את הריפו:

• מקור אמת אחד. הקרב, המוסך, הגלריה, הבוטים והאייקונים קוראים כולם את אותו מפרט של כל טנק. סוכן שמשנה טנק לא צריך לזכור לעדכן חמישה מקומות.
• בדיקות שרצות לבד. סימולציה, רשת, מפות, התנגשויות, שליטת מגע ובנייה, לכולם יש בדיקות שהסוכן מריץ. ככה יודעים שמשהו עובד בלי לשחק בעצמכם אחרי כל שינוי.
• הוראות שכתובות פעם אחת. בתיקייה docs/tank-generation יש מדריך עבודה לבניית טנק, עם תבניות למסירה בין סוכנים וקובץ של הוראות מוכנות להעתקה.

השיטה: הוראות לסוכנים ושערי בדיקה

המדריך לבניית טנקים בריפו מתחיל בצעדים קבועים: לקרוא את קבצי ההוראות, לפתוח סביבת עבודה נפרדת, למלא "חבילת ריצה" שמגדירה בדיוק מה בונים, לבנות, להשוות למקור, לתקן ולמדוד שוב, ולסיים עם תצוגה מקדימה ומסמך מסירה. יש בו גם טבלה שמתרגמת בקשות נפוצות, כמו "תעשה את כל המשפחה" או "תמשיך", לפעולה המדויקת שהסוכן צריך לעשות.

את זה אפשר להעתיק לכל פרויקט, גם אם הוא לא משחק:

• קובץ הוראות אחד לכל סוג משימה שחוזרת על עצמה
• הגדרה כתובה של "גמור" לפני שהסוכן מתחיל
• בדיקה אוטומטית שהסוכן חייב לעבור, לא "נראה לי שעובד"
• מסמך מסירה בסוף, כדי שהסוכן הבא ימשיך בלי לנחש

אם זה מזכיר לכם צוות סוכנים, זה כי זה אותו רעיון. במדריך על צוותי סוכנים בקלוד קוד יש את הצד הטכני של להריץ כמה סוכנים במקביל.

איך בונים משחק משלכם באותה שיטה?

לא צריך להתחיל מ-220 טנקים. מתחילים ממשחק קטן בדפדפן, ומעתיקים את מבנה העבודה. פותחים תיקייה ריקה בקלוד קוד ומדביקים:

אני רוצה לבנות משחק קטן בתלת מימד שרץ בדפדפן, עם Three.js ו-Vite.
הרעיון: [למשל: מירוץ סירות קטנות באגם, שחקן אחד מול 3 בוטים].
לפני שאתה כותב קוד:
1. תכתוב קובץ PLAN.md עם המערכות במשחק (תנועה, מצלמה, בוטים, ניקוד, שליטת מגע) ומה נחשב "גמור" לכל אחת.
2. תכתוב קובץ AGENTS.md עם הוראות קבועות לסוכן שבונה כל מערכת, כולל איך בודקים אותה.
3. תגדיר מקור אמת אחד לנתונים של המשחק, כדי שכל המערכות יקראו מאותו קובץ.
אחרי שאישרתי את התוכנית, תבנה מערכת אחת בכל פעם, תריץ בדיקה אחרי כל אחת, ותעצור להראות לי.
בסוף כל שלב תכתוב סיכום קצר ב-HANDOFF.md, כדי שאפשר יהיה להמשיך בשיחה חדשה.

שימו לב לשלוש התוספות שהופכות את זה משיחה לשיטה: תוכנית עם הגדרת "גמור", קובץ הוראות קבוע, ומסמך מסירה. אלה בדיוק הדברים שמופיעים בריפו של Claude of Tanks בגדול.

רוצים לראות איך זה נראה כשהסוכן מתכנן לפני שהוא כותב? במדריך על מצב תכנון בקלוד קוד יש את זה צעד אחרי צעד.

איך מריצים את הקוד של Claude of Tanks אצלכם?

אם אתם רוצים ללמוד מהקוד עצמו, או לתת לקלוד קוד לחקור אותו, משכפלים ומריצים מקומית (צריך Node.js):

git clone https://github.com/Kevin-Liu-01/Claude-of-Tanks.git
cd Claude-of-Tanks
npm install
npx vite

אחרי שהקוד אצלכם, אפשר לפתוח את התיקייה בקלוד קוד ולשאול שאלות כמו "איך בנוי המפרט של טנק?" או "תסביר לי איך עובד החדר הפרטי". זו דרך טובה ללמוד ארכיטקטורה של פרויקט גדול בלי לקרוא אלפי שורות לבד.

חשוב לדעת

• לא "קלוד בנה לבד". אדם אחד תכנן, החליט ובדק. לפי ה-README, קלוד וקודקס הם כלי פיתוח, לא שותפים ולא בעלי זכויות.
• הקוד פתוח, לא הכל. הריפו ברישיון MIT, אבל המקור של הטנקים והמפות, הנתונים, הנכסים הגרפיים והמיתוג מוחרגים כתוכן שמור. לפני שמשתמשים בקובץ כלשהו, קוראים את LICENSE ואת LICENSE-POLICY.md.
• מספר הטנקים משתנה. בריפו מופיעים 220, 222 ו-236 בשורות שונות, כי הצי מתעדכן כל הזמן.
• אין עברית. המשחק והתיעוד באנגלית ובסינית מפושטת.
• צריך מחשב שתומך ב-WebGL. בדפדפן ישן או בלי האצת גרפיקה המשחק לא ייטען.
• משחק גדול זה לא ערב אחד. הריפו מלא במסמכים עם תאריכים לאורך חודשים. השיטה מקצרת עבודה, היא לא מוחקת אותה.