पाठ 6 / 25

Descriptions और Progressive Disclosure

सही ढंग से trigger होने वाले descriptions लिखें और विस्तृत सामग्री अलग files में रखें।

सिर्फ़ ज़रूरी लोड करें

हर skill का सिर्फ़ नाम और description हमेशा context में रहता है। Skill चुने जाने पर body लोड होती है, और अतिरिक्त files तभी जब निर्देश उन्हें माँगें। यह progressive disclosure कई skills install करने देता है बिना context window भरे।

कमज़ोर बनाम मज़बूत description

मज़बूत description बताता है कि skill क्या करता है और किन स्थितियों में चलना चाहिए, उन्हीं शब्दों में जो user सचमुच उपयोग करता है।

# Weak: too vague to trigger reliably
description: Helps with documents.

# Strong: says what and when
description: Convert a Markdown file to a styled PDF. Use when the user asks to export, print or share a .md file as PDF.

Trigger जाँचें

अनुरोध के कई रूप आज़माएँ, उनमें वे भी जो मेल नहीं खाने चाहिए। Skill बहुत बार या कभी न चले तो body छूने से पहले description दोबारा लिखें।

त्वरित जाँच: लंबी संदर्भ सामग्री को अलग files में क्यों बाँटें?

  • YAML में यह ज़रूरी है
  • ताकि वह ज़रूरत पर ही लोड हो और context बचे
  • ताकि skill धीमा चले
  • ताकि वह agent से छिपी रहे
Answer

ताकि वह ज़रूरत पर ही लोड हो और context बचे — ज़रूरत पर लोड होने वाला बड़ा विवरण डिफ़ॉल्ट context छोटा रखता है।