कमांड्स
यह OpenSpec के स्लैश कमांड्स का संदर्भ है। ये कमांड्स आपके AI कोडिंग असिस्टेंट के चैट इंटरफेस (जैसे, Claude Code, Cursor, Windsurf) में इनवोक किए जाते हैं।
वर्कफ़्लो पैटर्न और प्रत्येक कमांड का उपयोग कब करें, इसके लिए वर्कफ़्लोज़ देखें। CLI कमांड्स के लिए, CLI देखें।
त्वरित संदर्भ
डिफ़ॉल्ट त्वरित पथ (core प्रोफ़ाइल)
| कमांड | उद्देश्य |
|---|---|
/opsx:propose | एक परिवर्तन बनाएं और एक ही चरण में योजना आर्टिफैक्ट्स उत्पन्न करें |
/opsx:explore | किसी परिवर्तन को करने से पहले विचारों पर विचार करें |
/opsx:apply | परिवर्तन से कार्यों को लागू करें |
/opsx:sync | डेल्टा स्पेक्स को मुख्य स्पेक्स में मर्ज करें |
/opsx:archive | एक पूर्ण परिवर्तन को संग्रहित करें |
विस्तृत वर्कफ़्लो कमांड्स (कस्टम वर्कफ़्लो चयन)
| कमांड | उद्देश्य |
|---|---|
/opsx:new | एक नया परिवर्तन स्कैफ़ोल्ड शुरू करें |
/opsx:continue | निर्भरताओं के आधार पर अगला आर्टिफैक्ट बनाएं |
/opsx:ff | फ़ास्ट-फ़ॉरवर्ड: सभी योजना आर्टिफैक्ट्स एक साथ बनाएं |
/opsx:verify | सत्यापित करें कि कार्यान्वयन आर्टिफैक्ट्स से मेल खाता है |
/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
आप: /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
आप: /opsx:explore
AI: What would you like to explore?
आप: 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?
आप: 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 # परिवर्तन मेटाडेटा (स्कीमा, बनाने की तिथि)उदाहरण:
आप: /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 | नहीं | किस परिवर्तन को जारी रखना है (यदि प्रदान नहीं किया गया है तो संदर्भ से अनुमान लगाया जाता है) |
यह क्या करता है:
- आर्टिफैक्ट निर्भरता ग्राफ़ क्वेरी करता है
- दिखाता है कि कौन से आर्टिफैक्ट तैयार हैं बनाम अवरुद्ध हैं
- पहला तैयार आर्टिफैक्ट बनाता है
- संदर्भ के लिए निर्भरता फ़ाइलें पढ़ता है
- दिखाता है कि बनाने के बाद क्या उपलब्ध होता है
उदाहरण:
आप: /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आर्टिफैक्ट पूरे हो जाते हैं तो रुक जाता है - अगला आर्टिफैक्ट बनाने से पहले प्रत्येक निर्भरता पढ़ता है
उदाहरण:
आप: /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]के साथ कार्यों को पूर्ण चिह्नित करता है
उदाहरण:
आप: /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 के रूप में वर्गीकृत समस्याओं की रिपोर्ट करता है
- संग्रह को अवरुद्ध नहीं करता है, लेकिन समस्याओं को सामने लाता है
सत्यापन आयाम:
| आयाम | यह क्या सत्यापित करता है |
|---|---|
| पूर्णता | सभी कार्य पूरे हुए, सभी आवश्यकताएं लागू हुईं, परिदृश्य कवर किए गए |
| शुद्धता | कार्यान्वयन स्पेक इरादे से मेल खाता है, एज केस हैंडल किए गए |
| सुसंगतता | डिज़ाइन निर्णय कोड में प्रतिबिंबित होते हैं, पैटर्न सुसंगत हैं |
उदाहरण:
आप: /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
आप: /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.मैन्युअल रूप से कब उपयोग करें:
| परिदृश्य | सिंक का उपयोग करें? |
|---|---|
| लंबे समय तक चलने वाला परिवर्तन, संग्रह से पहले मुख्य में स्पेक्स चाहते हैं | हां |
| कई समानांतर परिवर्तनों को अपडेटेड बेस स्पेक्स की आवश्यकता है | हां |
| मर्ज को अलग से पूर्वावलोकन/समीक्षा करना चाहते हैं | हां |
| त्वरित परिवर्तन, सीधे संग्रह पर जा रहे हैं | नहीं (संग्रह इसे हैंडल करता है) |
सुझाव:
- सिंक बुद्धिमान है, कॉपी-पेस्ट नहीं
- डुप्लिकेट किए बिना मौजूदा आवश्यकताओं में परिदृश्य जोड़ सकता है
- सिंक के बाद परिवर्तन सक्रिय रहता है (संग्रहीत नहीं)
- अधिकांश उपयोगकर्ताओं को इसे सीधे कॉल करने की कभी आवश्यकता नहीं होगी—यदि आवश्यक हो तो संग्रह प्रॉम्प्ट करता है
/opsx:archive
एक पूर्ण परिवर्तन को संग्रहीत करें। परिवर्तन को अंतिम रूप देता है और इसे संग्रह फ़ोल्डर में ले जाता है।
सिंटैक्स:
/opsx:archive [change-name]आर्ग्युमेंट्स:
| आर्ग्युमेंट | आवश्यक | विवरण |
|---|---|---|
change-name | नहीं | किस परिवर्तन को संग्रहीत करना है (यदि प्रदान नहीं किया गया है तो संदर्भ से अनुमान लगाया जाता है) |
यह क्या करता है:
- आर्टिफैक्ट पूर्णता स्थिति की जांच करता है
- कार्य पूर्णता की जांच करता है (यदि अपूर्ण हो तो चेतावनी देता है)
- यदि अभी तक सिंक नहीं किया गया है तो डेल्टा स्पेक्स को सिंक करने की पेशकश करता है
- परिवर्तन फ़ोल्डर को
openspec/changes/archive/YYYY-MM-DD-<name>/में ले जाता है - ऑडिट ट्रेल के लिए सभी आर्टिफैक्ट को संरक्षित करता है
उदाहरण:
text
आप: /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)
आप: 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 | नहीं | संग्रहीत करने के लिए विशिष्ट परिवर्तन (यदि प्रदान नहीं किया गया है तो चयन करने के लिए प्रॉम्प्ट करता है) |
यह क्या करता है:
- सभी पूर्ण परिवर्तनों को सूचीबद्ध करता है
- संग्रहीत करने से पहले प्रत्येक परिवर्तन को सत्यापित करता है
- परिवर्तनों में स्पेक संघर्षों का पता लगाता है
- वास्तव में क्या लागू किया गया है यह जांचकर संघर्षों को हल करता है
- कालानुक्रमिक क्रम में संग्रहीत करता है
उदाहरण:
आप: /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?
आप: 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यह क्या करता है:
- वर्णन के साथ एक पूर्ण वर्कफ़्लो चक्र के माध्यम से चलता है
- वास्तविक सुधार के अवसरों के लिए आपके कोडबेस को स्कैन करता है
- वास्तविक आर्टिफैक्ट के साथ एक वास्तविक परिवर्तन बनाता है
- वास्तविक कार्य लागू करता है (छोटे, सुरक्षित परिवर्तन)
- पूर्ण परिवर्तन को संग्रहीत करता है
- जैसे-जैसे होता है प्रत्येक चरण की व्याख्या करता है
चरण:
- स्वागत और कोडबेस विश्लेषण
- सुधार का अवसर ढूंढना
- एक परिवर्तन बनाना (
/opsx:new) - प्रस्ताव लिखना
- स्पेक्स बनाना
- डिज़ाइन लिखना
- कार्य बनाना
- कार्य लागू करना (
/opsx:apply) - कार्यान्वयन सत्यापित करना
- परिवर्तन संग्रहीत करना
- सारांश और अगले चरण
उदाहरण:
आप: /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 |
| Kimi CLI | स्किल-आधारित इनवोकेशन जैसे /skill:openspec-propose, /skill:openspec-apply-change (कोई जनरेटेड opsx-* कमांड फ़ाइलें नहीं) |
| 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 - प्रबंधन और सत्यापन के लिए टर्मिनल कमांड
- कस्टमाइज़ेशन - कस्टम स्कीमा और वर्कफ़्लो बनाएं