सत्यापन गाइड

मार्केटप्लेस पर प्रकाशित करने से पहले सुनिश्चित करें कि आपका स्क्वॉड गुणवत्ता मानकों को पूरा करता है।

सत्यापन क्यों करें?

स्क्वॉड उपयोगकर्ता के वातावरण में कोड चलाते हैं। सत्यापन आपके स्क्वॉड को अन्य डेवलपर्स तक पहुँचने से पहले गुणवत्ता, सुरक्षा और संरचनात्मक अखंडता सुनिश्चित करता है।

क्या जाँचा जाता है

सत्यापक आपके स्क्वॉड का 6 भारित श्रेणियों में विश्लेषण करता है:

श्रेणीभारक्या सत्यापित करता है
मैनिफेस्ट (squad.yaml)25%name, version, description, aiox.minVersion, components
संरचना15%डायरेक्टरी, अपेक्षित फ़ाइलें, एक्सटेंशन
एजेंट20%आवश्यक फ़ील्ड, archetype, persona_profile, whenToUse
टास्क15%इनपुट/आउटपुट अनुबंध, responsavel, atomic_layer
वर्कफ़्लो10%agent_sequence, transitions, success_indicators
क्रॉस-रेफ़रेंस15%संदर्भित एजेंट मौजूद हैं, कोई चक्रीय निर्भरता नहीं

स्कोरिंग सिस्टम

प्रत्येक स्क्वॉड को ऊपर दी गई भारित श्रेणियों के आधार पर 0 से 100 तक का स्कोर मिलता है।

SAFEस्कोर >= 80, कोई त्रुटि नहीं — प्रकाशन के लिए तैयार
WARNINGचेतावनियाँ हैं लेकिन कोई ब्लॉकिंग त्रुटि नहीं
CRITICALत्रुटियाँ हैं या स्कोर सीमा से नीचे — प्रकाशन से पहले ठीक करना होगा

कैसे सत्यापित करें

a) CLI (अनुशंसित)

प्रकाशन से पहले अपने स्क्वॉड को स्थानीय रूप से सत्यापित करने का सबसे तेज़ तरीका:

squads validate ./my-squad           # पूर्ण सत्यापन
squads validate ./my-squad --json    # JSON आउटपुट
squads publish ./my-squad --dry-run  # प्रकाशन सिमुलेट करें

validationDocs.aiosMethodTitle

validationDocs.aiosMethodDescription

/SQUADS:nsc:squad-validator

*validate-squad my-squad

*extend-squad my-squad --add task --name missing-task

c) Claude Code (बिना Squad)

Claude Code को CLI का उपयोग करके अपना स्क्वॉड सत्यापित करने का निर्देश दें:

npx squads validate ./squads/my-squad

d) वेब (जमा पृष्ठ)

जमा पृष्ठ GitHub URL पेस्ट करने पर स्वचालित रूप से सत्यापन चलाता है। जमा करने से पहले सभी समस्याएँ ठीक करें।

सामान्य त्रुटियाँ और सुधार

त्रुटिकारणसुधार
description को ऑब्जेक्ट के रूप में पार्स किया गयामल्टी-लाइन YAML (| या >)कोट्स में इनलाइन स्ट्रिंग का उपयोग करें
एजेंट में आवश्यक फ़ील्ड गायबwhenToUse, archetype आदि गायबfrontmatter में फ़ील्ड जोड़ें
Task responsavel नहीं मिलाएजेंट नाम मेल नहीं खातासटीक agent.name मान का उपयोग करें
वर्कफ़्लो एजेंट अनुक्रम में नहींagent_sequence में अमान्य IDagent.id (kebab-case) का उपयोग करें
कंपोनेंट्स बेमेलsquad.yaml में सूचीबद्ध फ़ाइलें मौजूद नहींcomponents को वास्तविक फ़ाइलों से सिंक करें

प्री-पब्लिश चेकलिस्ट

name, version, description के साथ वैध squad.yaml
कोई .env फ़ाइलें या हार्डकोडेड क्रेडेंशियल नहीं
कोई node_modules/ या .git/ डायरेक्टरी नहीं
इंस्टॉलेशन सेक्शन के साथ README.md मौजूद है
सभी एजेंट में आवश्यक फ़ील्ड हैं (archetype, whenToUse, persona_profile)
सभी टास्क में इनपुट/आउटपुट अनुबंध हैं
क्रॉस-रेफ़रेंस वैध हैं (एजेंट मौजूद हैं, कोई चक्रीय deps नहीं)

Squad क्वालिटी गेट्स

Squad Core उपयोगकर्ताओं के लिए, फ्रेमवर्क स्क्वॉड जनरेशन के दौरान बिल्ट-इन क्वालिटी गेट्स प्रदान करता है:

  • फ़ेज़ 6: स्क्वॉड जनरेशन क्वालिटी गेट — संरचना, फ़ील्ड और क्रॉस-रेफ़रेंस पर 22 ब्लॉकिंग जाँचें।
  • फ़ेज़ 9: प्री-पब्लिश चेकलिस्ट — मार्केटप्लेस प्रकाशन तत्परता पर 16 ब्लॉकिंग जाँचें।

पुनरावृत्त सत्यापन और सुधार के लिए *validate-squad और *extend-squad कमांड का उपयोग करें:

*validate-squad my-squad
*extend-squad my-squad --add agent --name new-agent

अधिक विवरण के लिए, देखें CLI संदर्भ

सत्यापन गाइड — SQUADS