स्पेक-फर्स्ट वर्कफ़्लो
कोड लिखने से पहले आवश्यकताओं को परिभाषित करें।
→ बहता हुआ, न कि कठोर
→ चरणबद्ध नहीं, बल्कि इटरेटिव
→ सरल, न कि जटिल
→ केवल नए प्रोजेक्ट के लिए नहीं, बल्कि पुराने प्रोजेक्ट (ब्राउनफ़ील्ड) के लिए भी बनाया गया
→ व्यक्तिगत प्रोजेक्ट से लेकर एंटरप्राइज़ तक स्केलेबलTIP
नया वर्कफ़्लो अब उपलब्ध है! हमने OpenSpec को एक नए आर्टिफ़ैक्ट-गाइडेड वर्कफ़्लो के साथ पुनर्निर्मित किया है।
शुरू करने के लिए /opsx:propose "आपका विचार" चलाएं। → यहाँ और जानें
अपडेट के लिए @0xTab को X पर फ़ॉलो करें · मदद और सवालों के लिए OpenSpec Discord से जुड़ें।
You: /opsx:propose add-dark-mode
AI: Created openspec/changes/add-dark-mode/
✓ proposal.md — why we're doing this, what's changing
✓ specs/ — requirements and scenarios
✓ design.md — technical approach
✓ tasks.md — implementation checklist
Ready for implementation!
You: /opsx:apply
AI: Implementing tasks...
✓ 1.1 Add theme context provider
✓ 1.2 Create toggle component
✓ 2.1 Add CSS variables
✓ 2.2 Wire up localStorage
All tasks complete!
You: /opsx:archive
AI: Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
Specs updated. Ready for the next feature.Node.js 20.19.0 या उससे अधिक आवश्यक है।
OpenSpec को वैश्विक रूप से इंस्टॉल करें:
npm install -g @fission-ai/openspec@latestफिर अपनी प्रोजेक्ट निर्देशिका में जाएं और इनिशियलाइज़ करें:
cd your-project
openspec initअब अपने AI को बताएं: /opsx:propose <आप क्या बनाना चाहते हैं>
यदि आप विस्तारित वर्कफ़्लो (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard) चाहते हैं, तो इसे openspec config profile से चुनें और openspec update से लागू करें।
NOTE
अनिश्चित हैं कि आपका टूल समर्थित है? पूरी सूची देखें – हम 25+ टूल्स का समर्थन करते हैं और बढ़ रहे हैं।
यह pnpm, yarn, bun, और nix के साथ भी काम करता है। इंस्टॉलेशन विकल्प देखें।
→ शुरू करना: पहले कदम
→ वर्कफ़्लो: कॉम्बो और पैटर्न
→ कमांड: स्लैश कमांड और स्किल्स
→ CLI: टर्मिनल संदर्भ
→ समर्थित टूल्स: टूल इंटीग्रेशन और इंस्टॉल पाथ
→ अवधारणाएँ: सब कैसे जुड़ता है
→ मल्टी-लैंग्वेज: बहुभाषी समर्थन
→ कस्टमाइज़ेशन: इसे अपना बनाएं
AI कोडिंग सहायक शक्तिशाली होते हैं, लेकिन जब आवश्यकताएँ केवल चैट इतिहास में रहती हैं तो वे अनिश्चित हो जाते हैं। OpenSpec एक हल्का स्पेक लेयर जोड़ता है ताकि कोई भी कोड लिखने से पहले आप इस बात पर सहमत हो सकें कि क्या बनाना है।
vs. Spec Kit (GitHub) — विस्तृत लेकिन भारी। कठोर चरण गेट, बहुत सारा Markdown, Python सेटअप। OpenSpec हल्का है और आपको स्वतंत्र रूप से इटरेट करने देता है।
vs. Kiro (AWS) — शक्तिशाली लेकिन आप उनके IDE में बंधे होते हैं और केवल Claude मॉडल तक सीमित होते हैं। OpenSpec आपके द्वारा पहले से उपयोग किए जा रहे टूल्स के साथ काम करता है।
vs. कुछ नहीं — स्पेक्स के बिना AI कोडिंग का मतलब है अस्पष्ट प्रॉम्प्ट और अनिश्चित परिणाम। OpenSpec बिना किसी औपचारिकता के पूर्वानुमेयता लाता है।
पैकेज अपग्रेड करें
npm install -g @fission-ai/openspec@latestएजेंट निर्देश रीफ्रेश करें
AI मार्गदर्शन को पुनर्जनित करने और नवीनतम स्लैश कमांड सक्रिय हैं, यह सुनिश्चित करने के लिए प्रत्येक प्रोजेक्ट के अंदर यह चलाएं:
openspec updateमॉडल चयन: OpenSpec उच्च-रीज़निंग मॉडल्स के साथ सबसे अच्छा काम करता है। हम योजना और कार्यान्वयन दोनों के लिए Opus 4.5 और GPT 5.2 की सिफारिश करते हैं।
कॉन्टेक्स्ट हाइजीन: OpenSpec को एक स्वच्छ कॉन्टेक्स्ट विंडो से लाभ होता है। कार्यान्वयन शुरू करने से पहले अपना कॉन्टेक्स्ट साफ़ करें और अपने सत्र भर में अच्छी कॉन्टेक्स्ट हाइजीन बनाए रखें।
छोटे फ़िक्स — बग फ़िक्स, टाइपो सुधार और मामूली सुधार सीधे PR के रूप में जमा किए जा सकते हैं।
बड़े बदलाव — नई सुविधाओं, महत्वपूर्ण रीफ़ैक्टरिंग या आर्किटेक्चरल बदलावों के लिए, कृपया पहले एक OpenSpec परिवर्तन प्रस्ताव जमा करें ताकि कार्यान्वयन शुरू होने से पहले हम इरादे और लक्ष्यों पर संरेखित हो सकें।
प्रस्ताव लिखते समय, OpenSpec दर्शन को ध्यान में रखें: हम विभिन्न कोडिंग एजेंट्स, मॉडल्स और उपयोग के मामलों में विविध उपयोगकर्ताओं की सेवा करते हैं। बदलाव सभी के लिए अच्छी तरह से काम करने चाहिए।
AI-जनित कोड का स्वागत है — बशर्ते इसका परीक्षण और सत्यापन किया गया हो। AI-जनित कोड वाले PR में उपयोग किए गए कोडिंग एजेंट और मॉडल का उल्लेख करना चाहिए (जैसे, "Generated with Claude Code using claude-opus-4-5-20251101")।
pnpm installpnpm run buildpnpm testpnpm run dev या pnpm run dev:clitype(scope): subjectOpenSpec गुमनाम उपयोग आँकड़े एकत्र करता है।
हम केवल उपयोग पैटर्न को समझने के लिए कमांड नाम और संस्करण एकत्र करते हैं। कोई तर्क, पाथ, सामग्री या PII नहीं। CI में स्वचालित रूप से अक्षम।
ऑप्ट-आउट: export OPENSPEC_TELEMETRY=0 या export DO_NOT_TRACK=1
प्रोजेक्ट का मार्गदर्शन करने में मदद करने वाले मुख्य मेंटेनर्स और सलाहकारों की सूची के लिए MAINTAINERS.md देखें।
MIT