סיכום הרצאות ופגישות טכניות בעברית
יוצר סיכום מובנה ב-Markdown מתוך קובץ תמלול, בצורה שנותנת ערך מלא למי שלא היה בהרצאה.
תהליך העבודה
- קרא את קובץ התמלול (בד"כ
output/transcription_plain.txt
- נתח את התוכן: זהה נושאים, דוברים, שאלות מהקהל, וציטוטים חשובים
- כתוב את הסיכום לפי המבנה שב-template.md
- שמור ב-
output/lecture_summary.md
- (אופציונלי) המר ל-Word — ראה שלב "ייצוא ל-Word" למטה
אסור בהחלט
אל תוסיף שום הערה עריכתית שלא מגיעה מהתמלול.
דוגמאות להערות אסורות:
- "זה הסיכום למי שרצה את התוכן"
- "מי שלא הגיע יכול לשמוע את ההקלטה"
- "הסיכום נכתב על בסיס התמלול בלבד"
- "לפרטים נוספים ניתן לפנות למרצה"
- כל משפט שאינו תוכן ישיר מהתמלול
עקוב אחר template.md בלבד. לא מוסיפים, לא מסבירים, לא מגיבים — פשוט כותבים את הסיכום.
כללי כתיבה
שפה ומונחים
- הסיכום בעברית, אבל מושגי tech ותכנות נשארים באנגלית
- דוגמאות: production, deploy, PR, build, MCP, workspace, branch, commit, Docker image, rollout, pipeline, CI/CD, code review, unit test, integration test, API, endpoint, repository
- שמות כלים ומוצרים באנגלית: Cursor, Jenkins, Argo, Splunk, Jira, GitHub
הנחיות שלב-אחרי-שלב
כשיש תהליך או רצף פעולות, השתמש בחיצים:
git clone --> פתיחת workspace ב-Cursor --> הרצת build --> deploy ל-QA
מבנה הסיכום
הסיכום חייב להיות כרונולוגי -- לפי הסדר שבו הדברים נאמרו בהרצאה. ראה template.md למבנה המלא.
עקרונות תוכן
- ערך מלא -- מי שפספס את ההרצאה צריך לקבל את כל התוכן המהותי
- קונקרטי -- דוגמאות ספציפיות, לא הכללות
- שאלות מהקהל -- כל שאלה ותשובה, זה חלק חשוב מהערך
- ציטוטים -- משפטים חזקים ומדויקים שנאמרו בהרצאה
- אל תמציא תוכן שלא נאמר בהרצאה
- אם חלק מהתמלול לא ברור -- דלג עליו, אל תנחש
ייצוא ל-Word (אופציונלי)
לאחר שמירת הסיכום ב-Markdown, אפשר להמיר לקובץ Word:
bash
python "<skill_dir>/scripts/md_to_word.py" "<path_to_summary.md>"
הפקודה שומרת את ה-
ליד קובץ ה-Markdown, באותה תיקייה.
תלויות: הסקריפט דורש
(ראה
).
קרא את הפלט ופעל לפיו:
| פלט | פעולה |
|---|
[DONE] /path/to/file.docx
| דווח למשתמש על הקובץ שנוצר |
[MISSING_DEP] python-docx is not installed.
| הצג למשתמש את ההודעה הבאה והמשך בכל זאת (אל תעצור) |
| הצג את השגיאה למשתמש |
כשחסרה הספרייה, אמור למשתמש:
"כדי לייצא ל-Word, צריך להתקין python-docx:
הסיכום נשמר ב-Markdown ותקין — ניתן לייצא ל-Word בכל עת."
ואז המשך. אל תחסום את תהליך הסיכום בגלל העדר הספרייה.
חשוב: אין הערות עריכה
הסיכום הוא תוכן בלבד. אין להוסיף:
- הקדמות או מסקנות שלך
- הפניות להקלטה, למרצה, או למקורות חיצוניים
- הסברים על איך הסיכום נכתב
- כל דבר שאינו חלק מהמבנה ב-template.md