Skip to content

कमांड्स ​

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

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

ये पेज /opsx:<command> को कैनोनिकल नाम के रूप में उपयोग करते हैं। कुछ टूल्स इसे अलग ढंग से लिखते हैं — Cursor और GitHub Copilot /opsx-propose पंजीकृत करते हैं, Codex $openspec-propose उपयोग करता है — इसलिए अपने टूल के लिए How To Invoke देखें। OpenSpec द्वारा जनरेट किए गए फ़ाइलें पहले से ही सही रूप का उपयोग करती हैं।

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

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

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

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

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

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


Command Reference ​

/opsx:propose ​

एक नया परिवर्तन बनाएं और एक ही चरण में प्लानिंग आर्टिफैक्ट्स जनरेट करें। यह core प्रोफ़ाइल में डिफ़ॉल्ट स्टार्ट कमांड है।

Syntax:

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

Arguments:

ArgumentRequiredDescription
change-name-or-descriptionNoKebab-case नाम या साधारण भाषा में परिवर्तन का विवरण

What it does:

  • openspec/changes/<change-name>/ बनाता है
  • implementation से पहले आवश्यक आर्टिफैक्ट्स जनरेट करता है (spec-driven के लिए: proposal, specs, design, tasks)
  • तब रुकता है जब परिवर्तन /opsx:apply के लिए तैयार हो

Example:

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.

Tips:

  • सबसे तेज़ end-to-end path के लिए इसका उपयोग करें
  • यदि आप step-by-step आर्टिफैक्ट नियंत्रण चाहते हैं, तो expanded workflows सक्षम करें और /opsx:new + /opsx:continue का उपयोग करें

/opsx:explore ​

जब आप अनिश्चित हों तो यहाँ से शुरू करें। Explore एक no-stakes सोचने का साथी है: यह आपका codebase पढ़ता है, विकल्पों की तुलना करता है, और किसी भी परिवर्तन के अस्तित्व में आने से पहले एक धुंधला विचार को एक ठोस योजना में परिष्कृत करता है। यह डिफ़ॉल्ट प्रोफ़ाइल में उपलब्ध है। पूर्ण case और अधिक उदाहरणों के लिए, Explore First गाइड देखें।

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

Syntax:

/opsx:explore [topic]

Arguments:

ArgumentRequiredDescription
topicNoआप क्या explore या investigate करना चाहते हैं

What it does:

  • कोई संरचना आवश्यक नहीं रखते हुए एक exploratory संवाद खोलता है
  • प्रश्नों के उत्तर देने के लिए codebase की जांच करता है
  • विकल्पों और दृष्टिकोणों की तुलना करता है
  • सोच को स्पष्ट करने के लिए visual diagrams बनाता है
  • जब insights crystallize होते हैं तो /opsx:propose (default) या /opsx:new (expanded workflow) में transition कर सकता है

Example:

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.

Tips:

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

/opsx:new ​

एक नया परिवर्तन scaffold शुरू करें। परिवर्तन फ़ोल्डर बनाता है और /opsx:continue या /opsx:ff के साथ आर्टिफैक्ट्स जनरेट करने के लिए आपका इंतज़ार करता है।

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

Syntax:

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

Arguments:

ArgumentRequiredDescription
change-nameNoपरिवर्तन फ़ोल्डर का नाम (यदि प्रदान न किया जाए तो prompt किया जाएगा)
--schemaNoउपयोग करने के लिए workflow schema (default: config से या spec-driven)

What it does:

  • openspec/changes/<change-name>/ directory बनाता है
  • परिवर्तन फ़ोल्डर में .openspec.yaml metadata फ़ाइल बनाता है
  • निर्माण के लिए तैयार पहला आर्टिफैक्ट template दिखाता है
  • यदि प्रदान न किया जाए तो परिवर्तन नाम और schema के लिए prompt करता है

What it creates:

openspec/changes/<change-name>/
└── .openspec.yaml    # Change metadata (schema, created date)

Example:

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.

Tips:

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

/opsx:continue ​

Dependency chain में अगला आर्टिफैक्ट बनाएं。 एक समय पर एक आर्टिफैक्ट बनाता है incremental progress के लिए।

Syntax:

/opsx:continue [change-name]

Arguments:

ArgumentRequiredDescription
change-nameNoकौन सा परिवर्तन जारी रखना है (यदि प्रदान न किया जाए तो context से inferred किया जाएगा)

What it does:

  • Artifact dependency graph से query करता है
  • दिखाता है कि कौन से आर्टिफैक्ट्स ready हैं और कौन से blocked हैं
  • पहला ready आर्टिफैक्ट बनाता है
  • context के लिए dependency फ़ाइलें पढ़ता है
  • निर्माण के बाद क्या available होगा यह दिखाता है

Example:

You: /opsx:continue

AI:  Change: add-dark-mode

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

     Creating specs...

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

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

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

Tips:

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

/opsx:ff ​

आर्टिफैक्ट निर्माण के माध्यम से fast-forward करें। सभी प्लानिंग आर्टिफैक्ट्स एक साथ बनाता है।

Syntax:

/opsx:ff [change-name]

Arguments:

ArgumentRequiredDescription
change-nameNoकौन सा परिवर्तन fast-forward करना है (यदि प्रदान न किया जाए तो context से inferred किया जाएगा)

What it does:

  • सभी आर्टिफैक्ट्स dependency order में बनाता है
  • Todo list के माध्यम से प्रगति ट्रैक करता है
  • तब रुकता है जब सभी apply-required आर्टिफैक्ट्स पूर्ण हो जाते हैं
  • अगला आर्टिफैक्ट बनाने से पहले प्रत्येक dependency पढ़ता है

Example:

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.

Tips:

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

/opsx:apply ​

परिवर्तन से tasks implement करें। Task list के माध्यम से काम करता है, code लिखता है और items पर टिक लगाता है।

Syntax:

/opsx:apply [change-name]

Arguments:

ArgumentRequiredDescription
change-nameNoकौन सा परिवर्तन implement करना है (यदि प्रदान न किया जाए तो context से inferred किया जाएगा)

What it does:

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

Example:

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
     ...

Tips:

  • यदि बीच में रुकावट हुई तो जहाँ आप छोड़ गए थे वहाँ से resume कर सकता है
  • Change name निर्दिष्ट करके parallel changes के लिए उपयोग करें
  • पूर्णता की स्थिति tasks.md checkboxes में ट्रैक की जाती है

/opsx:update ​

परिवर्तन के मौजूदा प्लानिंग आर्टिफैक्ट्स में संशोधन करें और उन्हें एक-दूसरे के साथ सुसंगत रखें। केवल प्लानिंग आर्टिफैक्ट्स - यह कभी code में संपादन नहीं करता।

Syntax:

text
/opsx:update [change-name]

Arguments:

ArgumentRequiredDescription
change-nameNoकौन सा परिवर्तन अपडेट करना है (यदि प्रदान न किया जाए तो context से inferred किया जाएगा)

What it does:

  • openspec status --change <name> --json के माध्यम से परिवर्तन के आर्टिफैक्ट्स पढ़ता है
  • आपकी अनुरोधित संशोधन लागू करता है, या यदि आपने कोई नाम नहीं दिया तो आर्टिफैक्ट्स में विरोधाभासों की समीक्षा करता है
  • किसी भी दिशा में अन्य मौजूदा आर्टिफैक्ट्स को समायोजित करता है (एक design edit proposal में वापस ripple कर सकता है)
  • लिखने से पहले प्रत्येक संपादन आपसे एक-एक करके आर्टिफैक्ट पर पुष्टि करता है
  • अगला चरण सुझाव देकर समाप्त होता है: /opsx:continue (आर्टiफैक्ट्स अनुपस्थित), /opsx:apply (संशोधित योजना को code में ले जाएं), या /opsx:archive (सब कुछ पूर्ण)

Example:

text
You: /opsx:update add-dark-mode - we're storing the theme in a cookie now, not localStorage

AI:  Reading add-dark-mode artifacts...

     The design references localStorage in two places; tasks 1.3 covers
     localStorage persistence; the proposal doesn't mention storage.

     Proposed revisions:
     1. design.md - swap localStorage decision for cookie storage
     2. tasks.md - reword task 1.3 to cookie persistence

     Apply revision 1? (design.md)

Tips:

  • यह अनुपस्थित आर्टिफैक्ट्स नहीं बनाएगा - वह /opsx:continue है
  • यदि परिवर्तन पहले से implement हो चुका है, तो /opsx:apply के साथ follow-up करें ताकि code संशोधित योजना से मेल खाए
  • यदि आपकी संशोधन परिवर्तन का intent बदलती है, तो नए परिवर्तन से नई शुरुआत करें (देखें When to Update vs. Start Fresh)

/opsx:verify ​

पुष्टि करें कि implementation आपके परिवर्तन आर्टिफैक्ट्स से मेल खाता है। Completeness, correctness और coherence की जांच करता है।

Syntax:

/opsx:verify [change-name]

Arguments:

ArgumentRequiredDescription
change-nameNoकौन सा परिवर्तन verify करना है (यदि प्रदान न किया जाए तो context से inferred किया जाएगा)

What it does:

  • Implementation quality के तीन आयामों की जांच करता है
  • Implementation evidence के लिए codebase में खोज करता है
  • CRITICAL, WARNING या SUGGESTION के रूप में वर्गीकृत issues रिपोर्ट करता है
  • Archive को block नहीं करता, लेकिन issues सतह पर लाता है

Verification dimensions:

DimensionWhat it validates
Completenessसभी tasks पूर्ण, सभी requirements implement किए गए, scenarios covered
CorrectnessImplementation spec intent से मेल खाता है, edge cases handled
CoherenceDesign decisions code में reflected, patterns consistent

Example:

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

Tips:

  • Archive करने से पहले चलाएं ताकि mismatches को जल्दी पकड़ा जा सके
  • Warnings archive को block नहीं करते लेकिन संभावित issues संकेत देते हैं
  • Commit करने से पहले AI के काम की समीक्षा के लिए उपयुक्त है
  • आर्टिफैक्ट्स और implementation के बीच drift को प्रकट कर सकता है

/opsx:sync ​

Optional command. परिवर्तन से delta specs को main specs में merge करें। Archive आवश्यक होने पर sync के लिए prompt करेगा, इसलिए आपको आमतौर पर इसे manually चलाने की आवश्यकता नहीं होती।

Syntax:

/opsx:sync [change-name]

Arguments:

ArgumentRequiredDescription
change-nameNoकौन सा परिवर्तन sync करना है (यदि प्रदान न किया जाए तो context से inferred किया जाएगा)

What it does:

  • परिवर्तन फ़ोल्डर से delta specs पढ़ता है
  • ADDED/MODIFIED/REMOVED/RENAMED sections parse करता है
  • परिवर्तनों को main openspec/specs/ directory में merge करता है
  • Delta में उल्लेखित न होने वाले मौजूदा content को संरक्षित रखता है
  • परिवर्तन को archive नहीं करता (active रहता है)

Example:

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.

When to use manually:

ScenarioUse sync?
Long-running change, want specs in main before archivingYes
Multiple parallel changes need the updated base specsYes
Want to preview/review the merge separatelyYes
Quick change, going straight to archiveNo (archive handles it)

Tips:

  • Sync intelligent है, copy-paste नहीं
  • मौजूदा requirements में scenarios जोड़ सकता है बिना duplication के
  • Sync के बाद परिवर्तन active रहता है (archive नहीं होता)
  • अधिकांश उपयोगकर्ताओं को कभी इसे directly call करने की आवश्यकता नहीं होगी—archive आवश्यक होने पर prompt करेगा

/opsx:archive ​

पूर्ण परिवर्तन को archive करें। परिवर्तन को finalizes करता है और इसे archive फ़ोल्डर में ले जाता है。

Syntax:

/opsx:archive [change-name]

Arguments:

ArgumentRequiredDescription
change-nameNoकौन सा परिवर्तन archive करना है (यदि प्रदान न किया जाए तो context से inferred किया जाएगा)

What it does:

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

Example:

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.

Tips:

  • Archive अधूरे tasks पर block नहीं होगा, लेकिन warning देगा
  • Delta specs को archive के दौरान या पहले sync किया जा सकता है
  • Archived परिवर्तन इतिहास के लिए संरक्षित रहते हैं
  • पहले /opsx:verify का उपयोग करें ताकि issues पकड़े जा सकें

/opsx:bulk-archive ​

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

Syntax:

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

Arguments:

ArgumentRequiredDescription
change-namesNoविशिष्ट परिवर्तन जिन्हें archive करना है (यदि प्रदान न किया जाए तो select करने के लिए prompt किया जाएगा)

What it does:

  • सभी पूर्ण परिवर्तन सूचीबद्ध करता है
  • Archive करने से पहले प्रत्येक परिवर्तन को validate करता है
  • परिवर्तनों के बीच spec conflicts की पहचान करता है
  • वास्तव में क्या implement हुआ है यह जांच करके conflicts resolve करता है
  • Chronological order में archive करता है

Example:

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

Tips:

  • Parallel work streams के लिए उपयुक्त है
  • Conflict resolution agentic है (codebase जांचता है)
  • परिवर्तन creation के क्रम में archive होते हैं
  • Spec content को overwrite करने से पहले prompt करता है

/opsx:onboard ​

पूर्ण OpenSpec workflow के माध्यम से guided onboarding। आपके actual codebase का उपयोग करते हुए एक interactive tutorial।

Syntax:

/opsx:onboard

What it does:

  • Narration के साथ एक पूर्ण workflow cycle के माध्यम से ले जाता है
  • वास्तविक improvement opportunities के लिए आपके codebase का scan करता है
  • वास्तविक आर्टिफैक्ट्स के साथ एक actual परिवर्तन बनाता है
  • वास्तविक काम implement करता है (छोटे, सुरक्षित परिवर्तन)
  • पूर्ण परिवर्तन को archive करता है
  • हर चरण को होने के समय समझाता है

Phases:

  1. Welcome और codebase analysis
  2. Improvement opportunity खोजना
  3. परिवर्तन बनाना (/opsx:new)
  4. Proposal लिखना
  5. Specs बनाना
  6. Design लिखना
  7. Tasks बनाना
  8. Tasks implement करना (/opsx:apply)
  9. Implementation verify करना
  10. परिवर्तन को archive करना
  11. Summary और अगले चरण

Example:

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)

Tips:

  • नए उपयोगकर्ताओं के लिए जो workflow सीख रहे हैं, उनके लिए सर्वोत्तम है
  • वास्तविक code का उपयोग करता है, toy examples नहीं
  • एक वास्तविक परिवर्तन बनाता है जिसे आप रख सकते हैं या त्याग सकते हैं
  • पूर्ण होने में 15-30 मिनट लगते हैं

एआई टूल द्वारा कमांड सिंटैक्स ​

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

आपके टूल की कमांड फ़ाइलसिंटैक्स उदाहरणउदाहरण टूल
.../commands/opsx/<id>.*/opsx:propose, /opsx:applyClaude Code, Gemini CLI, Crush
.../opsx-<id>.*/opsx-propose, /opsx-applyCursor, Devin Desktop, Copilot (IDE), Trae, Oh My Pi
कोई नहीं — केवल स्किल्स/openspec-propose, /openspec-apply-changeCodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, shared .agents
कोई नहीं — Kimi Code/skill:openspec-proposeKimi Code
कोई नहीं — Codex CLI$openspec-proposeCodex

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

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

ध्यान दें: 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 - प्रबंधन और सत्यापन के लिए टर्मिनल कमांड
  • अनुकूलन - कस्टम स्कीमा और वर्कफ़्लो बनाएं