Skip to content

कमांड्स

यह OpenSpec के स्लैश कमांड्स का संदर्भ है। इन कमांड्स को आपके AI कोडिंग असिस्टेंट के चैट इंटरफेस (जैसे, Claude Code, Cursor, Windsurf) में बुलाया जाता है।

वर्कफ़्लो पैटर्न्स और प्रत्येक कमांड का उपयोग कब करना है, इसके लिए वर्कफ़्लोज़ देखें। CLI कमांड्स के लिए, CLI देखें।

त्वरित संदर्भ

डिफ़ॉल्ट त्वरित पाथ (core प्रोफ़ाइल)

कमांडउद्देश्य
/opsx:proposeएक बदलाव बनाएं और एक ही कदम में प्लानिंग आर्टिफ़ैक्ट्स जनरेट करें
/opsx:exploreकिसी बदलाव के लिए प्रतिबद्ध होने से पहले विचारों पर विचार करें
/opsx:applyबदलाव से कार्यों को लागू करें
/opsx:archiveएक पूर्ण बदलाव को आर्काइव करें

विस्तारित वर्कफ़्लो कमांड्स (कस्टम वर्कफ़्लो चयन)

कमांडउद्देश्य
/opsx:newएक नया बदलाव स्कैफ़ोल्ड शुरू करें
/opsx:continueनिर्भरताओं के आधार पर अगला आर्टिफ़ैक्ट बनाएं
/opsx:ffफ़ास्ट-फ़ॉरवर्ड: सभी प्लानिंग आर्टिफ़ैक्ट्स एक साथ बनाएं
/opsx:verifyसत्यापित करें कि कार्यान्वयन आर्टिफ़ैक्ट्स से मेल खाता है
/opsx:syncडेल्टा स्पेक्स को मुख्य स्पेक्स में मर्ज करें
/opsx:bulk-archiveएक साथ कई बदलावों को आर्काइव करें
/opsx:onboardपूर्ण वर्कफ़्लो के माध्यम से गाइडेड ट्यूटोरियल

डिफ़ॉल्ट ग्लोबल प्रोफ़ाइल core है। विस्तारित वर्कफ़्लो कमांड्स सक्षम करने के लिए, openspec config profile चलाएं, वर्कफ़्लोज़ चुनें, फिर अपने प्रोजेक्ट में openspec update चलाएं।


कमांड संदर्भ

/opsx:propose

एक नया परिवर्तन बनाएं और एक ही कदम में योजना कलाकृतियाँ उत्पन्न करें। यह core प्रोफ़ाइल में डिफ़ॉल्ट प्रारंभ कमांड है।

सिंटैक्स:

text
/opsx:propose [change-name-or-description]

तर्क:

तर्कआवश्यकविवरण
change-name-or-descriptionनहींकेबाब-केस नाम या सामान्य भाषा में परिवर्तन विवरण

यह क्या करता है:

  • openspec/changes/<change-name>/ बनाता है
  • कार्यान्वयन से पहले आवश्यक कलाकृतियाँ उत्पन्न करता है (spec-driven के लिए: प्रस्ताव, स्पेक्स, डिज़ाइन, कार्य)
  • परिवर्तन /opsx:apply के लिए तैयार होने पर रुक जाता है

उदाहरण:

text
You: /opsx:propose add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md
     ✓ specs/ui/spec.md
     ✓ design.md
     ✓ tasks.md
     Ready for implementation. Run /opsx:apply.

सुझाव:

  • सबसे तेज़ एंड-टू-एंड पथ के लिए इसका उपयोग करें
  • यदि आप चरण-दर-चरण कलाकृति नियंत्रण चाहते हैं, तो विस्तारित वर्कफ़्लो सक्षम करें और /opsx:new + /opsx:continue का उपयोग करें

/opsx:explore

परिवर्तन के लिए प्रतिबद्ध होने से पहले विचारों पर विचार करें, समस्याओं की जांच करें और आवश्यकताओं को स्पष्ट करें।

सिंटैक्स:

/opsx:explore [topic]

तर्क:

तर्कआवश्यकविवरण
topicनहींआप क्या खोजना या जांचना चाहते हैं

यह क्या करता है:

  • बिना किसी संरचना की आवश्यकता के एक खोजपूर्ण बातचीत खोलता है
  • प्रश्नों का उत्तर देने के लिए कोडबेस की जांच करता है
  • विकल्पों और दृष्टिकोणों की तुलना करता है
  • सोच को स्पष्ट करने के लिए दृश्य आरेख बनाता है
  • जब अंतर्दृष्टि स्पष्ट हो जाती है, तो /opsx:propose (डिफ़ॉल्ट) या /opsx:new (विस्तारित वर्कफ़्लो) में संक्रमण कर सकता है

उदाहरण:

text
You: /opsx:explore

AI:  What would you like to explore?

You: How should we handle authentication for the mobile app?

AI:  Let me investigate your current auth setup...
     [Analyzes codebase]

     I see you're using session-based auth for the web app.
     For mobile, we have three main options:

     1. JWT tokens (stateless, works offline)
     2. OAuth2 (if you need third-party login)
     3. Extend current sessions (simpler, but requires connectivity)

     Your API already has CORS configured. Which direction interests you?

You: Let's go with JWT. Can we start a change for that?

AI:  Ready when you are. Run /opsx:propose add-jwt-auth to begin.

सुझाव:

  • जब आवश्यकताएँ अस्पष्ट हों या आपको जांच करने की आवश्यकता हो तो इसका उपयोग करें
  • खोज के दौरान कोई कलाकृतियाँ नहीं बनाई जाती हैं
  • निर्णय लेने से पहले कई दृष्टिकोणों की तुलना के लिए अच्छा है
  • फ़ाइलें पढ़ सकता है और कोडबेस खोज सकता है

/opsx:new

एक नया परिवर्तन स्कैफ़ोल्ड शुरू करें। परिवर्तन फ़ोल्डर बनाता है और /opsx:continue या /opsx:ff के साथ कलाकृतियाँ उत्पन्न करने की प्रतीक्षा करता है।

यह कमांड विस्तारित वर्कफ़्लो सेट का हिस्सा है (डिफ़ॉल्ट core प्रोफ़ाइल में शामिल नहीं है)।

सिंटैक्स:

/opsx:new [change-name] [--schema <schema-name>]

तर्क:

तर्कआवश्यकविवरण
change-nameनहींपरिवर्तन फ़ोल्डर के लिए नाम (यदि प्रदान नहीं किया गया है तो प्रॉम्प्ट किया जाता है)
--schemaनहींउपयोग करने के लिए वर्कफ़्लो स्कीमा (डिफ़ॉल्ट: कॉन्फ़िग या spec-driven से)

यह क्या करता है:

  • openspec/changes/<change-name>/ निर्देशिका बनाता है
  • परिवर्तन फ़ोल्डर में .openspec.yaml मेटाडेटा फ़ाइल बनाता है
  • बनाने के लिए तैयार पहली कलाकृति टेम्पलेट दिखाता है
  • यदि प्रदान नहीं किया गया है तो परिवर्तन नाम और स्कीमा के लिए प्रॉम्प्ट करता है

यह क्या बनाता है:

openspec/changes/<change-name>/
└── .openspec.yaml    # परिवर्तन मेटाडेटा (स्कीमा, निर्माण तिथि)

उदाहरण:

You: /opsx:new add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     Schema: spec-driven

     Ready to create: proposal
     Use /opsx:continue to create it, or /opsx:ff to create all artifacts.

सुझाव:

  • वर्णनात्मक नामों का उपयोग करें: add-feature, fix-bug, refactor-module
  • सामान्य नामों से बचें जैसे update, changes, wip
  • स्कीमा को प्रोजेक्ट कॉन्फ़िग (openspec/config.yaml) में भी सेट किया जा सकता है

/opsx:continue

निर्भरता श्रृंखला में अगली कलाकृति बनाएं। वृद्धिशील प्रगति के लिए एक समय में एक कलाकृति बनाता है।

सिंटैक्स:

/opsx:continue [change-name]

तर्क:

तर्कआवश्यकविवरण
change-nameनहींकौन सा परिवर्तन जारी रखना है (यदि प्रदान नहीं किया गया है तो संदर्भ से अनुमानित)

यह क्या करता है:

  • कलाकृति निर्भरता ग्राफ़ को क्वेरी करता है
  • दिखाता है कि कौन सी कलाकृतियाँ तैयार हैं बनाम अवरुद्ध
  • पहली तैयार कलाकृति बनाता है
  • संदर्भ के लिए निर्भरता फ़ाइलें पढ़ता है
  • बनाने के बाद क्या उपलब्ध होता है दिखाता है

उदाहरण:

You: /opsx:continue

AI:  Change: add-dark-mode

     Artifact status:
     ✓ proposal    (done)
     ◆ specs       (ready)
     ◆ design      (ready)
     ○ tasks       (blocked - needs: specs)

     Creating specs...

     [Reads proposal.md, creates specs based on requirements]

     ✓ Created openspec/changes/add-dark-mode/specs/ui/spec.md

     Now available: tasks
     Run /opsx:continue to create the next artifact.

सुझाव:

  • जब आप आगे बढ़ने से पहले प्रत्येक कलाकृति की समीक्षा करना चाहते हैं तो इसका उपयोग करें
  • जटिल परिवर्तनों के लिए अच्छा है जहाँ आप नियंत्रण चाहते हैं
  • कई कलाकृतियाँ एक साथ तैयार हो सकती हैं
  • आप जारी रखने से पहले बनाई गई कलाकृतियों को संपादित कर सकते हैं

/opsx:ff

कलाकृति निर्माण के माध्यम से फ़ास्ट-फ़ॉरवर्ड करें। सभी योजना कलाकृतियाँ एक साथ बनाता है।

सिंटैक्स:

/opsx:ff [change-name]

तर्क:

तर्कआवश्यकविवरण
change-nameनहींकौन सा परिवर्तन फ़ास्ट-फ़ॉरवर्ड करना है (यदि प्रदान नहीं किया गया है तो संदर्भ से अनुमानित)

यह क्या करता है:

  • निर्भरता क्रम में सभी कलाकृतियाँ बनाता है
  • टू-डू सूची के माध्यम से प्रगति ट्रैक करता है
  • जब सभी apply-required कलाकृतियाँ पूरी हो जाती हैं तो रुक जाता है
  • अगली कलाकृति बनाने से पहले प्रत्येक निर्भरता पढ़ता है

उदाहरण:

You: /opsx:ff add-dark-mode

AI:  Fast-forwarding add-dark-mode...

     ✓ Creating proposal.md
     ✓ Creating specs/ui/spec.md
     ✓ Creating design.md
     ✓ Creating tasks.md

     All planning artifacts complete!
     Ready for implementation. Run /opsx:apply to begin.

सुझाव:

  • जब आपको स्पष्ट चित्र हो कि आप क्या बना रहे हैं तो इसका उपयोग करें
  • सरल परिवर्तनों के लिए /opsx:continue से तेज़
  • आप बाद में भी कलाकृतियों को संपादित कर सकते हैं
  • छोटे से मध्यम सुविधाओं के लिए अच्छा है

/opsx:apply

परिवर्तन से कार्यों को लागू करें। कार्य सूची के माध्यम से काम करता है, कोड लिखता है और आइटमों को चेक करता है।

सिंटैक्स:

/opsx:apply [change-name]

तर्क:

तर्कआवश्यकविवरण
change-nameनहींकौन सा परिवर्तन लागू करना है (यदि प्रदान नहीं किया गया है तो संदर्भ से अनुमानित)

यह क्या करता है:

  • tasks.md पढ़ता है और अपूर्ण कार्यों की पहचान करता है
  • कार्यों को एक-एक करके पूरा करता है
  • आवश्यकतानुसार कोड लिखता है, फ़ाइलें बनाता है, परीक्षण चलाता है
  • चेकबॉक्स [x] के साथ कार्यों को पूर्ण चिह्नित करता है

उदाहरण:

You: /opsx:apply

AI:  Implementing add-dark-mode...

     Reading tasks.md:
     - [ ] 1.1 Create ThemeContext
     - [ ] 1.2 Add CSS custom properties
     - [ ] 1.3 Implement localStorage persistence

     Working on 1.1: Create ThemeContext...
     [Creates src/context/ThemeContext.tsx]

     ✓ 1.1 Complete

     Working on 1.2: Add CSS custom properties...
     [Updates src/styles/globals.css]

     ✓ 1.2 Complete
     ...

सुझाव:

  • यदि बाधित हो जाए तो जहाँ छोड़ा था वहाँ से फिर शुरू कर सकते हैं
  • परिवर्तन नाम निर्दिष्ट करके समानांतर परिवर्तनों के लिए उपयोग करें
  • पूर्णता स्थिति tasks.md चेकबॉक्स में ट्रैक की जाती है

/opsx:verify

सत्यापित करें कि कार्यान्वयन आपकी परिवर्तन कलाकृतियों से मेल खाता है। पूर्णता, सुधार और सामंजस्य की जांच करता है।

सिंटैक्स:

/opsx:verify [change-name]

तर्क:

तर्कआवश्यकविवरण
change-nameनहींकौन सा परिवर्तन सत्यापित करना है (यदि प्रदान नहीं किया गया है तो संदर्भ से अनुमानित)

यह क्या करता है:

  • कार्यान्वयन गुणवत्ता के तीन आयामों की जांच करता है
  • कार्यान्वयन प्रमाण के लिए कोडबेस खोजता है
  • CRITICAL, WARNING या SUGGESTION के रूप में वर्गीकृत समस्याओं की रिपोर्ट करता है
  • संग्रह को अवरुद्ध नहीं करता है, लेकिन समस्याओं को उजागर करता है

सत्यापन आयाम:

आयामयह क्या मान्य करता है
पूर्णतासभी कार्य पूरे, सभी आवश्यकताएँ लागू, परिदृश्य कवर
सुधारकार्यान्वयन स्पेक इरादे से मेल खाता है, किनारे के मामले संभाले गए
सामंजस्यडिज़ाइन निर्णय कोड में प्रतिबिंबित, पैटर्न सुसंगत

उदाहरण:

You: /opsx:verify

AI:  Verifying add-dark-mode...

     COMPLETENESS
     ✓ All 8 tasks in tasks.md are checked
     ✓ All requirements in specs have corresponding code
     ⚠ Scenario "System preference detection" has no test coverage

     CORRECTNESS
     ✓ Implementation matches spec intent
     ✓ Edge cases from scenarios are handled
     ✓ Error states match spec definitions

     COHERENCE
     ✓ Design decisions reflected in code structure
     ✓ Naming conventions consistent with design.md
     ⚠ Design mentions "CSS variables" but implementation uses Tailwind classes

     SUMMARY
     ─────────────────────────────
     Critical issues: 0
     Warnings: 2
     Ready to archive: Yes (with warnings)

     Recommendations:
     1. Add test for system preference detection
     2. Update design.md to reflect Tailwind usage, or refactor to use CSS variables

सुझाव:

  • संग्रह से पहले गलतफहमियों को पकड़ने के लिए चलाएं
  • चेतावनियाँ संग्रह को अवरुद्ध नहीं करती हैं लेकिन संभावित समस्याओं का संकेत देती हैं
  • प्रतिबद्ध होने से पहले AI के काम की समीक्षा के लिए अच्छा है
  • कलाकृतियों और कार्यान्वयन के बीच ड्रिफ्ट प्रकट कर सकता है

/opsx:sync

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

सिंटैक्स:

/opsx:sync [change-name]

तर्क:

तर्कआवश्यकविवरण
change-nameनहींकौन सा परिवर्तन सिंक करना है (यदि प्रदान नहीं किया गया है तो संदर्भ से अनुमानित)

यह क्या करता है:

  • परिवर्तन फ़ोल्डर से डेल्टा स्पेक्स पढ़ता है
  • ADDED/MODIFIED/REMOVED/RENAMED अनुभागों को पार्स करता है
  • परिवर्तनों को मुख्य openspec/specs/ निर्देशिका में मर्ज करता है
  • डेल्टा में उल्लिखित नहीं मौजूदा सामग्री को संरक्षित करता है
  • परिवर्तन को संग्रह नहीं करता है (सक्रिय रहता है)

उदाहरण:

text
You: /opsx:sync

AI:  Syncing add-dark-mode delta specs...

     Reading: openspec/changes/add-dark-mode/specs/ui/spec.md
     Target:  openspec/specs/ui/spec.md

     Changes to apply:
     ✓ ADDED: Theme Selection requirement (2 scenarios)
     ✓ ADDED: Accessibility requirement (1 scenario)

     Merging...
     ✓ openspec/specs/ui/spec.md updated

     Change remains active. Run /opsx:archive when ready to complete.

मैन्युअल रूप से कब उपयोग करें:

परिदृश्यsync का उपयोग करें?
लंबे समय तक चलने वाला परिवर्तन, संग्रह से पहले मुख्य में स्पेक्स चाहते हैंहाँ
कई समानांतर परिवर्तनों को अद्यतन आधार स्पेक्स की आवश्यकता हैहाँ
मर्ज को अलग से पूर्वावलोकन/समीक्षा करना चाहते हैंहाँ
त्वरित परिवर्तन, सीधे संग्रह की ओर जा रहे हैंनहीं (संग्रह इसे संभालता है)

सुझाव:

  • सिंक बुद्धिमान है, कॉपी-पेस्ट नहीं
  • दोहराव के बिना मौजूदा आवश्यकताओं में परिदृश्य जोड़ सकता है
  • सिंक के बाद परिवर्तन सक्रिय रहता है (संग्रह नहीं)
  • अधिकांश उपयोगकर्ताओं को कभी भी इसे सीधे कॉल करने की आवश्यकता नहीं होगी—संग्रह यदि आवश्यक हो तो प्रॉम्प्ट करता है

/opsx:archive

एक पूर्ण परिवर्तन को संग्रहित करें। परिवर्तन को अंतिम रूप देता है और इसे संग्रह फ़ोल्डर में ले जाता है।

सिंटैक्स:

/opsx:archive [change-name]

तर्क:

तर्कआवश्यकविवरण
change-nameनहींकौन सा परिवर्तन संग्रहित करना है (यदि प्रदान नहीं किया गया है तो संदर्भ से अनुमानित)

यह क्या करता है:

  • कलाकृति पूर्णता स्थिति की जांच करता है
  • कार्य पूर्णता की जांच करता है (अपूर्ण होने पर चेतावनी देता है)
  • यदि पहले से सिंक नहीं किया गया है तो डेल्टा स्पेक्स सिंक करने की पेशकश करता है
  • परिवर्तन फ़ोल्डर को openspec/changes/archive/YYYY-MM-DD-<name>/ में ले जाता है
  • ऑडिट ट्रेल के लिए सभी कलाकृतियों को संरक्षित करता है

उदाहरण:

text
You: /opsx:archive

AI:  Archiving add-dark-mode...

     Artifact status:
     ✓ proposal.md exists
     ✓ specs/ exists
     ✓ design.md exists
     ✓ tasks.md exists (8/8 tasks complete)

     Delta specs: Not yet synced
     → Sync now? (recommended)

You: Yes

AI:  ✓ Synced specs to openspec/specs/ui/spec.md
     ✓ Moved to openspec/changes/archive/2025-01-24-add-dark-mode/

     Change archived successfully.

सुझाव:

  • संग्रह अपूर्ण कार्यों को अवरुद्ध नहीं करेगा, लेकिन चेतावनी देगा
  • डेल्टा स्पेक्स को संग्रह के दौरान या पहले सिंक किया जा सकता है
  • संग्रहित परिवर्तन इतिहास के लिए संरक्षित हैं
  • समस्याओं को पकड़ने के लिए पहले /opsx:verify का उपयोग करें

/opsx:bulk-archive

एक साथ कई पूर्ण परिवर्तनों को संग्रहित करें। परिवर्तनों के बीच स्पेक टकराव को संभालता है।

सिंटैक्स:

/opsx:bulk-archive [change-names...]

तर्क:

तर्कआवश्यकविवरण
change-namesनहींसंग्रहित करने के लिए विशिष्ट परिवर्तन (यदि प्रदान नहीं किया गया है तो चयन के लिए प्रॉम्प्ट करता है)

यह क्या करता है:

  • सभी पूर्ण परिवर्तनों को सूचीबद्ध करता है
  • संग्रह से पहले प्रत्येक परिवर्तन को मान्य करता है
  • परिवर्तनों में स्पेक टकराव का पता लगाता है
  • वास्तव में क्या लागू किया गया है यह जांचकर टकराव को हल करता है
  • कालानुक्रमिक क्रम में संग्रहित करता है

उदाहरण:

You: /opsx:bulk-archive

AI:  Found 3 completed changes:
     - add-dark-mode (8/8 tasks complete)
     - fix-login-bug (3/3 tasks complete)
     - update-footer (2/2 tasks complete)

     Checking for spec conflicts...
     ⚠ add-dark-mode and update-footer both touch specs/ui/

     Inspecting codebase to resolve...
     Both changes are implemented. Will merge in chronological order:
     1. add-dark-mode (created Jan 20)
     2. update-footer (created Jan 22)

     Archive all 3 changes?

You: Yes

AI:  ✓ Archived add-dark-mode
     ✓ Archived fix-login-bug
     ✓ Archived update-footer
     Specs merged: add-dark-mode → update-footer

सुझाव:

  • समानांतर कार्य धाराओं के लिए अच्छा है
  • टकराव समाधान एजेंटिक है (कोडबेस जांचता है)
  • परिवर्तन निर्माण के क्रम में संग्रहित होते हैं
  • स्पेक सामग्री को ओवरराइट करने से पहले प्रॉम्प्ट करता है

/opsx:onboard

पूर्ण OpenSpec वर्कफ़्लो के माध्यम से निर्देशित ऑनबोर्डिंग। आपके वास्तविक कोडबेस का उपयोग करके एक इंटरैक्टिव ट्यूटोरियल।

सिंटैक्स:

/opsx:onboard

यह क्या करता है:

  • वर्णन के साथ एक पूर्ण वर्कफ़्लो चक्र के माध्यम से चलता है
  • वास्तविक सुधार अवसरों के लिए आपके कोडबेस को स्कैन करता है
  • वास्तविक कलाकृतियों के साथ एक वास्तविक परिवर्तन बनाता है
  • वास्तविक कार्य लागू करता है (छोटे, सुरक्षित परिवर्तन)
  • पूर्ण परिवर्तन को संग्रहित करता है
  • होने पर प्रत्येक चरण की व्याख्या करता है

चरण:

  1. स्वागत और कोडबेस विश्लेषण
  2. एक सुधार अवसर खोजना
  3. एक परिवर्तन बनाना (/opsx:new)
  4. प्रस्ताव लिखना
  5. स्पेक्स बनाना
  6. डिज़ाइन लिखना
  7. कार्य बनाना
  8. कार्य लागू करना (/opsx:apply)
  9. कार्यान्वयन सत्यापित करना
  10. परिवर्तन संग्रहित करना
  11. सारांश और अगले कदम

उदाहरण:

You: /opsx:onboard

AI:  Welcome to OpenSpec!

     I'll walk you through the complete workflow using your actual codebase.
     We'll find something small to improve, create a proper change for it,
     implement it, and archive it.

     Let me scan your codebase for opportunities...

     [Analyzes codebase]

     I found a few things we could work on:
     1. Add input validation to the contact form
     2. Improve error messages in the auth flow
     3. Add loading states to async buttons

     Which interests you? (or suggest something else)

सुझाव:

  • वर्कफ़्लो सीखने के लिए नए उपयोगकर्ताओं के लिए सर्वोत्तम
  • खिलौना उदाहरणों के बजाय वास्तविक कोड का उपयोग करता है
  • एक वास्तविक परिवर्तन बनाता है जिसे आप रख सकते हैं या छोड़ सकते हैं
  • पूरा करने में 15-30 मिनट लगते हैं

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

विभिन्न AI टूल थोड़ा अलग कमांड सिंटैक्स का उपयोग करते हैं। अपने टूल से मेल खाने वाला प्रारूप उपयोग करें:

टूलसिंटैक्स उदाहरण
Claude Code/opsx:propose, /opsx:apply
Cursor/opsx-propose, /opsx-apply
Windsurf/opsx-propose, /opsx-apply
Copilot (IDE)/opsx-propose, /opsx-apply
Traeस्किल-आधारित इनवोकेशन जैसे /openspec-propose, /openspec-apply-change (कोई जनरेटेड opsx-* कमांड फ़ाइलें नहीं)

सभी टूल में इरादा समान है, लेकिन कमांड कैसे प्रस्तुत होते हैं वह इंटीग्रेशन के अनुसार भिन्न हो सकता है।

नोट: GitHub Copilot कमांड (.github/prompts/*.prompt.md) केवल IDE एक्सटेंशन (VS Code, JetBrains, Visual Studio) में उपलब्ध हैं। GitHub Copilot CLI वर्तमान में कस्टम प्रॉम्प्ट फ़ाइलों का समर्थन नहीं करता है — विवरण और वर्कअराउंड के लिए समर्थित टूल देखें।


लेगेसी कमांड

ये कमांड पुराने "ऑल-एट-वन्स" वर्कफ़्लो का उपयोग करते हैं। ये अभी भी काम करते हैं लेकिन OPSX कमांड की सिफारिश की जाती है।

कमांडयह क्या करता है
/openspec:proposalसभी आर्टिफैक्ट्स एक साथ बनाएं (प्रपोजल, स्पेक्स, डिज़ाइन, टास्क)
/openspec:applyपरिवर्तन लागू करें
/openspec:archiveपरिवर्तन आर्काइव करें

लेगेसी कमांड कब उपयोग करें:

  • पुराने वर्कफ़्लो का उपयोग करने वाले मौजूदा प्रोजेक्ट
  • सरल परिवर्तन जहाँ आपको इंक्रीमेंटल आर्टिफैक्ट क्रिएशन की आवश्यकता नहीं है
  • ऑल-ऑर-नथिंग दृष्टिकोण के लिए प्राथमिकता

OPSX में माइग्रेट करना: लेगेसी परिवर्तनों को OPSX कमांड के साथ जारी रखा जा सकता है। आर्टिफैक्ट संरचना संगत है।


समस्या निवारण

"परिवर्तन नहीं मिला"

कमांड यह पहचान नहीं पाया कि किस परिवर्तन पर काम करना है।

समाधान:

  • परिवर्तन का नाम स्पष्ट रूप से निर्दिष्ट करें: /opsx:apply add-dark-mode
  • जांचें कि परिवर्तन फ़ोल्डर मौजूद है: openspec list
  • सत्यापित करें कि आप सही प्रोजेक्ट निर्देशिका में हैं

"कोई आर्टिफैक्ट तैयार नहीं"

सभी आर्टिफैक्ट्स या तो पूर्ण हैं या गायब निर्भरताओं से अवरुद्ध हैं।

समाधान:

  • देखने के लिए openspec status --change <name> चलाएं कि क्या अवरोध पैदा कर रहा है
  • जांचें कि आवश्यक आर्टिफैक्ट्स मौजूद हैं
  • गायब निर्भरता आर्टिफैक्ट्स पहले बनाएं

"स्कीमा नहीं मिला"

निर्दिष्ट स्कीमा मौजूद नहीं है।

समाधान:

  • उपलब्ध स्कीमा सूचीबद्ध करें: openspec schemas
  • स्कीमा नाम की वर्तनी जांचें
  • यदि कस्टम है तो स्कीमा बनाएं: openspec schema init <name>

कमांड पहचाने नहीं जा रहे

AI टूल OpenSpec कमांड को नहीं पहचानता है।

समाधान:

  • सुनिश्चित करें कि OpenSpec इनिशियलाइज़ है: openspec init
  • स्किल्स पुनः जनरेट करें: openspec update
  • जांचें कि .claude/skills/ निर्देशिका मौजूद है (Claude Code के लिए)
  • नई स्किल्स प्राप्त करने के लिए अपने AI टूल को पुनरारंभ करें

आर्टिफैक्ट्स ठीक से जनरेट नहीं हो रहे

AI अपूर्ण या गलत आर्टिफैक्ट्स बनाता है।

समाधान:

  • openspec/config.yaml में प्रोजेक्ट संदर्भ जोड़ें
  • विशिष्ट मार्गदर्शन के लिए प्रति-आर्टिफैक्ट नियम जोड़ें
  • अपने परिवर्तन विवरण में अधिक विवरण प्रदान करें
  • अधिक नियंत्रण के लिए /opsx:ff के बजाय /opsx:continue का उपयोग करें

अगले कदम

  • वर्कफ़्लो - सामान्य पैटर्न और प्रत्येक कमांड कब उपयोग करें
  • CLI - प्रबंधन और सत्यापन के लिए टर्मिनल कमांड
  • कस्टमाइज़ेशन - कस्टम स्कीमा और वर्कफ़्लो बनाएं