AnswersPublished15 sources
בדיקות, מסמכים וקובצי טיוטה: כך מנהלים את התוצרים של V4
בדיקות חוזרות וחיוניות הן נכס איכות, לא לכלוך שיש להסיר רק מפני שהן יוצרות עומס בתיקייה. חומרי אימות חד־פעמיים, פלטים וטיוטות צריכים להיות מופרדים מקוד המקור ומנכסים שמופצים למשתמשים.
פורסם על ידיהתמונות נוצרו באמצעות GPT Image 2
Research answer
Key takeaways
- בדיקות חוזרות וחיוניות הן נכס איכות, לא לכלוך שיש להסיר רק מפני שהן יוצרות עומס בתיקייה.
- חומרי אימות חד־פעמיים, פלטים וטיוטות צריכים להיות מופרדים מקוד המקור ומנכסים שמופצים למשתמשים.
- תיעוד צריך להיות מאורגן לפי תפקיד; מספר קטן יותר של קבצים אינו בהכרח ניהול טוב יותר.
- מחקר על הקשר ארוך מצביע על אתגרי שימוש במידע, אך אינו קובע סף אורך שממנו מסמך גורם להזיות.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/oBMfTzLzQzYo7VcXQdEGj2yQgAw1/images/73E9D63489E02AC46209/BEDABC175BE8FCADFC63.png)
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"两个痛点都适合纳入 V4 的“产物生命周期背压”，但不应简化成“测试全部不提交”或“文档全部合并”。建议保留长期质量资产，隔离一次性验证材料，并分别控制仓库维护、安装分发和模型上下文。\n\n本次交付为阶段性调研：仓库静态证据、Geoffrey Huntley 的作者资料及部分学术资料已取得；Python 官方布. Topic tags: general web, openai, llm, agents, ai. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
השורה התחתונה: לנהל את מחזור החיים, לא למחוק את העקבות
שני הקשיים — עומס של בדיקות ותיעוד שמתנפח — מתאימים לטיפול במסגרת כלל אחד של ניהול תוצרים לאורך חייהם. אבל אין להסיק מכך שצריך להפסיק להעלות בדיקות או לאחד את כל המסמכים לקובץ יחיד. עדיף לשמר נכסי איכות לטווח ארוך, לבודד חומרי אימות חד־פעמיים, ולהחליט בנפרד מה נשאר במאגר, מה נכלל בהפצה ומה נטען להקשר של מודל.
חשוב לסייג: זו סקירה חלקית. נאספו ראיות סטטיות מתוך המאגר, חומרי מחבר של Geoffrey Huntley וחלק ממקורות אקדמיים; הבדיקה של המלצות רשמיות על מבנה פרויקטי Python והצלבה מול X, Reddit, Hacker News ו-Lobsters לא הושלמה. לא הורצו בדיקות, ולא אומת אם קבצים בתיקיות מסוימות כבר נמצאים במעקב Git.
בדיקות: להפריד אימות זמני, לא לוותר על בקרת איכות
מה מראים הממצאים על V4
- הגדרת ה-CI ב-
.github/workflows/ci.yml:55משתמשת בתיקיית בדיקות מרכזית,tests/, ובה בדיקות לחוזי תצורה, להפצה ולהגנה על נכסים. לכן אין בסיס לסווג את הבדיקות הללו כחומר זמני רק משום שהתיקייה נראית עמוסה. הבדיקות לא הורצו בסקירה, ולא נבדק בנפרד הערך התחזוקתי של כל אחת. - כללי
.gitignore:1מתעלמים מכמה סוגים של ארגזי חול, מטמון וקבצים זמניים, אך לא מציינים במפורש טיוטות משימות. בפרט, הכללים הנוכחיים אינם מונים את_bmad-output/scratch/ואת_bmad-output/verification/. עצם קיומה של תיקייה אינו מוכיח שתוכנה מנוהל ב-Git, ומצב האינדקס לא נבדק. - נקודת הכניסה לעדכון ב-
bs.sh:298מעדכנת את המאגר, ואילו איסוף המקורות לפריסה ב-scripts/deployment_source.py:64קורא חבילה שנבחרה. אלה גבולות שונים: העובדה שמפתחים רואים בדיקות בעותק המאגר אינה אומרת שהן נכללות בסביבת ההרצה של המשתמשים. - לפי
scripts/deployment_source.py:47, איסוף המקורות סורק קבצים רגילים בתוך החבילה וממפה אותם לקלט לפריסה (scripts/deployment_source.py:81). מכאן עולה סיכון אפשרי: אם חומר זמני יישמר בטעות בתוך החבילה, הוא עלול להיכלל בהפצה. אין ראיה שזה כבר קרה.
חלוקה שימושית של סוגי נכסים
| סוג | המלצה לגבי גרסאות | מיקום והפצה |
|---|---|---|
| בדיקות רגרסיה, חוזים ובדיקות אינטגרציה נחוצות לטווח ארוך | לשמור ולתחזק לצד המימוש | לעבוד לפי מוסכמות השפה והפרויקט; בדרך כלל לא לכלול בחבילת ההרצה |
| אבחון חד־פעמי, סקריפטים לאימות וקלטים ניסיוניים | להשאיר מקומית כברירת מחדל, בלי להעלות אוטומטית | לשמור באזור זמני מאושר, מחוץ לנכסי החבילה |
| יומנים, דוחות כיסוי ותוצאות הרצה | לא לכלול אוטומטית בקוד המקור; לשמור ראיות רק כשיש להן צורך ברור | להפריד מקוד הבדיקות ולא לכלול בחבילה |
זו הצעה למדיניות, לא תיאור של כללים שכבר הוטמעו.
גם למוסכמות שפה יש חשיבות. במדריך הרשמי של Go, קובץ בדיקה נמצא לצד החבילה הנבדקת; לכן אין הצדקה להפוך העברה של כל בדיקות Go לתיקייה מרכזית חיצונית לכלל מחייב.15 בפרויקט הזה כבר קיימת פריסת בדיקות מרכזית ב-Python, ולכן הגיוני להתחיל ממנה. הראיות שנאספו כאן אינן מספיקות כדי לקבוע מהו המבנה המומלץ לכל פרויקט Python.
הבחירה תלויה במטרה: אם רוצים שתוכן שמקבלים משתמשים יהיה נקי, צריך להתמקד בחבילת ההפצה או ברשימת הנכסים שמותקנים. אם רוצים שעץ קוד המקור יהיה מסודר יותר, צריך להתאים את מיקום הבדיקות למוסכמות הפרויקט והשפה. העברת קבצים לבדה אינה פותרת את שתי הבעיות.
תיעוד: לצמצם כפילויות, לא בהכרח את מספר הקבצים
נתיב ניתוב התוצרים הקיים ב-bmad-suite-v4/rules/bmad-core.md:129 מפריד בין ניתוח, ADR — מסמך החלטה ארכיטקטונית — תוכנית וחוזה, ומנחה לשאול כשלא ברור לאן התוצר שייך. עם זאת, כללי הטיוטות ב-bmad-suite-v4/rules/bmad-core.md:117 מציגים מוסכמת מיקום נוספת. הנתונים הסטטיים תומכים במסקנה שהכיסוי של מחזור חיי התוצרים אינו שלם; הם אינם מוכיחים מדוע נוצרה כל תיקייה לא מתוכננת.
במקום להוסיף עוד שכבות של תיקיות, אפשר להבהיר את תפקידן של הקיימות:
- ניתוח מסודר: לשמור ראיות, השוואות, טיעוני נגד ושאלות שנותרו פתוחות. התייעצות רגילה יכולה להסתיים בתשובה בשיחה; אין צורך ליצור דוח קבוע ללא צורך בשימור.
- ADR: לתעד החלטה חשובה, את הנימוקים ואת המגבלות שלה — לא לשכפל את כל הניתוח ולא להפוך את המסמך ליומן ביצוע.
- תוכנית מימוש: לתעד הרשאה, היקף, תלות ותנאי קבלה; להפנות להחלטות הרלוונטיות במקום להעתיק את המחקר.
- חומר זמני: לרכז טיוטות, קלטי אבחון ופלטים גולמיים באזור זמני מאושר. כותרת שכוללת את המילה „טיוטה” אינה סיבה להכניס מסמך לאזור הניתוח הרשמי.
- תיעוד תפעולי ארוך טווח: לשמור כשהוא משמש מדריך שניתן לעשות בו שימוש חוזר. תהליך פריסה חד־פעמי אינו מחייב ליצור תיקיית פריסה חדשה.
צריך להחליט בנפרד כמה מסמכים נדרשים, אם הם מנוהלים בגרסאות, אם הם מופצים ואם המודל קורא אותם. ריכוז כל החומר בתיקייה אחת אינו תחליף למדיניות.
מה אפשר ללמוד מ-Geoffrey Huntley — ומה לא
במאמרו על back pressure, Huntley מדגיש יצירת מנגנוני משוב אוטומטיים סביב סוכן, כדי לסייע לו לזהות טעויות ולשמור על איכות לאורך משימות ארוכות. הדגש אינו על הסרת קובצי בדיקה.12
במאמר על העברת תוכנה בין שפות, הוא מציע לתעד את התנהגות הבדיקות כמפרט, ואז להשתמש במפרט בתהליך ההעברה.14 זו המלצה לתרחיש מסוים; אין בה הוכחה שצריך להחליף בדיקות במסמכים בכל פרויקט.
היישום הסביר ל-V4 הוא לשמר משוב מעשי על נכונות, ובמקביל להפחית נכסי אימות כפולים או חד־פעמיים. מפרט מתאר את ההתנהגות המצופה; בדיקה מספקת דרך מעשית לחשוף סטייה. אין להחליף אחד באחר בלי לבחון את הצורך.
אין די ראיות לקבוע של-Huntley יש מדיניות אחידה לגבי העלאת בדיקות, תיקיות טיוטה או החרגת קבצים מהפצה. גם לא ניתן לקבוע שהפורומים שנזכרו מסכימים על כך: הראיות אינן מספיקות. אין לייחס לו או לדיונים שלא נבדקו טענות נוספות.
עומס מסמכים והזיות: לנהל את הקריאה, לא רק את מספר הקבצים
מחקרים על הקשרים ארוכים דנים בקושי של מודלים להשתמש באופן שווה במידע שמופיע במיקומים שונים בתוך הקלט. מחקר HELMET מדגיש גם את הצורך להעריך יכולות של הקשר ארוך במגוון משימות, ולא להסתמך רק על מדדי שליפה פשוטים.3
4 הממצאים האלה אינם מוכיחים שקובץ מעל אורך מסוים גורם להזיות, ואינם מאפשרים לכמת את הסיכון הספציפי ב-V4.
כמה כללים מעשיים יכולים לצמצם עומס מיותר:
- לחלק מסמכים לפי נושא ולפי גבולות החלטה, במקום להמשיך לנפח קובץ מרכזי יחיד.
- כברירת מחדל, לקרוא את החלקים שרלוונטיים למשימה הנוכחית, ולחפש בחומר היסטורי רק כשצריך.
- לשמור בתקציר קצר את מיקום הראיות, את הלא־ידוע ואת ההתחייבויות שטרם הושלמו; להשאיר את המקורות הגולמיים לצורך מעקב.
- להשתמש באינדקס לניווט, לא ליצירת עותק נוסף של כל התוכן.
- לא להזין מחדש למודל את כל היומנים והדוחות ההיסטוריים כברירת מחדל.
הצעה לשינוי מינימלי ב-V4
במקום להוסיף תהליך כבד, כדאי להוסיף כלל אחד שמלווה תוצרים משלב היצירה ועד למסירה:
- לפני יצירה: להגדיר מה מטרת הנכס; להעדיף הרחבה של בדיקה או מסמך קיימים על פני יצירה אוטומטית של קובץ חדש בכל שינוי.
- לפני שמירה: לקבוע נתיב מאושר, אם הנכס זמני או מתמשך, אם הוא מנוהל בגרסאות ואם הוא מיועד להפצה. אם לא ברור — לא להמציא תיקייה חדשה על דעת עצמנו.
- לפני העלאה: לבדוק פלטים זמניים, מידע רגיש, בדיקות כפולות ותיעוד כפול. אין להשיג סדר באמצעות התעלמות מכל הבדיקות.
- לפני הפצה: להגדיר במפורש אילו נכסים מותקנים ולוודא שחומר זמני אינו נכנס לחבילה. אין להסיר לשם פישוט הגנות קיימות על סיכומי נכסים, זהויות ותכולת הפצה.
- לפני ניקוי: להגן על ראיות לכישלונות, משימות פעילות והפניות היסטוריות. הצלחת משימה או גיל של חומר אינם כשלעצמם הרשאה למחוק אותו.
לאחר בחינה ביקורתית, סדר העדיפויות המומלץ הוא: תחילה להבהיר את גבולות החומר הזמני וההפצה; אחר כך לאחד את תפקידי התיעוד ולעבור לקריאה לפי הצורך. אין כרגע תמיכה בהעברה גורפת של בדיקות Go, בהפסקת העלאת בדיקות ארוכות טווח או באיחוד כל המסמכים לקובץ אחד. אם יאושר שינוי בעתיד, תנאי הקבלה צריכים לכלול איסוף תקין של הבדיקות, תאימות ל-CI הרלוונטי, היעדר חומר זמני מתכולת ההתקנה ושימור של הפניות היסטוריות והתחייבויות פתוחות.
הסקירה הזו נמסרת כתשובה בלבד: לא נכתבו קבצים, לא הורצו פקודות או בדיקות, לא בוצע ניקוי ולא שוחזרה או קודמה תוכנית הנדסית קיימת.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "בדיקות, מסמכים וקובצי טיוטה: כך מנהלים את התוצרים של V4"?
בדיקות חוזרות וחיוניות הן נכס איכות, לא לכלוך שיש להסיר רק מפני שהן יוצרות עומס בתיקייה.
What are the key points to validate first?
בדיקות חוזרות וחיוניות הן נכס איכות, לא לכלוך שיש להסיר רק מפני שהן יוצרות עומס בתיקייה. חומרי אימות חד־פעמיים, פלטים וטיוטות צריכים להיות מופרדים מקוד המקור ומנכסים שמופצים למשתמשים.
What should I do next in practice?
תיעוד צריך להיות מאורגן לפי תפקיד; מספר קטן יותר של קבצים אינו בהכרח ניהול טוב יותר.
Sources
go.devAdd a test
ghuntley.comdon't waste your back pressure
doi.orgFound in the Middle: How Language Models Use Long Contexts Better via Plug-and-Play Positional Encoding