AGENTS, Skills, Docs ו-Markdown

הכל מתחיל במפרטים שאפשר לקרוא, לשתף ולשפר

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

הרעיון המרכזי - Harness Mindset

Agentic Engineering אינו “קסם פרומפטים”. הוא הנדסת מפרטים:

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

Markdown הוא השפה הפשוטה ביותר לתיעוד כזה: קריא לבני אדם, קריא ל־agents, נכנס ל־Git, ונבנה לאתר.

שכבות הוראות

flowchart TD
    A["Global instructions"] --> B["Repo AGENTS.md"]
    B --> C["Folder-specific instructions"]
    C --> D["Task prompt"]
    D --> E["Agent actions"]
    E --> F["Tests / Review"]

AGENTS.md

AGENTS.md הוא קובץ הוראות לפרויקט. לפי תיעוד Codex, הוא נטען כהקשר קבוע ומאפשר להגדיר מוסכמות עבודה, פקודות build/test, גבולות, ותנאי סיום.

תוכן מומלץ:

# AGENTS.md

## Project layout
- Lessons live under `android/projectSteps`.
- Interactive pages live under `interactive`.

## Commands
- Build: `bundle exec jekyll build`

## Rules
- Keep edits scoped.
- Do not rewrite unrelated lessons.
- After editing, run the build.

חשיבה אייג’נטית (Harness mindset)

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

כל דבר יכול להיות יותר harness-oriented

Skills

Skill הוא workflow ארוז. במקום לכתוב כל פעם:

צור דף שאלון אינטראקטיבי לפי הדפוס של interactive/...

אפשר ליצור skill שמתאר:

  • מתי להשתמש בו.
  • אילו קבצים לקרוא כדוגמה.
  • איזה מבנה front matter צריך.
  • איך להריץ verification.

Docs רגילים

לא כל דבר צריך להיות skill. לפעמים מספיק:

  • README.md
  • docs/testing.md
  • docs/deploy.md
  • docs/code_review.md
  • DIFF_RULES.md

הכלל הפשוט:

צורך פתרון
כלל קבוע לכל repo AGENTS.md
workflow שחוזר הרבה skill
הסבר לבני אדם Markdown doc
בדיקה אוטומטית test / script

Kramdown באתר הזה

באתר הזה אפשר להשתמש ביכולות שמעשירות הוראה:

{: .box-note}
זוהי הערה חשובה לתלמידים.

{: .box-success}
זהו סיכום חיובי או checkpoint שעבר.

טבלה עם מחלקה:

| עברית | English |
|---|---|
| בדיקה | Test |
{: .tabl-rl}

תרשים:

```mermaid
flowchart LR
    A["Prompt"] --> B["Agent"] --> C["Tests"]
```

דף מפרט למשימה

לפני שמבקשים מ־agent לבנות משהו משמעותי, כתבו דף קצר:

# Feature spec

## Goal

## User flow

## Constraints

## Done when

## Tests

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

קישור פנימי

ראו גם את הסיפור מאחורי GitHub Pages ואת הדוגמאות הקיימות לשימוש ב־Mermaid, תיבות וטבלאות ברחבי האתר.

מקורות