מה לבקש
מדברים עם הסוכן במילים פשוטות: אומרים מה רוצים שיקרה, והוא בוחר את הכלים של Ploa בסדר הנכון. לעבודות הגדולות, שרת ה-MCP של Ploa נותן לו גם הנחיות: הוראות צעד אחר צעד שהוא פועל לפיהן, כך שהעבודה יוצאת אותו דבר בכל פעם.
כדי להתחיל
תעלה את האפליקציה הזו ל-App Store ול-Google Play עם Ploa.
הסוכן מריץ את ploa_setup_guide ושואל קודם איך לעבוד: לבד, או לשאול אותך לפני כל בדיקה, שחרור ושינוי מחיר (בחירה בהתחלה). אחר כך הוא מראה לך את לוח השלבים, מקשר את התיקייה ל-Ploa, ושולח לך הודעה ממוספרת אחת עם כל מה ששלך בשתי החנויות: השאלות שרק אתה עונה עליהן (המזהה של האפליקציה, השפות של דף החנות, מדינות, מחיר, למי היא מיועדת, אנשי הקשר) והצעדים שלך בקונסולות, כל אחד עם הקישור שלו. בזמן שאתה עושה אותם, הוא כותב את דף החנות, מכין את צילומי המסך ובודק את הבנייה.
ההנחיות
ב-MCP קוראים להן prompts. ב-Claude Code הן פקודות סלאש: מקלידים / ומחפשים את ploa (למשל /mcp__ploa__fill_store_page). בסוכנים אחרים הן בתפריט ה-prompts או הפקודות. אפשר גם פשוט לבקש את העבודה, והסוכן פועל לפי ההנחיה בעצמו. הארגומנטים לא חובה; כשאחד חסר, הסוכן שואל או בוחר את הבחירה הרגילה.
ההנחיות קוראות את הקוד של האפליקציה, ולכן הן מיועדות לסוכן עם השרת שבמחשב שלך. ברשת, ל-set_up_app, make_screenshots ו-answer_privacy חסרים הכלים שהן נשענות עליהם.
set_up_app
מאפליקציה בלי שום הגדרה בחנויות ועד הבניות הראשונות שלה ב-TestFlight ובבדיקה הפנימית של Google Play. הסוכן שואל איך לעבוד, מראה את לוח השלבים אחרי כל צעד, מציע מזהים לאפליקציה וקובע בפרויקט את זה שבחרת, עושה את הצעדים שלו (קישור התיקייה, רישום ה-bundle ID אצל Apple), ושולח את השאלות שלך ואת הצעדים שלך לשתי החנויות בהודעה אחת. בינתיים הוא כותב את פרטי החנות ואת תשובות הפרטיות כטיוטות, מכין את צילומי המסך, מארח מדיניות פרטיות ודף תמיכה באתר של האפליקציה ב-Ploa אם אין לה, ובודק את בניית ה-iOS ב-Mac בלי לשלוח אותה. כשחנות מוכנה, הוא מריץ בדיקה מקדימה ומתחיל את הבנייה הראשונה שלה. בלי ארגומנטים.
fill_store_page
דף החנות המלא לשתי החנויות מתוך הקוד של האפליקציה: קודם הוא שואל את מה שרק אתה מחליט (שפות, מדינות, מחיר, למי היא מיועדת, איש הקשר של App Review ואיש הקשר הציבורי של דף החנות, כל אחד בנפרד), קורא את האפליקציה, ואז כותב כל שדה טקסט בתוך המגבלות של כל חנות, את צילומי המסך ותשובות הפרטיות, הקטגוריה, דירוג הגיל, המחיר ופרטי הבדיקה, והכול נשמר כטיוטות שאתה שולח. ארגומנטים: language (שפה אחת, בקוד של אחת החנויות), store (apple, google או both, ברירת המחדל).
translate_store_page
דף החנות בעוד שפות: קוד השפה של כל חנות (עברית היא he אצל Apple ו-iw-IL אצל Google), טקסט שנכתב לשוק הזה ולא מילה במילה, מילות מפתח ל-App Store שנמצאות מחדש בכל שפה, והתרגומים של האפליקציה עצמה, כדי שהדף יתאים למסכים שלה. ארגומנטים: languages (מופרדות בפסיקים; כשחסר, הסוכן מציע כמה ושואל), from (השפה שממנה מתרגמים; כברירת מחדל השלמה ביותר), store.
make_screenshots
צילומי המסך שכל חנות דורשת, בגדלים המדויקים, מהאפליקציה כשהיא רצה בסימולטור או באמולטור: 4 עד 8 מסכים שמספרים את הסיפור של האפליקציה, שורת מצב נקייה, כל קובץ נבדק, ואז הם מועלים לפי הסדר אחרי שאתה מסכים (ישר לחנות, לא לטיוטה). סרטון תצוגה ל-App Store או סרטון קידום ל-Google Play רק אם תרצה. ארגומנטים: store, language.
answer_privacy
אילו נתונים האפליקציה אוספת ולמה, מתוך החבילות, ההרשאות והקוד שלה (פניות לרשת, אנליטיקס, התחברות, דוחות קריסה, פרסומות, תשלומים), נשמר פעם אחת ל-App Privacy של Apple ול-Data safety של Google Play. הוא שואל אותך את מה שהקוד לא מראה, ואז אומר מה להזין בכל קונסולה, ושם אתה מסמן שזה נעשה. ארגומנט: store.
handle_rejection
למה App Review או Google Play דחו את האפליקציה: ההודעה של החנות (שאתה מדביק, כי ה-API של החנויות לא נותן את המילים של הבודק), ההנחיה, הסיבה בקוד, בדף החנות או בפרטי הבדיקה, התיקון, בנייה חדשה אם הקוד השתנה, והגשה חדשה לאישור שלך. תשובה ל-App Review מנוסחת רק כשההודעה שלו מבקשת תשובה. ארגומנטים: store, message (ההודעה של החנות, מודבקת).
write_release_notes
הטקסט של "What's New" לגרסה הבאה, מתוך מה שהשתנה מאז השחרור האחרון (ה-pull requests שנכנסו מאז, כשהריפו מקושר ל-Ploa, אחרת ה-git log), בכל שפה שיש בדף החנות, נשמר בפרטי החנות: לגרסה שבהכנה ב-App Store, ולבנייה הבאה ש-Ploa מעלה ל-Google Play (או לבנייה שיצאה בלי הערות, כש-Ploa מקדמת אותה). טקסט אחד לשתי החנויות, או טקסט לכל חנות כשאחד היה מזכיר את הפלטפורמה השנייה (ב-App Store לא מזכירים את Android או Google, וב-Google Play לא את Apple, iPhone או Mac). ארגומנטים: since (תג או commit ב-git; כברירת מחדל הגרסה האחרונה ששוחררה), language, store.
כל הנחיה נגמרת באותה צורה: הסוכן שומר טיוטות ואתה שולח אותן, אלא אם הוא אוטונומי.
בקשות שעובדות טוב, שלב אחרי שלב
לפי הסדר שבו אפליקציה עוברת אותם. כל שלב מקשר לכלים שלו בכל כלי ה-MCP.
התחלה והגדרה
איפה אנחנו מול החנויות? תראה לי את לוח השלבים ומה עליי.
לאיזה חשבון Ploa יש לך גישה, ובאיזו רמה?
תרשום את ה-bundle ID אצל Apple ותקשר את התיקייה הזו ל-Ploa.
כלים: התחלה והגדרה.
צעדים שרק אתה יכול לעשות
מה מחכה לי בקונסולות של החנויות? תעביר אותי בזה צעד אחר צעד.
כלים: צעדים שרק אתה יכול לעשות.
פרטי החנות
תכתוב את דף החנות באנגלית מתוך הקוד, ואז תתרגם אותו לעברית ולספרדית.
מה כל חנות עדיין הייתה דוחה בדף החנות?
תקבע את דירוג הגיל ואת הקטגוריה, ותמלא את איש הקשר וההערות ל-App Review.
כלים: פרטי החנות.
פרטיות ותאימות לייצוא
תחשב את תשובות הפרטיות מתוך הקוד ותגיד לי מה להזין ב-App Store Connect וב-Play Console.
האפליקציה משתמשת בהצפנה ש-Apple צריכה שנצהיר עליה? תשאל אותי את מה שאי אפשר לדעת מהקוד.
כלים: פרטיות, תאימות לייצוא.
צילומי מסך וסרטונים
תצלם את צילומי המסך מהסימולטור ותראה לי אותם לפני ההעלאה.
תסדר את צילומי המסך בסדר הזה: בית, חיפוש, פרופיל.
כלים: צילומי מסך וסרטונים.
בניות
תריץ בדיקה מקדימה, תתקן את מה שהיא מוצאת ותשלח את גרסה 1.3 ל-TestFlight ולבדיקה פנימית.
תבנה את אפליקציית האנדרואיד ב-GitHub ממה שיש ב-main.
תעצור את הבנייה של אנדרואיד שרצה עכשיו: היא על הענף הלא נכון.
כלים: בניות.
בודקים
תוסיף את שלושת האנשים האלה כבודקים ב-TestFlight ותכתוב מה לבדוק בבנייה הזו.
מי בודק עכשיו את אפליקציית האנדרואיד, ובאיזה מסלול?
כלים: בודקים.
App Review ופרודקשן
תגיש את הבנייה ל-App Review ברגע שהיא מגיעה ל-TestFlight.
איפה הגרסה עומדת מול App Review, ומה הלאה?
תקדם את גרסת האנדרואיד לפרודקשן ב-20%, אבל קודם תבדוק את שיעורי הקריסות.
תשחרר את הגרסה שאושרה ב-App Store בשחרור הדרגתי.
כלים: App Review ופרודקשן.
דחיות
למה האפליקציה נדחתה? תתקן ותכין הגשה חדשה.
כלים: דחיות.
רכישות ומנויים
תוסיף מנוי שנתי עם שבועיים ניסיון חינם בשתי החנויות.
תיצור 100 קודי הצעה חד-פעמיים למנוי השנתי, בתוקף עד סוף השנה.
כלים: רכישות בתוך האפליקציה ומנויים.
ביקורות ומכירות
תראה לי ביקורות עם מעט כוכבים שעוד לא קיבלו תשובה, ותנסח תשובות מנומסות.
איך ההורדות החודש לעומת החודש שעבר?
כלים: ביקורות ומכירות.
שיווק ו-In-App Events
תכין דף מוצר מותאם לאנשים שמגיעים מהניוזלטר שלנו.
תגדיר In-App Event לאתגר הקיץ ותשלח אותו ל-App Review.
כלים: שיווק ו-In-App Events.
GitHub
תגדיר בניות ב-GitHub לריפו הזה, ותגיד לי מה עליי לעשות.
תבנה כל pull request שמסומן ב-ploa:android.
כלים: GitHub.
הווב
תעלה את גרסת האתר של האפליקציה ל-Ploa בכתובת ploa.app חינמית, ותשלח לי את קישור הבדיקה.
תעלה לאוויר את גרסת האתר שנבדקה.
כלים: הווב: אתר ואפליקציית ווב, השרת של האפליקציה.
מצב ודוחות
איפה האפליקציה עומדת בכל מקום?
למה השחרור האחרון נכשל? תראה לי כל צעד.
כלים: מצב ודוחות.
טיפים לתוצאות טובות
- אומרים את התוצאה, לא את הכלים. "תשלח לבודקים" מספיק; הסוכן יודע את הסדר.
- עונים על השאלות שלו. מחיר, מדינות, קהל ואנשי קשר הם שלך. הסוכן מחכה במקום לנחש.
- נעזרים בלוח השלבים. שואלים "איפה אנחנו?" בכל רגע, והוא מראה מה נעשה, מה הבא ומה עליך.
- אישור לוקח רגע. כשהסוכן מבקש, מאשרים מההתראה ואומרים לו להמשיך, או נותנים לו לבדוק לבד.
- "נשמר ב-Ploa" אומר שזה נעשה. כל עוד יש ל-Apple משהו אצל App Review, Ploa שומרת את השינוי ושולחת אותו ברגע ש-Apple מחליטה. אין מה לנסות שוב.
ploa_held_changesמציג מה נשמר, ושולח אותו עכשיו כשמבקשים.