בדיקת נגישות לאתר בעזרת AI: מהסריקה ועד לתיקון
מדריך מעשי לכלי של Next Impact: איך בודקים אתר, מבינים את התוצאות ומעבירים בקשת תיקון ממוקדת למפתח או לסוכן AI.
מתקינים פעם אחת, מבקשים מהסוכן לבדוק את האתר ומקבלים דוח בעברית עם בעיות לפי עדיפות ובקשות תיקון להעתקה. המדריך מראה איך מתחילים ומה עושים עם התוצאות.
להתחיל לקרוא ↓המדריך והכלי נועדו לסיוע טכני ולבדיקת נגישות אוטומטית ראשונית בלבד. הם אינם תחליף לייעוץ משפטי או לבדיקת נגישות מקצועית, אינם מהווים אישור נגישות ואינם מעניקים פטור מחובות נגישות או מבטיחים עמידה בתקן או בדין. השימוש במדריך ובכלי, פרשנות התוצאות וביצוע פעולות על בסיסן הם באחריות המשתמש בלבד. גם דוח ללא כשלים אוטומטיים אינו מעיד שהאתר נגיש במלואו.
מה צריך כדי לבדוק נגישות של אתר
סקיל הוא תוספת של הוראות וכלים לסוכן AI. הכלי נבדק עם קודקס ועם קלוד קוד. צ׳אט רגיל לא מספיק, כי הסוכן צריך להריץ פקודות במחשב.
- כתובת האתר, בדיוק כפי שהיא מופיעה בדפדפן.
- קודקס או קלוד קוד מותקנים במחשב.
- חיבור לאינטרנט. בהרצה הראשונה הסוכן מוריד לבד את מה שהכלי צריך.
למי שרוצה לדעת יותר: סוכנים אחרים, עלויות ודרישות
- המתקין תומך גם בסוכנים נוספים, כמו קרסור וג׳מיני. את המסלולים האלה לא בדקנו כאן.
- בסוכן עצמו ייתכנו עלויות שימוש לפי התוכנית שלכם. הכלי פתוח ולא דורש מפתח משלו.
- דרישות במחשב: פייתון 3.9 ומעלה, נוד 20 ומעלה. נבדק במק ובאובונטו.
מתקינים פעם אחת
מעתיקים את הפקודה למסוף (טרמינל) ומריצים פעם אחת במחשב, לא בתוך פרויקט. מכאן והלאה זה עובד בכל פרויקט ובכל שיחה חדשה.
כבר התקנתם פעם? אותה פקודה מעדכנת לגרסה החדשה. אם הסוכן לא מזהה את הסקיל מיד, פותחים שיחה חדשה.
בהרצה הראשונה הסוכן מכין את סביבת הבדיקה ומוריד תלויות ודפדפן. בהמשך הוא משתמש במה שכבר ירד. אם חסר פייתון או נוד, הסוכן יסביר מה להתקין.
npx skills add MatanOps/israeli-accessibility-auditor --global --agent codex claude-code --yes
למי שרוצה לדעת יותר: התקנה לסוכן אחד בלבד
ההתקנה לא נוגעת במערכת ההפעלה ולא בפרויקט שלכם. הכל יושב בתיקייה נפרדת של הסקיל.
npx skills add MatanOps/israeli-accessibility-auditor --global --agent codex --yes
npx skills add MatanOps/israeli-accessibility-auditor --global --agent claude-code --yes
בודקים את האתר
מחליפים את הסוגריים בכתובת שלכם ומדביקים בשיחה עם הסוכן. הבדיקה לא משנה שום דבר באתר.
הסוכן סורק עמודים ציבוריים שהתגלו בקישורים ובמפת האתר: עד 100 עמודים ועד 10 דקות כברירת מחדל, ואפשר לבקש ממנו יותר. אין כניסה לחשבון, אין מילוי טפסים ואין הבטחה שכל עמוד באתר התגלה. לפני שהוא מתחיל הוא מציג את היקף הבדיקה, ובסיום פותח דוח בעברית.
בדוק את [כתובת האתר] עם israeli-accessibility-auditor
למי שרוצה לדעת יותר: תיקיית קוד או עמוד יחיד
יש לכם את הקוד ולא כתובת? זו בדיקת מקור חלקית, בלי דפדפן.
בדוק את [תיקיית הקוד] עם israeli-accessibility-auditor
בדוק רק את העמוד [כתובת העמוד] עם israeli-accessibility-auditor
איך קוראים דוח נגישות
קודם מסתכלים כמה עמודים נבדקו, כמה לא נבדקו בהצלחה וכמה נותרו. סריקה שנחסמה או נעצרה אינה תוצאה נקייה.
הדוח מונה בנפרד סוגי בעיות ומופעים. סוג אחד עם עשרים מופעים הוא לא בהכרח תיקון אחד.
| הקבוצה בדוח | מה עושים |
|---|---|
| הבעיות שכדאי לתקן קודם | מתחילים כאן. לכל בעיה יש כפתור שמכין בקשת תיקון. |
| בעיות שדורשות אימות לפני תיקון | מישהו בודק בעמוד אם זו בעיה, ורק אז מתקנים. |
| המלצות לבדיקה | שיטות עבודה מומלצות. לא כשל מאומת. |
| נושאים לבדיקה אנושית | מקלדת, קורא מסך וכדומה. רשימה להשלמה, לא תקלות שנמצאו. |
למי שרוצה לדעת יותר: קודי יציאה וקבצים
- קוד יציאה 1: יש ממצאים. קוד 2: שגיאה תפעולית, או סריקת אתר שלא הושלמה (הגבול הושג, עמודים נחסמו או נכשלו). קוד 0: אין ממצאים מסוג כשל או אזהרה, וזה אינו אישור נגישות.
- לצד דוח ה-HTML נכתבים גם קובץ מרקדאון וקובץ JSON, מחוץ לתיקיית האתר.
מהדוח לבקשת תיקון
בכרטיס של בעיה לוחצים ׳הכנת בקשה לתיקון זה׳ ואז ׳העתקת הבקשה׳. יוצא טקסט מוכן להדבקה.
- לכל הבעיות המאומתות בבת אחת: הכפתור ׳הכנת בקשה לכל הבעיות המאומתות׳ בראש הדוח.
- את הטקסט מדביקים אצל סוכן שיש לו גישה לפרויקט של האתר, או שולחים למי שמתחזק את האתר. ייתכן שיידרשו גם גישה, תוכן או החלטה שלכם.
למי שרוצה לדעת יותר: בחירה ידנית והורדת קובץ
- תחת ׳בחירה ידנית ופעולות נוספות׳ בדוח מסמנים ממצאים ולוחצים ׳הצגת הבקשה שנבחרה׳, ׳העתקת בקשה ל־Codex / Claude׳ או ׳הורדת קובץ לצירוף לסוכן׳. ׳ניקוי הבחירה׳ מאפס.
- הבקשה כוללת רק את מה שנבחר. שיניתם את הבחירה? מכינים אותה שוב.
מתקנים ובודקים שוב
מדביקים אצל הסוכן את הבקשה מהדוח, ומתחתיה את המשפטים האלה.
בודקים את התיקון בתצוגה מקדימה. אחרי פרסום מאושר בודקים שוב את הכתובת החיה, כי עד אז היא מציגה את הגרסה הישנה.
מצורפת בקשת התיקון מהדוח. אמת וטפל רק בממצאים שנבחרו, בלי לפגוע בשינויים אחרים. אם חסרים גישה, תוכן או החלטה שלי, ציין זאת ואל תמציא טקסט חלופי. בדוק שוב וסכם מה תוקן ואומת ומה עדיין פתוח. אל תפרסם שינויים באתר החי.
למי שרוצה לדעת יותר: איך מאמתים תיקון
- השוואה לדוח קודם מאמתת תיקון רק מול אותו יעד, אותו מצב סריקה וכיסוי מתאים. בדיקה של סביבה מקומית או תצוגה מקדימה מול דוח של האתר החי אינה מאמתת תיקון באותה השוואה.
- היעלמות ממצא אינה הוכחה לתיקון. רק ממצא שסומן כתוקן ואומת נספר.
מה עושים עם זה מחר בבוקר
צעד 1 פעם אחת. צעד 2 על האתר. את הבקשות מהדוח שולחים למי שמתקן, ואחרי הפרסום בודקים שוב.
- שומרים את הדוח הראשון. בפעם הבאה משווים אליו.
- הכלי, התיעוד המלא והמגבלות נמצאים בריפו הציבורי.
שאלות שחוזרות על בדיקת נגישות עם סוכן AI
מה זה israeli-accessibility-auditor?
כלי קוד פתוח מבית Next Impact שסוכן AI מריץ במחשב שלכם. הוא סורק אתר ציבורי או תיקיית קוד ומפיק דוח נגישות בעברית, עם בעיות לפי עדיפות ובקשות תיקון להעתקה. הבסיס הישראלי הוא ת״י 5568, ויעד ההנדסה הוא WCAG 2.2 AA.
הסוכן לא מזהה את הסקיל.
פותחים שיחה חדשה. אם זה לא עוזר, מריצים שוב את פקודת ההתקנה.
ההכנה הראשונה נעצרת.
הסוכן אומר מה חסר, לרוב פייתון או נוד, ומה להתקין. מתקינים ומריצים שוב.
הדוח אומר שהסריקה חלקית.
הגבול של עמודים או זמן הושג, או שעמודים נחסמו. הדוח מציין מה נותר. אפשר לבקש מהסוכן להגדיל את הגבול ולהריץ שוב. זו לא תוצאה נקייה.
במקום האתר עלה מסך חסימה.
אין תוצאה. בודקים כתובת אחרת שמורשית לכם, כמו תצוגה מקדימה. לא עוקפים קאפצ׳ה או הגנות.
המדריך והכלי נועדו לסיוע טכני ולבדיקת נגישות אוטומטית ראשונית בלבד. הם אינם תחליף לייעוץ משפטי או לבדיקת נגישות מקצועית, אינם מהווים אישור נגישות ואינם מעניקים פטור מחובות נגישות או מבטיחים עמידה בתקן או בדין. השימוש במדריך ובכלי, פרשנות התוצאות וביצוע פעולות על בסיסן הם באחריות המשתמש בלבד. גם דוח ללא כשלים אוטומטיים אינו מעיד שהאתר נגיש במלואו.