סקירת zcode-smart-skill: פרוטוקול של מנהל שנכתב בקובץ Markdown אחד
ה-skill מתאם הקשרים טריים דרך ledger, בדיקות עצמאיות, checkpoints ואימות בהרצה. כוחו במשמעת; Markdown אינו אוכף את הכללים.
סקירה עמוקה · קוד מקור
ארבעה קבצים וללא runtime. זה כל המאגר, וזו הנקודה. הרכיב המרכזי הוא קובץ `SKILL.md` גדול אחד שהופך סוכן קוד מוכשר למנהל של הקשרי עבודה חדשים. המצב עובר דרך יומן `.smart/
מה מצליח כאן
- הפרויקט מטפל בשיחה ארוכה שצוברת הנחות ומלטשת גישה כושלת. עובדים טריים קוראים brief ו-ledger מוגבלים. מנהל מתכנן, עובד עצמאי כותב adversarial tests, אחר מממש משימה, והמנהל מריץ. done דורש artifact ואימות ירוק.
- Source repository
איך זה בנוי
הסוכן הראשי מתכנן ומאמת. subagents עוסקים ברעיונות, בדיקות או משימה אחת. מערכת הקבצים היא האוטובוס. `task.md` שומר מטרה, `plan.md` אסטרטגיה, `tasks.json` מגביל, `notes.md` לקחים, `tests_spec.md` קודם לקוד ו-`verify.log` הרצות. משימות קשות יכולות להתחרות ב-worktrees מבודדים.
עשר הרחבות, לולאה אחת
V2 מוסיף כתיבת בדיקות יריבה, reflection, מרוץ מקבילי, scrutiny, תקציבי קושי, מודלים לפי תפקיד, backtracking, self-attack, workflow memory ו-handoff קשיח. כל תוספת משנה קובץ או החלטה.
מה סקירת קוד יכולה ולא יכולה לאמת כאן
כמעט אין קוד בר-הרצה. אפשר לבדוק פרוטוקול ורישיון. אי אפשר לאמת שיפור benchmark של skill זה: אין harness, corpus, תוצאות או CI. המחקרים מנמקים רכיבים, לא את השילוב.
{"id":"implement-1","difficulty":"hard","status":"in_progress","done_when":"artifact exists and tests pass"}קטע יומן הסברי מקורי, לא קובץ פרויקט מילולי.
אבטחה ואמון
ה-brief אומר שה-ledger הוא מידע ולא סמכות. checkpoints אינם destructive והגבולות מפורשים. אבל משימת המשתמש מועתקת מילה במילה וההגנה תלויה בציות הסוכן. נדרשים sandbox, הרשאות, בידוד ובדיקת נתיבים מחוץ לפרומפט.
עיצוב כחוויית מפתח
דיאגרמת ASCII מסבירה מנהל, עובדים ו-ledger. README מציג את הלולאה לפני התקנה ונותן שני מסלולי העתקה. audit trail מאפשר לקרוא כישלונות והרצות. שינוי העלות מוכרז.
איפה הוא חלש
נדרש host עם subagents, קבצים, פקודות ולעיתים בחירת מודלים. התאמה בין מערכות הרשאה אינה טריוויאלית. Markdown אינו מבטיח תקציב, בידוד, safe paths, merge סדרתי או בדיקות. pruning עלול למחוק ראיות, racing מכפיל עלות ו-auto-trigger רחב.
איך לבדוק אותו ביושר
בנו suite פומבית עם תקציב קבוע. השוו long-context, ledger בסיסי ו-ablation לכל תוספת. פרסמו הצלחה, זמן, tokens, false done, conflicts ותגובה ל-prompt injection שתולה עם כל ה-ledgers.
פסק דין
זהו מדריך הפעלה חזק, לא framework. הרעיונות הטובים: כותב בדיקות עצמאי, הרצה כאמת, handoff מוגבל ועזיבת גישה כושלת. החולשה היא enforcement בפרוזה. השתמשו עם sandbox חזק ודרשו תוצאות חוזרות.
הדגמה וקרדיט
אין live demo נפרד. הארטיפקט הוא המאגר ו-`SKILL.md`.
יתרונות
- כותב בדיקות עצמאי לפני המימוש
- Bounded ledger makes handoffs auditable
- חזרה אחורה מפורשת ואימות בהרצה
פשרות
- Markdown cannot enforce its own guards
- No benchmark harness or reproduced results
- Parallel races can sharply increase cost
מתאים ל: מארחי סוכנים שכבר מספקים בידוד, הקשרי עבודה חדשים והרצת פקודות אמינה.
שאלות נפוצות
מהו zcode-smart-skill?
זהו פרוטוקול Markdown בן ארבעה קבצים שמתאם הקשרים טריים של סוכני קוד דרך ledger.
האם זו framework ניתנת להרצה?
לא. יש הוראות, אך אין runtime, harness, בדיקות או CI.
מה היתרון העיקרי?
בדיקות עצמאיות, handoff מוגבל, checkpoints ואימות בהרצה משפרים ביקורת.
Reviewed source at commit b847694 · No separate live demo listed