पाठ 13 / 29

ऐसा कार्य लिखना जिसमें Agent सफल हो सके

स्पष्ट लक्ष्य, बाधाएँ, संकेत और सफलता जाँचने का तरीक़ा दें।

उसे सक्षम नए सहकर्मी की तरह ब्रीफ़ करें

अच्छे कार्य विवरण के पाँच हिस्से हैं: लक्ष्य और क्यों ("बड़े ग्राहकों के लिए orders API धीमी है; cursor pagination जोड़ो"), कहाँ देखें (files, समान मौजूदा कोड), बाधाएँ (कोई नई dependency नहीं, response format backward compatible रखो, प्रदर्शन सीमाएँ), कैसे सत्यापित करें (जो commands पास होनी चाहिए, या पहले लिखने वाले tests) और दायरा ("सिर्फ़ orders endpoint; refactor मत करो")। अस्पष्ट कार्य ("कोड सुधारो") बड़े, अकेंद्रित diffs बनाते हैं; अति-निर्देशात्मक ("पंक्ति 42 पर x को y करो") agent की क्षमता बर्बाद करते और ग़लत ब्योरे का जोखिम रखते हैं। अस्पष्ट आवश्यकताओं के लिए agent से कहें कि संपादन से पहले योजना प्रस्तावित करे या सवाल पूछे और आप उसे अनुमोदित करें। वांछित व्यवहार और किनारे के मामलों के उदाहरण दें; वे tests का भी काम करते हैं।

योजना, test, छोटे चरण, समानांतर

सर्वश्रेष्ठ परिणाम स्पष्ट लक्ष्यों, लक्ष्य के रूप में tests, छोटे समीक्षा-योग्य बदलावों और उपयोगी होने पर अलग branches में कई agents से आते हैं।

चार आदतें: निर्दिष्ट करें, पहले test, छोटे चलें, अलग रखें।
चित्र 4.1 — निर्दिष्ट करें, पहले test, छोटे चलें और अलग रखें।

कमज़ोर और मज़बूत कार्य

आशय वही; दूसरा agent को वह देता है जो सफल होने और जाँचे जाने को चाहिए।

WEAK
  Make the cart code better.

STRONG
  Goal: Cart.total() wrongly applies discounts (apply_discount divides the percent by 10).
  Look at: shop/pricing.py, tests/test_pricing.py.
  Constraints: keep the function signatures; no new dependencies; money stays a float for now.
  Verify: `python -m unittest discover -s tests -t .` must pass; add a test for 15% off 200.
  Scope: only shop/pricing.py and its tests. Show me the diff and a 2-line explanation.

अपेक्षित व्यवहार का उदाहरण दें

"200 पर 15% छूट 170 देनी चाहिए" अनुच्छेद से स्पष्ट है, और test का भी काम करता है।

त्वरित जाँच: कौन-सा तत्व agent (और आपको) बताता है कि कार्य पूरा हुआ?

  • मित्रवत लहजा
  • सत्यापन का ठोस तरीक़ा, जैसे tests जो पास होने चाहिए
  • लंबी पृष्ठभूमि कहानी
  • Random समय सीमा
Answer

सत्यापन का ठोस तरीक़ा, जैसे tests जो पास होने चाहिए — जाँच के बिना "पूर्ण" बस agent की राय है।