Human Review: עורכים את הדף כמו מסמך והסוכן מתקן

למה כל כך מתסכל לתקן דף דרך הצ'אט?

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

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

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

הסקיל Human Review בגיטהאב פותר את זה בדרך שכולם מכירים מגוגל דוקס: עורכים ישר על הדף, משאירים הערות במקום הנכון, ושולחים הכל בבת אחת. הוא פתוח ברישיון MIT, רץ כולו אצלכם במחשב, ולא צריך חשבון, שירות ענן או מפתח API.

איך מתקינים את הסקיל בקלוד קוד או בקודקס?

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

העתקהInstall the /human-review skill globally from https://github.com/petergyang/human-review

או מהטרמינל, עם Node.js מותקן:

העתקהnpx -y human-review setup --global

אחרי ההתקנה פותחים את קלוד קוד מחדש, והפקודה /human-review זמינה בכל פרויקט. וגם לא צריך להיות טכנולוגי בשביל זה, כי מרגע שהדף נפתח, זה בדיוק כמו לערוך מסמך.

איך פותחים דף לעריכה ושולחים תיקונים?

כותבים את הפקודה עם הקובץ שרוצים לבדוק:

העתקה/human-review index.html

או עם כתובת של אתר שרץ אצלכם במחשב, למשל בזמן שקלוד קוד בונה אפליקציה:

העתקה/human-review http://localhost:3000

הדף נפתח בדפדפן. עכשיו עושים את מה שהייתם רוצים לעשות מההתחלה:

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

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

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

על מה הכי שווה להפעיל את /human-review?

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

• דפי נחיתה ואתרים: סדר הסקשנים, קיצור טקסטים, החלפת תמונה. התיקון האחרון לפני שמעלים לאוויר.
• תוכניות ומסמכים: קלוד כתב תוכנית עבודה או אפיון בקובץ Markdown? מוחקים את מה שמיותר, מעירים על מה שלא ברור, ושולחים.
• אפליקציה בפיתוח: פותחים את localhost ומסמנים על המסך עצמו מה צריך לזוז. אפשר לעבור בין כמה דפים בלחיצה עם Cmd על קישור, בלי לאבד את ההערות.
• הצעות מחיר ומסמכים ללקוח: מסמך HTML שקלוד הכין נפתח לעריכה כמו כל דף, ואפשר לתקן בו מחירים, ניסוחים וסדר לפני ששולחים ללקוח.
• טקסט מיותר: ה-AI אוהב להוסיף משפטים ריקים לממשק. מוחקים אותם ישר במקום להסביר אילו.

איך כותבים הערה שהסוכן מבין מהפעם הראשונה?

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

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

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

איך זה משתלב בבנייה של דף עם קלוד קוד?

הסקיל לא מחליף את הבנייה, הוא נכנס בסוף שלה. תהליך שעובד טוב לדף נחיתה:

1. מבקשים מקלוד קוד לבנות את הדף, עם בריף ברור: למי הדף, מה ההצעה ומה הפעולה שרוצים מהגולש.
2. מסתכלים על התוצאה הראשונה בלי לתקן כלום, ורק מחליטים אם הכיוון נכון. אם המבנה כולו לא נכון, עדיף לבקש גרסה חדשה בצ'אט.
3. אם הכיוון נכון, מריצים /human-review ועושים את כל התיקונים הקטנים והבינוניים על הדף עצמו.
4. שולחים, עוברים על הדף המעודכן, ומסיימים בבדיקה בטלפון.

רוצים לראות ולאשר את העיצוב עוד לפני שנכתב קוד? בשביל זה יש את מדריך העיצוב כתמונה עם Screenshot to Code, ואז /human-review נשאר לתיקונים האחרונים.

מה חשוב לדעת לפני שמתחילים?

• קבצי HTML נשמרים מיד: בעריכה של קובץ HTML, שינויים ישירים נשמרים אוטומטית, גם אם סגרתם את הלשונית. כדי לבטל משתמשים ב-Revert all בזמן הבדיקה, או ב-Discard בפתיחה הבאה. בקבצי Markdown ובדפי localhost השינויים עוברים רק אחרי שלח.
• אתר חי באינטרנט: הסקיל עובד על קבצים במחשב ועל localhost. אתר שכבר באוויר פותחים קודם אצלכם בפרויקט.
• עלות: הסקיל חינמי. התיקונים עצמם צורכים טוקנים מהמנוי או מהחשבון של הסוכן, כמו כל בקשה אחרת.
• עברית: עריכת טקסט בעברית עובדת כמו בכל דפדפן. אם הדף בנוי נכון מימין לשמאל, גם הגרירה והסידור מתנהגים כצפוי.
• הערה שלא נשלחה נשמרת, ובפתיחה הבאה של אותו דף אפשר לשחזר אותה או למחוק.