कमांड कैसे काम करते हैं

यह जानने वाली एक बात है: OpenSpec के दो प्रकार के कमांड होते हैं, और वे दो अलग-अलग जगहों पर चलते हैं।

• openspec ... कमांड आपके टर्मिनल में चलते हैं। (उदाहरण: openspec init।)
• /opsx:... कमांड आपके AI असिस्टेंट की चैट में चलते हैं। (उदाहरण: /opsx:propose।)

यदि आप कभी भी अपने टर्मिनल में /opsx:propose टाइप करते हैं और कुछ नहीं होता है, तो यह पेज इसके लिए है। आप OpenSpec के गलत हिस्से से बात कर रहे हैं। स्लैश कमांड टर्मिनल कमांड नहीं होते हैं। वे आपके AI कोडिंग असिस्टेंट को दिए गए निर्देश हैं, ठीक उसी चैट बॉक्स में जहाँ आप सामान्य रूप से "एक लॉगिन फॉर्म जोड़ें" टाइप करते हैं।

यह एक ही अंतर नए उपयोगकर्ताओं के लिए सबसे आम बाधा है, इसलिए आइए इसे बिल्कुल स्पष्ट कर दें।

दो हिस्से (The two halves)

OpenSpec एक प्रोजेक्ट है जो दो भूमिकाएँ निभा रहा है।

CLI (टर्मिनल वाला हिस्सा)। यह openspec नामक एक प्रोग्राम है जिसे आप इंस्टॉल करते हैं और अपने शेल से चलाते हैं। यह आपके प्रोजेक्ट को सेट अप करता है, परिवर्तनों की सूची बनाता है और उन्हें मान्य करता है, एक डैशबोर्ड दिखाता है, और समाप्त किए गए काम को संग्रहीत (archive) करता है। आप इन्हें iTerm, VS Code टर्मिनल, PowerShell—जहाँ भी आप git या npm चलाते हैं—में टाइप करते हैं।

openspec init        # इस प्रोजेक्ट में OpenSpec सेट अप करें
openspec list        # सक्रिय परिवर्तनों को देखें
openspec view        # इंटरैक्टिव डैशबोर्ड खोलें

स्लैश कमांड (चैट वाला हिस्सा)। ये /opsx:propose और /opsx:apply जैसे छोटे कमांड हैं जिन्हें आप अपने AI असिस्टेंट में टाइप करते हैं। ये AI को OpenSpec वर्कफ़्लो का पालन करने के लिए कहते हैं: एक प्रस्ताव ड्राफ्ट करें, स्पेसिफिकेशन्स लिखें, कार्य सूची से निर्माण करें, काम पूरा होने पर संग्रहीत (archive) करें। आप इन्हें Claude Code, Cursor, Windsurf, Copilot, या जिस भी असिस्टेंट का उपयोग करते हैं, उसमें टाइप करते हैं।

/opsx:propose add-dark-mode    (अपने AI चैट में टाइप किया गया)
/opsx:apply                    (अपने AI चैट में टाइप किया गया)
/opsx:archive                  (अपने AI चैट में टाइप किया गया)

यहाँ एक तस्वीर में मानसिक मॉडल दिया गया है:

        आपका टर्मिनल                         आपके AI असिस्टेंट की चैट
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   कमांड इंस्टॉल करना    │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   │ कौशल (skills)   │  /opsx:archive                │
   └──────────────────────┘    &              └──────────────────────────────┘
        openspec को यहाँ चलाएं                       /opsx:* को यहाँ चलाएं

तीररे को ध्यान दें। अपने टर्मिनल में openspec init चलाना ही आपके AI टूल में स्लैश कमांड्स को इंस्टॉल करता है। टर्मिनल वाला हिस्सा चैट वाले हिस्से को सेट अप करता है। इसके बाद, दिन-प्रतिदिन का संचालन मुख्य रूप से चैट में होता है।

"मैं इंटरैक्टिव मोड कैसे शुरू करूँ?"

शुरू करने के लिए कोई अलग इंटरैक्टिव मोड नहीं है। यह सवाल अक्सर पूछा जाता है, इसलिए इसका एक सीधा जवाब होना चाहिए।

आप कोई विशेष OpenSpec मोड में प्रवेश नहीं करते हैं। आप बस अपने AI कोडिंग असिस्टेंट को वैसे ही खोलते हैं जैसे आप हमेशा करते थे, और चैट में एक स्लैश कमांड टाइप करते हैं। स्लैश कमांड ही वह तरीका है जिससे आप OpenSpec "में प्रवेश" करते हैं। आपका असिस्टेंट इसे पहचानता है, संबंधित OpenSpec स्किल लोड करता है, और वर्कफ़्लो का पालन करना शुरू कर देता है।

इसलिए वास्तविक निर्देश ये हैं:

1. अपने प्रोजेक्ट में अपना AI कोडिंग असिस्टेंट (Claude Code, Cursor, Windsurf, आदि) खोलें।
2. चैट में /opsx:propose टाइप करें, ठीक उसी जगह जहाँ आप कोई अन्य अनुरोध टाइप करते हैं।
3. ऑटोकम्प्लीट देखें: यदि OpenSpec इंस्टॉल है, तो आपको स्लैश टाइप करते समय /opsx:propose, /opsx:apply, और दोस्तों को दिखाई देगा।

बस इतना ही। टॉगल करने के लिए कोई मोड नहीं, लॉन्च करने के लिए कोई डेमॉन नहीं, कोई अलग विंडो नहीं।

एक चीज़ जो वास्तव में इंटरैक्टिव है वह टर्मिनल में रहती है: openspec view। यह आपके स्पेसिफिकेशन्स और परिवर्तनों को ब्राउज़ करने के लिए एक डैशबोर्ड खोलता है। लेकिन यह एक दर्शक (viewer) है, न कि वह चीज़ जिससे आप प्रस्ताव देते हैं और निर्माण करते हैं। निर्माण चैट में स्लैश कमांड्स के माध्यम से होता है।

यह विभाजन क्यों मौजूद है

यह समझना महत्वपूर्ण है, क्योंकि यह बताता है कि OpenSpec 25+ विभिन्न AI टूल के साथ कैसे काम करता है।

CLI इंजन है। यह नियमों को जानता है: एक परिवर्तन फ़ोल्डर कैसा दिखता है, कौन सी कलाकृतियाँ (artifacts) किस पर निर्भर करती हैं, सत्य स्रोत (source of truth) में एक डेल्टा स्पे को कैसे मर्ज किया जाए। यह हर जगह समान है।

स्लैश कमांड स्टीयरिंग व्हील हैं, और हर AI टूल का अपना थोड़ा अलग स्टीयरिंग व्हील होता है। Claude Code उन्हें कमांड कहता है। Cursor और Windsurf के पास अपने प्रारूप (formats) होते हैं। कुछ टूल उन्हें स्किल्स कहते हैं। जब आप openspec init चलाते हैं, तो OpenSpec आपके द्वारा चुने गए प्रत्येक टूल के लिए सही प्रकार की फ़ाइल उत्पन्न करता है, ताकि चाहे आप कोई भी असिस्टेंट पसंद करें, /opsx:propose इरादा काम करे।

इस डिज़ाइन की ताकत: आप वर्कफ़्लो को एक बार सीखते हैं और उसे विभिन्न टूल पर ले जाते हैं। ट्रेडऑफ: कमांड की सटीक सिंटैक्स (syntax) टूल के बीच थोड़ी भिन्न हो सकती है, जो अगले सेक्शन में है।

टूल द्वारा स्लैश कमांड सिंटैक्स

इरादा (intent) हर जगह समान है। विराम चिह्न (punctuation) अलग-अलग होते हैं। अपने असिस्टेंट से मेल खाने वाले प्रारूप का उपयोग करें।

Tool	How you type it
Claude Code	/opsx:propose, /opsx:apply
Cursor	/opsx-propose, /opsx-apply
Windsurf	/opsx-propose, /opsx-apply
GitHub Copilot (IDE)	/opsx-propose, /opsx-apply
Kimi CLI	skill-style, e.g. /skill:openspec-propose
Trae	skill-style, e.g. /openspec-propose

अधिकांश टूल या तो कोलन प्रारूप (/opsx:propose) का उपयोग करते हैं या डैश प्रारूप (/opsx-propose) का। कुछ टूल स्लैश कमांड के बजाय OpenSpec को नामित स्किल्स (named skills) के रूप में प्रदर्शित करते हैं; ऐसे मामलों में आप नाम से स्किल को कॉल करते हैं। प्रति-टूल की पूरी सूची, जिसमें यह भी शामिल है कि कौन सी फ़ाइलें कहाँ लिखी जाती हैं, Supported Tools पर उपलब्ध है।

यदि संदेह हो, तो अपने AI चैट में एक स्लैश टाइप करें और ऑटोकम्प्लीट देखें। आपका टूल आपको वह प्रारूप दिखाएगा जिसकी उसे उम्मीद है।

कमांड वहाँ कैसे पहुँचे: स्किल्स और कमांड्स

जब आप openspec init (या openspec update) चलाते हैं, तो OpenSpec आपके प्रोजेक्ट में छोटी फ़ाइलें लिखता है ताकि आपका AI टूल वर्कफ़्लो को ढूंढ सके। आपके टूल और सेटिंग्स के आधार पर, ये स्किल्स, कमांड्स, या दोनों हो सकते हैं।

• स्किल्स .claude/skills/openspec-*/SKILL.md जैसी जगहों पर रहते हैं। वे क्रॉस-टूल मानक (cross-tool standard) हैं: एक निर्देश फ़ोल्डर जिसे आपका असिस्टेंट स्वतः पहचानता है।
• कमांड्स .claude/commands/opsx/<id>.md जैसी जगहों पर रहते हैं। ये पुराने प्रति-टूल स्लैश कमांड फ़ाइलें हैं।

आपको यह जानने की ज़रूरत नहीं है कि आपका टूल किसका उपयोग करता है। आप बस स्लैश कमांड टाइप करते हैं और यह काम कर जाता है। लेकिन इन फ़ाइलों के अस्तित्व को जानना तब मदद करता है जब कुछ गलत हो जाता है: यदि आपके कमांड गायब हो जाते हैं, तो इसका मतलब आमतौर पर है कि ये फ़ाइलें गुम हैं या पुरानी (stale) हैं, और openspec update उन्हें पुनर्जीवित (regenerates) कर देता है।

प्रति-टूल के सटीक पथों के लिए Supported Tools देखें, और स्किल्स ने पुराने कमांड-ओनली दृष्टिकोण को कैसे प्रतिस्थापित किया, इसके लिए Migration Guide देखें।

पुष्टि करना कि यह इंस्टॉल है

त्वरित जाँचें, सबसे पहले ये करें:

1. अपने AI चैट में एक स्लैश टाइप करें। /opsx टाइप करना शुरू करें और ऑटोकम्प्लीट सुझावों के लिए देखें। यदि वे दिखाई देते हैं, तो आप तैयार हैं।
2. फ़ाइलों को देखें। Claude Code के लिए, जाँच करें कि .claude/skills/ में openspec-* फ़ोल्डर हैं। अन्य टूल अपने स्वयं के निर्देशिका (directories) का उपयोग करते हैं (Supported Tools उन्हें सूचीबद्ध करता है)।
3. सेटअप को फिर से चलाएं। अपने प्रोजेक्ट रूट से, openspec update चलाएँ। यह आपके द्वारा कॉन्फ़िगर किए गए टूलों के लिए स्किल और कमांड फ़ाइलों को पुनर्जीवित करता है।
4. अपने असिस्टेंट को रीस्टार्ट करें। कई टूल स्टार्टअप पर स्किल्स और कमांड्स को स्कैन करते हैं, इसलिए एक ताज़ा विंडो आवश्यक कदम हो सकता है।

मेरे पास कौन से कमांड हैं?

डिफ़ॉल्ट रूप से, OpenSpec स्लैश कमांड का कोर सेट इंस्टॉल करता है:

• /opsx:explore: किसी बदलाव के लिए प्रतिबद्ध होने से पहले AI के साथ एक विचार पर विचार करें (जब आप अनिश्चित हों तो यह एक बेहतरीन पहला कदम है)
• /opsx:propose: एक परिवर्तन बनाएं और इसके सभी योजना कलाकृतियों (planning artifacts) का ड्राफ्ट एक ही चरण में तैयार करें
• /opsx:apply: इसकी कार्य सूची से काम करके बदलाव को निर्मित करें
• /opsx:sync: आपके मुख्य स्पेसिफिकेशन्स में किसी परिवर्तन के स्पे अपडेट्स को मर्ज करें (आमतौर पर स्वचालित होता है)
• /opsx:archive: एक परिवर्तन को समाप्त करें और उसे फ़ाइल कर दें

एक अच्छी डिफ़ॉल्ट लय: जब आप यह पता कर रहे हों कि क्या करना है, तब explore, फिर propose, apply, archive। Explore First गाइड बताता है कि वह शुरुआती कदम क्यों फायदेमंद है।

उन लोगों के लिए एक विस्तारित सेट भी है जो अधिक बारीक नियंत्रण चाहते हैं (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard)। आप इसे openspec config profile से चालू करते हैं, फिर openspec update के साथ लागू करते हैं।

क्या आप इन सब में नए हैं? /opsx:onboard (विस्तारित सेट में) आपको अपनी स्वयं की कोडबेस पर एक पूर्ण परिवर्तन के माध्यम से मार्गदर्शन करता है, हर कदम का वर्णन करता है। यह सबसे मित्रवत परिचय है।

प्रत्येक कमांड क्या करता है इसका विस्तृत विवरण के लिए, Commands देखें। कब किसका उपयोग करना है, इसके लिए Workflows देखें।

एक साफ़ पहली रन (A clean first run)

इसे एक साथ रखते हुए, यहाँ वह पूरी अनुक्रम (sequence) है जिसमें हर चरण को यह लेबल दिया गया है कि यह कहाँ होता है।

TERMINAL   $ npm install -g @fission-ai/openspec@latest
TERMINAL   $ cd your-project
TERMINAL   $ openspec init
              (आपके AI टूल में स्लैश कमांड इंस्टॉल करता है)

AI CHAT      /opsx:explore
              (वैकल्पिक: पहले AI के साथ विचार पर विचार करें)

AI CHAT      /opsx:propose add-dark-mode
              (AI प्रस्ताव, स्पेसिफिकेशन्स, डिज़ाइन और कार्य तैयार करता है)

AI CHAT      /opsx:apply
              (AI इसे बनाता है, कार्यों को चिह्नित करते हुए)

AI CHAT      /opsx:archive
              (परिवर्तन आपके स्पेसिफिकेशन्स में मर्ज हो जाता है और फ़ाइल कर दिया जाता है)

सेटअप के लिए दो टर्मिनल चरण। फिर आप चैट में रहते हैं। यही लय है।

संबंधित (Related)

• Getting Started: पूर्ण पहली परिवर्तन walkthrough
• Commands: हर स्लैश कमांड का विवरण
• CLI: हर टर्मिनल कमांड का विवरण
• Supported Tools: प्रति-टूल सिंटैक्स और फ़ाइल स्थान
• FAQ: अधिक त्वरित उत्तर
• Troubleshooting: जब कमांड दिखाई न दें तो सुधार