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

जानने वाली एक ही बात: 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, Devin Desktop, 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, Devin Desktop, आदि) को खोलें।
2. अपनी चैट में /opsx:propose टाइप करें, उसी जगह जहाँ आप कोई अन्य अनुरोध टाइप करते हैं।
3. ऑटोकम्पलीट को देखें: यदि OpenSpec इंस्टॉल है, तो आपको /opsx:propose, /opsx:apply, और अन्य कमांड्स दिखाई देंगे जैसे ही आप स्लैश टाइप करेंगे।

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

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

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

इसे समझना उपयोगी है, क्योंकि यह समझाता है कि OpenSpec 30+ विभिन्न AI टूल्स के साथ कैसे काम करता है।

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

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

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

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

इंटेंट हर जगह समान है। स्पेलिंग उस फाइल का पालन करती है जिसे आपका टूल लोड करता है।

आपके टूल की कमांड फाइल	आप इसे कैसे टाइप करते हैं	उदाहरण टूल्स
.../commands/opsx/<id>.*	/opsx:propose	Claude Code, Gemini CLI, Crush
.../opsx-<id>.*	/opsx-propose	Cursor, GitHub Copilot (IDE), Devin Desktop, Trae, Oh My Pi
.amazonq/prompts/opsx-<id>.md	@opsx-propose	Amazon Q Developer
none — skills only	/openspec-propose	CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, shared .agents
none — Kimi Code	/skill:openspec-propose	Kimi Code
none — Codex CLI	$openspec-propose	Codex

Devin एकमात्र टूल है जो दो पंक्तियों में फैला है। Devin Desktop .devin/workflows/ पढ़ता है, इसलिए /opsx-propose वहां काम करता है; Devin Local ऐसा नहीं करता, इसलिए उस एजेंट पर openspec-propose स्किल का उपयोग करें। स्किल्स जिन्हें OpenSpec .devin/skills/ में लिखता है दोनों पर काम करते हैं, इसलिए वे एक-दूसरे को स्किल नाम से संदर्भित करते हैं।

हर टूल को How To Invoke में सूचीबद्ध किया गया है — वह टेबल प्राधिकृत है। दो पंक्तियाँ स्लैश कमांड्स नहीं हैं: Amazon Q अपनी फाइलों को @ के साथ बुलाए जाने वाले एक प्रॉम्प्ट लाइब्रेरी में लोड करता है, और पिछली तीन पंक्तियाँ स्किल नाम का उपयोग करती हैं, जो कमांड आईडी नहीं है (/opsx:apply openspec-apply-change स्किल है)।

संदेह होने पर, openspec init द्वारा प्रिंट किए गए "Getting started" लाइन को पढ़ें: यह पहले से ही आपके टूल्स द्वारा रजिस्टर किए गए रूप का उपयोग करता है। स्लैश टाइप करना और ऑटोकम्पलीट देखना भी काम करता है, उन टूल्स के लिए जो स्लैश कमांड्स को दिखाते हैं।

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

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

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

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

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

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

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

1. अपनी AI चैट में स्लैश टाइप करें। /opsx टाइप करना शुरू करें और ऑटोकम्पलीट सुझावों के लिए देखें। यदि वे दिखाई देते हैं, तो आप तैयार हैं। केवल-स्किल्स वाले टूल (Codex, Kimi Code, CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, या साझा .agents टार्गेट) पर /opsx कभी पूर्ण नहीं होता, यहां तक कि एक स्वस्थ इंस्टॉल पर भी — ऊपर दी गई टेबल से स्किल नाम आज़माएं।
2. फाइलों के लिए देखें। Claude Code के लिए, जांचें कि .claude/skills/ में openspec-* फोल्डर्स हैं। अन्य टूल्स अपने स्वयं के निर्देशिकाओं का उपयोग करते हैं (Supported Tools उन्हें सूचीबद्ध करता है)।
3. सेटअप को फिर से चलाएं। अपने प्रोजेक्ट रूट से, openspec update चलाएं। यह आपके द्वारा कॉन्फ़िगर किए गए किसी भी टूल के लिए स्किल और कमांड फाइलों को फिर से जनरेट करता है।
4. अपने असिस्टेंट को रीस्टार्ट करें। कई टूल्स स्किल्स और कमांड्स के लिए स्टार्टअप पर स्कैन करते हैं, इसलिए एक ताजी विंडो कमी वाला कदम हो सकता है।

मुझे वास्तव में कौन से कमांड मिले हैं?

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

• /opsx:explore: किसी परिवर्तन के प्रति प्रतिबद्ध होने से पहले AI के साथ एक विचार पर विचार करें (जब आप अनिश्चित हों तो यह एक अच्छा पहला कदम है)
• /opsx:propose: एक परिवर्तन बनाएं और एक ही चरण में सभी उसके योजना आर्टिफैक्ट्स ड्राफ्ट करें
• /opsx:apply: अपने टास्क लिस्ट के माध्यम से काम करके परिवर्तन बनाएं
• /opsx:update: एक परिवर्तन के योजना आर्टिफैक्ट्स को संशोधित करें और उन्हें सहसंबद्ध रखें
• /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 देखें।

एक स्वच्छ पहली रन

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

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
              (परिवर्तन आपके स्पेस में मर्ज हो जाता है और फाइल हो जाता है)

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

संबंधित

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