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

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

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

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

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

दो हिस्से

OpenSpec एक ही प्रोजेक्ट है जो दो रूपों में काम करता है।

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

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

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

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

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

        YOUR TERMINAL                         YOUR AI ASSISTANT'S CHAT
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   installs    │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   commands    │  /opsx:archive                │
   └──────────────────────┘    & skills   └──────────────────────────────┘
        run openspec here                       run /opsx:* here

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

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

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

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

अतः वास्तविक निर्देश ये हैं:

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

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

टर्मिनल में वही एक चीज है जो वास्तव में इंटरैक्टिव है: openspec view। यह आपके स्पेक और परिवर्तनों को ब्राउज़ करने के लिए एक डैशबोर्ड खोलता है। लेकिन यह एक व्यूअर है, वह चीज नहीं जिसके साथ आप प्रस्ताव तैयार करते और बिल्ड करते हैं। बिल्डिंग चैट में स्लैश कमांड के माध्यम से होती है।

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

इसे समझने लायक है, क्योंकि यह समझाता है कि OpenSpec 25+ अलग-अलग AI टूल्स के साथ कैसे काम करता है।

CLI इंजन है। यह नियमों को जानता है: परिवर्तन फोल्डर कैसा दिखता है, कौन से आर्टिफैक्ट किस पर निर्भर करते हैं, डेल्टा स्पेक को आपके वास्तविक स्रोत में कैसे मर्ज किया जाता है। यह हर जगह समान है।

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

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

टूल के अनुसार स्लैश कमांड सिंटैक्स

इंटेंट हर जगह समान है। विराम चिन्ह अलग होता है। अपने सहायक से मेल खाते फॉर्म का उपयोग करें।

टूल	आप इसे कैसे टाइप करेंगे
Claude Code	/opsx:propose, /opsx:apply
Cursor	/opsx-propose, /opsx-apply
Windsurf	/opsx-propose, /opsx-apply
GitHub Copilot (IDE)	/opsx-propose, /opsx-apply
CodeArts	स्किल-स्टाइल, जैसे /openspec-propose
Codex	.codex/skills/openspec-* के माध्यम से स्किल-स्टाइल
Oh My Pi	/opsx-propose, /opsx-apply
Kimi CLI	स्किल-स्टाइल, जैसे /skill:openspec-propose
Trae	/opsx-propose, /opsx-apply

ज्यादातर टूल्स कोलन फॉर्म (/opsx:propose) या डैश फॉर्म (/opsx-propose) में से किसी एक का उपयोग करते हैं। कुछ टूल्स स्लैश कमांड के बजाय नामित स्किल के रूप में OpenSpec प्रदर्शित करते हैं; इनके लिए आप स्किल को उसके नाम से इनवोक करते हैं। किस फाइल को कहां लिखा जाता है, इस सहित पूरा टूलवार लिस्ट समर्थित टूल्स में मौजूद है।

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

कमांड कहां से आए: स्किल और कमांड

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

• स्किल .claude/skills/openspec-*/SKILL.md जैसी जगहों पर होते हैं। ये उभरती हुई क्रॉस-टूल स्टैंडर्ड हैं: एक फोल्डर जिसमें निर्देश होते हैं और आपका सहायक इन्हें ऑटो-डिटेक्ट करता है।
• कमांड .claude/commands/opsx/<id>.md जैसी जगहों पर होते हैं। ये पुराने प्रति-टूल स्लैश कमांड फाइलें हैं। Codex को जनरेट किए गए कमांड फाइलें नहीं मिलती हैं; .codex/skills/openspec-* का उपयोग करें।

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

प्रत्येक टूल के लिए सटीक पथ के लिए समर्थित टूल्स देखें, और स्किल ने पुराने केवल कमांड वाले दृष्टिकोण को कैसे बदल दिया है, इसके लिए माइग्रेशन गाइड देखें।

इंस्टॉलेशन की पुष्टि करना

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

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

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

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

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

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

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

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

प्रत्येक कमांड की विस्तृत विशेषताओं के लिए कमांड देखें, किस कमांड को कब उपयोग करें इसके लिए वर्कफ़्लो देखें।

एक साफ पहला रन

इसे एक साथ रखते हुए, यहां पूरा सीक्वेंस दिया गया है जिसमें हर कदम को उसके होने वाले स्थान के साथ लेबल किया गया है:

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

AI चैट      /opsx:explore
              (वैकल्पिक: पहले AI के साथ आइडिया को सोचें)

AI चैट      /opsx:propose add-dark-mode
              (AI प्रस्ताव, स्पेक, डिजाइन, टास्क का मसौदा तैयार करता है)

AI चैट      /opsx:apply
              (AI टास्क चेक करते हुए इसे बिल्ड करता है)

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

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

संबंधित

• शुरुआत करें: पहले परिवर्तन का पूरा वॉकथ्रू
• कमांड: हर स्लैश कमांड की विस्तृत जानकारी
• CLI: हर टर्मिनल कमांड की विस्तृत जानकारी
• समर्थित टूल्स: टूल के अनुसार सिंटैक्स और फाइल स्थान
• FAQ: अधिक त्वरित जवाब
• समस्या निवारण: जब कमांड दिखाई नहीं देते तो समाधान