Agentic Engineering על Google Sheets ו-clasp

הרבה מורים כבר עובדים עם Google Sheets: ציונים, נוכחות, משימות, קבוצות, קישורים, מעקב הגשות, אוטומציות של google classroom. לכן App Script הוא גשר טבעי בין “כלי משרדי” לבין Agentic Work (שלב בדרך ל- Agentic Engineering).

מה זה clasp?

clasp הוא כלי command-line רשמי של Google לפיתוח וניהול Apps Script מהמחשב המקומי. לפי תיעוד Google, הוא מאפשר לעבוד מקומית, להשתמש ב־Git, לנהל גרסאות ו־deployments, ולסדר קוד בתיקיות.

למה זה agentic?

הכנת פרוייקט

flowchart LR
    A["Google Sheet"] --> B["Apps Script project"]
    B --> C["clasp pull"]
    C --> D["Local repo"]
    D --> E["share on github"]

עבודה שוטפת

flowchart LR
    X["User prompt"] --> E["Agent edits"]

    E --> G["clasp push"]
    G --> H["Test in Google Sheets"]

    H --> D{"Works correctly?"}

    D -->|No| E
    D -->|Yes| F["Git commit & sync"]

    F --> X

דרישות קדם - חיבור ל-GitHub CLI

winget install --id GitHub.cli -e

gh auth login

git config --global --list

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

agent settings, and github share.

• צרו תיקיה לפרוייקט במקום שנראה לכם. שימו לב שפתיחת תיקייה מתוך Codex Desktop תיצור תיקייה תחת document שעלול להיות חלק מ-OneDrive. זה לא מצב מוצלח לפרוייקט גדול
• נעביר את האייג’נט ל-Full Access
• נאתחל פרוייקט על ידי /init **ואז **
• נשלח פרומפט איתחול לקודקס

  publish on github as private

התקנה מקוצרת - בעזרת ה-AGENT

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

1. יצירת repo ופרסום ל-GitHub.
2. חיבור clasp לפרויקט Apps Script שכבר נוצר ב-Google.

כך תתרגלו כל שלב בנפרד, ולחזור רק על השלב שנשבר.

התקנה “ארוכה” כל השלבים כמו פעם-Windows

סרטון הדרכה: שימוש ב-clasp

1. התקנת Node.js

winget install --id OpenJS.NodeJS.LTS -e --source winget

בדיקה:

node -v
npm -v

2. התקנת clasp

npm i -g @google/clasp

בדיקה:

clasp --version

אם clasp לא מזוהה אחרי ההתקנה, סגרו ופתחו מחדש terminal. לעיתים PATH מתעדכן רק ב־session חדש.

יצירת תיקיית עבודה

cd C:\Users\<user>\source\repos
mkdir SubmissionProcessor
cd SubmissionProcessor

בדוגמה המקורית הופיעו שני שמות: SubmissionProcessor ו־AppScTestGrader. בחרו שם אחד ושמרו עליו לאורך כל העבודה.

התחברות ל-Google

clasp login

הפקודה תפתח browser ותבקש הרשאה לחשבון Google שבו נמצא פרויקט Apps Script.

Clone לפרויקט Apps Script קיים

clasp clone 1ayD8nA5N9yz0QyS0JM30tCeSVjQz0KOaqU4v191DowZoTwJWiNcXvNgY

פלט צפוי:

└─ appsscript.json
└─ Code.js
└─ ClassroomIntegration.js
Cloned 3 files.

אחרי clone אמורים להיות בתיקייה:

SubmissionProcessor/
├── .clasp.json
├── appsscript.json
├── Code.js
└── ClassroomIntegration.js

פקודות עבודה כלליות

סדר העבודה הבריא הוא: clasp pull, עבודה מקומית, git diff, commit, ואז clasp push. כך לא דורסים בטעות עבודה שנעשתה בדפדפן.

חיבור ל-GitHub CLI

מתקינים:

winget install --id GitHub.cli -e

מתחברים:

gh auth login

עכשיו אפשר לעבוד עם Git מקומי ו־GitHub מה־CLI. לא פחות חשוב גם לאייג’נט יותר קל לעבוד. עם gh מותקן ומאומת, סוכנים כמו Claude Code ו-Codex יכולים לפתוח PR-ים, לבדוק סטטוס של CI, ולתשאל issues/PRs ישירות מה-shell - בלי שתצטרך להעביר להם טוקן API בתוך ה-prompt. זה בעצם מרחיב להם את היכולות מעבר ל-git הבסיסי (commit/push/clone) לכל מה שדורש את ה-API של GitHub. שווה לבדוק שה-scopes שנבחרו ב-gh auth login מספיקים למה שתרצה שהסוכן יעשה.

יצירת repo פרטי ב-GitHub ודחיפה ראשונה

מתוך תיקיית הפרויקט:

git add -A
git commit -m "version capable of LLM feedback on all submissions"

יצירת repo מרוחק, הגדרת origin, ודחיפת הענף הנוכחי בפקודה אחת:

gh repo create myUsertegy/AppScTalEng --private --source . --remote origin --push

החליפו את myUsertegy/AppScTalEng בשם ה־GitHub organization/user וה־repo שלכם. לתרגול תלמידים מומלץ repo פרטי אם יש מידע רגיש או תוצרי בדיקה.

בהמשך העבודה:

git add -A
git commit -m "msg"
git push

או, אחרי שכבר הוספתם קבצים ל־staging:

git commit -m "msg" && git push

מבנה repo מומלץ

SubmissionProcessor/
├── AGENTS.md
├── .clasp.json
├── appsscript.json
├── Code.js
├── ClassroomIntegration.js
├── docs/
│   └── teacher-workflow.md
└── test-data/
    └── sample-grades.csv

AGENTS.md לפרויקט Sheets

# AGENTS.md

## Context
This repo contains Google Apps Script code managed with clasp.

## Rules
- Never hardcode student private data.
- Use sample data under `test-data/`.
- Before `clasp push`, show the diff and summarize changed functions.
- Prefer small pure helper functions that can be tested locally.

## Done when
- The script still opens the custom menu.
- The changed function has a small sample-input explanation.
- No real student data appears in the diff.

דוגמת משימה למורה

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

דוגמא לפרומפט אמיתי - מתעסק בעיקר בפונקציונליות

מה חשוב ללמד

חלק מה”נושאים” להלן כבר פחות חשובים מפני שה-AGENT יכול לסייע גם בהתקנות. חשוב להבין את ה-flow של העבודה.

נקודות זהירות

• לא להכניס שמות תלמידים או מזהים אמיתיים לפרומפטים.

נקודות זהירות לא רלוונטיות שהבינה העלתה

• לא להעלות .clasp.json אם מדיניות בית הספר לא מאפשרת חשיפת scriptId.
• לא לתת ל־agent הרשאה חופשית למחוק deployments. אני מניח שהוא המציא את זה מפרוייקטים אמיתיים של אנשים ולא מפרוייקט sheets.
• לא לדחוף בלי git diff. זה הופך לפחות ופחות משמעותי. היכולות של ה-Agent מספיק טובות כדי שבסביבה עם source control ניתן יהיה לסמוך עליו. לפחות בפרוייטק של sheets. במקרה הכי גרוע חוזרים לאחור. מה שחשוב לכם זה לבדוק כל הזמן פונקציונליות. אם המימוש שביקשתם הוא משהו שאינכם יכולים לבדוק - אתם מתקדמים בחשיכה.
• להעדיף פונקציות קטנות שמקבלות ערכים ומחזירות ערכים.
• לא לבצע clasp push בלי לוודא שאתם מחוברים לפרויקט הנכון. אין שום דבר לוודא. אם התחלתם את התהליך נכון - הפרוייקט הלוקאלי מחובר לפרוייקט הנכון. הוא לא מכיר דבר אחר.

מקורות

• Google Apps Script clasp documentation
• Google Apps Script Spreadsheet service