# ऐसा कार्य लिखना जिसमें Agent सफल हो सके — Coding Agents और AI-Assisted Development

Source: https://www.geekswithgeeks.com/hi/coding-agents/w-spec

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

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

अच्छे कार्य विवरण के पाँच हिस्से हैं: **लक्ष्य** और क्यों ("बड़े ग्राहकों के लिए 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, छोटे चलें, अलग रखें।](assets/figures/coding-agents/section-4-map.svg) — चित्र 4.1 — निर्दिष्ट करें, पहले test, छोटे चलें और अलग रखें।

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

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

```text
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 का भी काम करता है।

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

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

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