कमांड्स
यह 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यह क्या करता है:
- वर्णन के साथ एक पूर्ण वर्कफ़्लो चक्र के माध्यम से चलता है
- वास्तविक सुधार अवसरों के लिए आपके कोडबेस को स्कैन करता है
- वास्तविक कलाकृतियों के साथ एक वास्तविक परिवर्तन बनाता है
- वास्तविक कार्य लागू करता है (छोटे, सुरक्षित परिवर्तन)
- पूर्ण परिवर्तन को संग्रहित करता है
- होने पर प्रत्येक चरण की व्याख्या करता है
चरण:
- स्वागत और कोडबेस विश्लेषण
- एक सुधार अवसर खोजना
- एक परिवर्तन बनाना (
/opsx:new) - प्रस्ताव लिखना
- स्पेक्स बनाना
- डिज़ाइन लिखना
- कार्य बनाना
- कार्य लागू करना (
/opsx:apply) - कार्यान्वयन सत्यापित करना
- परिवर्तन संग्रहित करना
- सारांश और अगले कदम
उदाहरण:
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 - प्रबंधन और सत्यापन के लिए टर्मिनल कमांड
- कस्टमाइज़ेशन - कस्टम स्कीमा और वर्कफ़्लो बनाएं