როგორ აღწერთ ხელმოკიდებას AI დამხმარეს, რომ ის შეძლოს მისი ზუსტად დიაგნოსტიკა?

Question

Accepted Answer

კარგი ხელმოკიდებული ანგარიში AI-სთვის იგივეა, რაც კარგი ხელმოკიდებული ანგარიში ადამიანისთვის: მიეცით მას **საკმარისი კონტექსტი პრობლემის თავაში რეპროდუცირებისთვის** და შეამცირეთ ხმაური. AI-ს შეუძლია მხოლოდ ის აზროვნება, რომელიც თქვენ ატან — ბუნდოვანი აღწერილობები ბუნდოვან ვარაუდებს ქმნის.

## რა უნდა იყოს অন্তর্ভুক্ত

- **ზუსტი შეცდომის გამოწერა და სრული stack trace** — დააკოპირეთ სიტყვასიტყვით, არა პარაფრაზი. trace-ში ფაილი და ხაზი ყველაზე სასარგებლო მინიშნებაა.
- **შესაბამისი კოდი** — ფუნქცია, რომელიც ისროდებს პლუს მისი უშუალო ზამთრის, არა მთელი repo.
- **მოსალოდნელი vs რეალური ქცევა** — "მე ელი X, მაგრამ მივიღე Y" ნებისმიერი ხელმოკიდებული ანგარიშის ბირთვია.
- **მეორე ნაბიჯები** — ზუსტი შეყვანა ან თანმიმდევრობა, რომელიც ის აქტივირებს.
- **გარემო/ვერსიები** — ენა, ჩარჩო და ბიბლიოთეკის ვერსიები (ხელმოკიდებული ვერსია-სპეციფიკური შეიძლება იყოს).
- **DB სქემა ან ნიმუშის მონაცემები** — როდესაც ხელმოკიდებული კითხავს შეკითხვას ან მონაცემთა ფორმას.

## რა უნდა იყოს გამორიცხული

უკავშირო ფაილები, მთელი კონფიგურაცია, საიდენტიფიკაციო/API გასაღები და "დაფიქრდა, რომ შეიძლება იყოს X" თეორიები, რომლებიც დიაგნოსტიკას ან მდგრადს. მოიტანეთ ფაქტები, არა მოსაზრებები.

## სუსტი vs ძლიერი ანგარიში

```text
❌ WEAK: "My login is broken, it throws an error. Why?"
   → no error text, no code, no repro → the AI can only guess

✅ STRONG:
   Error (verbatim):
     TypeError: Cannot read properties of undefined (reading 'id')
       at getUser (auth.js:42)
   Code (auth.js:40-43):
```

```js
function getUser(token) {
  const session = sessions.find(s => s.token === token); // returns undefined if not found
  return session.user.id; // line 42: crashes when session is undefined
}
```

```text
   Expected: return null for an unknown token.
   Actual:   throws TypeError above.
   Repro:    call getUser('expired-token').
   Env:      Node 20, no framework.
```

ძლიერი ვერსიით, AI-ს შეუძლია სწორად მიუთითოს დაკარგული `undefined` შემოწმება და გთავაზოთ დაცვა, რადგან თითოეული ფაქტი, რომელიც მას სჭირდება, ვებგვერდზეა.

## რატომ არის ეს მნიშვნელოვანი

AI დამხმარეს **არ აქვს წვდომა თქვენს მხედელი სისტემაზე** — ის მხოლოდ იმ მიხედვით მოსაზრება, რასაც მიეწოდებოდა. სუსტი ანგარიში აძულებს მას გამოიცნოს შეცდომა, კოდი და გარემო ერთდროულად, ხოლო არასწორი გამოცნობა ტალღა-ტრიპს უფასოდ მდგრადს. ძლიერი ანგარიში (ზუსტი ტრაკი + შესაბამისი კოდი + მოსალოდნელი/რეალური + რეპრო + ვერსიები) დიაგნოსტიკას აქცევს ფოკუსირებულ ამოცანად და ჩვეულებრივ პირველი ცდით იღებს სწორ ფიქსს. ტიტანი ხელმოკიდებული ანგარიშის წერის სწავლა აქ თქვენ ასევე უკეთესი debugger, რადგან ის აძულებს თქვენ აბსტრაქტული ფაქტები, სანამ ჩეკ.