תיקון טיקט: מהטראקר ל-pull request
נותנים לסוכן טיקט והוא מבצע את כל המחזור: קורא את הטיקט, מוצא את הקוד, משחזר את הבאג, מתקן, מריץ את הבדיקות, עושה commit, עושה push, פותח pull request ומעדכן את הטיקט. הצעדים שאחרים רואים מחכים לאישור שלכם.
Beta עובד בצ'אט הסוכן של Ingot וכמשימה של Rex, עם Jira, Asana, OpenText Octane, Linear ו-GitHub Issues, מול GitHub, GitLab, Bitbucket, Azure DevOps ו-Gitea / Forgejo.
איך מתחילים
בצ'אט הסוכן, אחת מהאפשרויות:
- מקלידים
fix PROJ-123(אוfix #12ל-issue ב-GitHub). - מדביקים כתובת של טיקט מ-Jira, Asana, Octane, Linear או GitHub.
- מקלידים
/fix-ticket PROJ-123. - פותחים את תפריט
{ + }ובוחרים Fix a ticket. בלי מפתח, הסוכן מציג את הבאגים הפתוחים שלכם מהטראקרים המחוברים ושואל איזה לתקן.
שאלה כמו "למה PROJ-12 נשבר?" נשארת הודעה רגילה.
מה הסוכן עושה
| שלב | מה קורה | שואל קודם |
|---|---|---|
| קריאה | הטיקט, התגובות ומה שהטראקר מחזיר על קישורים וקבצים מצורפים | לא (קריאה בלבד) |
| ענף | fix/PROJ-123-short-summary, נוצר לפני כל עריכה | לפי הגדרת האישור של git |
| שחזור | בדיקה שנכשלת בגלל הבאג, מורצת פעם אחת כדי לראות שהיא נכשלת | לפי הגדרת האישור של פקודות |
| תיקון ובדיקה | עריכות קטנות, ואז שוב הבדיקה והבדיקות של הפרויקט | לפי הגדרת האישור של פקודות |
| Commit | הכותרת מתחילה במפתח: PROJ-123: …. Ingot מוסיף את המפתח אם המודל השמיט אותו | לפי הגדרת האישור של git |
| Push | רק ענף הטיקט, אף פעם לא main, master או ענף release | כן |
| Pull request | כותרת עם המפתח; הגוף מקשר לטיקט ומפרט את הבדיקות שרצו | כן, תמיד |
| טיקט | תגובה עם הקישור ל-pull request ואז מעבר ל-In Review | כן, כל כתיבה |
אם מדלגים על שלב בכרטיס שלו, הסוכן עוצר שם ואומר מה נשאר.
Pull requests בכל מארח
הסוכן פותח את ה-pull request בכלי אחד, open_pull_request:
- GitHub: עם ההתחברות ל-GitHub שכבר יש ל-Ingot (ה-CLI של GitHub,
GH_TOKENאו הטוקן של שרת ה-MCP של GitHub). - GitLab, Bitbucket, Azure DevOps, Gitea / Forgejo: עם החשבון שחיברתם ב-Git Hosts.
כשהמארח לא מחובר, לא נפתח דבר והסוכן נותן לכם את דף "pull request חדש" של המארח.
חיבור הטראקר
טראקרים הם שרתי MCP. מחברים אותם בדף Rules & MCP:
| טראקר | איך מתחברים |
|---|---|
| Jira | Jira & Confluence: התחברות בלחיצה עם חשבון Atlassian |
| Asana | Asana: התחברות דרך אפליקציית Asana. Asana לא מאפשרת לאפליקציות לרשום את עצמן, ולכן מזינים client ID של אפליקציה שיצרתם בקונסולת המפתחים של Asana |
| OpenText Octane | OpenText Octane: כתובת השרת שלכם, https://<your-octane-host>/mcp. מנהל Octane צריך להפעיל MCP באתר שלכם ולרשום את הלקוח או לתת לכם טוקן API |
| Linear | Linear: התחברות בלחיצה או מפתח API |
| GitHub Issues | GitHub: ההתחברות שלכם ל-GitHub |
בלי חיבור, הסוכן מבקש שתדביקו את טקסט הטיקט ולא נוגע בטיקט בסוף.
מה שהסוכן יכול לעשות בטיקט תלוי בכלים שהשרת של הטראקר מציע. אם אין כלי לשלב מסוים (למשל שינוי סטטוס), הסוכן אומר זאת במקום לנחש.
Rex
ב-Rex מתחילים משימה על ריפו מחובר עם Fix ticket PROJ-123 או קישור לטיקט. היא רצה כמשימה:
- Rex קורא את הטיקט דרך האפליקציה המחוברת, משחזר את הבאג ומתקן אותו.
- הפלטפורמה עושה commit ב-
ingot-bot/fix-PROJ-123-…, עם המפתח בכותרת ה-commit ובכותרת ה-pull request, ומקשרת לטיקט בראש ה-pull request. - אחרי שה-pull request פתוח, Rex מגיב בטיקט ומעביר אותו ל-In Review. כל שינוי מחכה בכרטיס האישור.
מכבים ב-Rex › Settings › Missions: Fix tickets ו-Update the ticket after the pull request.
הגדרות
| הגדרה | ברירת מחדל | מה היא עושה |
|---|---|---|
ingot.tickets.fix.enabled | true | Fix ticket והכלי open_pull_request של הסוכן (Settings › Features) |
ingot.tickets.fix.detect | true | מתחיל ב-fix <key> או בכתובת טיקט מודבקת. כבוי: רק /fix-ticket והפעולה ב-{ + } |
ingot.tickets.fix.branchPrefix | fix/ | במה מתחילים ענפי טיקט |
ingot.tickets.fix.comment | true | תגובה בטיקט אחרי פתיחת ה-pull request |
ingot.tickets.fix.moveTo | In Review | הסטטוס שאליו הטיקט עובר. ריק: לא נוגעים |
ingot.tickets.fix.draftPullRequest | false | פותח pull requests של טיקטים כטיוטות |
ההגדרות נמצאות ב-Settings › Version Control › Tickets, ופרויקט יכול לקבוע אותן ב-.ingot/settings.json.
מגבלות
- קבצים מצורפים נקראים רק ככל שהשרת של הטראקר מחזיר אותם.
- Octane מתעדת כלי קריאה; האם אפשר להגיב או לשנות שלב תלוי בשרת של האתר שלכם.
- Rex פותח pull requests ב-GitHub וב-GitLab. במארחים אחרים השינוי נשאר ביומן הריצה.
- Commits ו-pull requests נושאים את הייחוס, אלא אם כיביתם אותו.