सत्यापन गाइड
मार्केटप्लेस पर प्रकाशित करने से पहले सुनिश्चित करें कि आपका स्क्वॉड गुणवत्ता मानकों को पूरा करता है।
सत्यापन क्यों करें?
स्क्वॉड उपयोगकर्ता के वातावरण में कोड चलाते हैं। सत्यापन आपके स्क्वॉड को अन्य डेवलपर्स तक पहुँचने से पहले गुणवत्ता, सुरक्षा और संरचनात्मक अखंडता सुनिश्चित करता है।
क्या जाँचा जाता है
सत्यापक आपके स्क्वॉड का 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 तक का स्कोर मिलता है।
कैसे सत्यापित करें
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-taskc) Claude Code (बिना Squad)
Claude Code को CLI का उपयोग करके अपना स्क्वॉड सत्यापित करने का निर्देश दें:
npx squads validate ./squads/my-squadd) वेब (जमा पृष्ठ)
जमा पृष्ठ GitHub URL पेस्ट करने पर स्वचालित रूप से सत्यापन चलाता है। जमा करने से पहले सभी समस्याएँ ठीक करें।
सामान्य त्रुटियाँ और सुधार
| त्रुटि | कारण | सुधार |
|---|---|---|
| description को ऑब्जेक्ट के रूप में पार्स किया गया | मल्टी-लाइन YAML (| या >) | कोट्स में इनलाइन स्ट्रिंग का उपयोग करें |
| एजेंट में आवश्यक फ़ील्ड गायब | whenToUse, archetype आदि गायब | frontmatter में फ़ील्ड जोड़ें |
| Task responsavel नहीं मिला | एजेंट नाम मेल नहीं खाता | सटीक agent.name मान का उपयोग करें |
| वर्कफ़्लो एजेंट अनुक्रम में नहीं | agent_sequence में अमान्य ID | agent.id (kebab-case) का उपयोग करें |
| कंपोनेंट्स बेमेल | squad.yaml में सूचीबद्ध फ़ाइलें मौजूद नहीं | components को वास्तविक फ़ाइलों से सिंक करें |
प्री-पब्लिश चेकलिस्ट
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 संदर्भ